Webhook V2 is the recommended webhook format. It uses a unified envelope where all events share the same { event, timestamp, data } structure, making it easier to parse and handle webhooks consistently.
What's Included
V2 webhooks cover 5 event types:
| Event | Description |
|---|---|
payment.v2.completed |
Payment successfully completed |
disbursement.v2.completed |
Disbursement successfully completed |
disbursement.v2.fail |
Disbursement failed |
disbursement.v2.expired |
Disbursement expired |
transaction_settlement.settled |
Settlement finalised |
See Webhook V2 documentation for full details.
V2 vs V1 Webhooks
V1 and V2 webhooks can run in parallel — you can subscribe to both simultaneously during migration. New integrations should use V2 webhooks only.
See the V1 → V2 Migration Guide for details.