Vendy sends these events as a reversal moves through its life. To receive them, create a webhook subscribed to the reversal events, or to all.
| Event | Sent when | Reversal status |
|---|---|---|
reversal_created | A reversal is created and your wallet is debited | pending |
reversal_processed | The money has been returned to the customer | completed |
reversal_declined | The reversal is declined and the money returned to your wallet | failed |
Payload
| Field | Type | Description |
|---|---|---|
event.type | String | reversal_created, reversal_processed or reversal_declined |
data | Object | The reversal. data.refid identifies the reversal and data.tranRef the payment. See Get Reversals for every field |
The request has an x-signature header. See Validating Webhook Signatures. Respond with 200 or 204, and handle events by refid and status, not by arrival order.
reversal_created
{
"event.type": "reversal_created",
"data": {
"id": 512,
"uid": 7,
"refid": "48213907561",
"businessId": 6,
"walletId": 39,
"commissionWallet": 40,
"transactionId": 90817,
"tranRef": "2795167047787452481",
"amount": 15000,
"currency": "NGN",
"status": "pending",
"meta": {
"customer_reason": "Customer was charged twice for the same order",
"total": 15000,
"fee": 225,
"commission": 0,
"charge_customer": false,
"fee_structure": {
"fee": 1.5,
"percent": true,
"threshold": {
"min": 0,
"max": 2000
},
"commission": 0,
"charge_customer": false
}
},
"reason": "Duplicate payment for order ORD-1043",
"provider": null,
"providerId": null,
"createdAt": "2026-11-17T10:42:18.000Z",
"updatedAt": "2026-11-17T10:42:18.000Z"
}
}reversal_processed
{
"event.type": "reversal_processed",
"data": {
"id": 512,
"uid": 7,
"refid": "48213907561",
"businessId": 6,
"walletId": 39,
"commissionWallet": 40,
"transactionId": 90817,
"tranRef": "2795167047787452481",
"amount": 15000,
"currency": "NGN",
"status": "completed",
"meta": {
"customer_reason": "Customer was charged twice for the same order",
"total": 15000,
"fee": 225,
"commission": 0,
"charge_customer": false,
"fee_structure": {
"fee": 1.5,
"percent": true,
"threshold": {
"min": 0,
"max": 2000
},
"commission": 0,
"charge_customer": false
}
},
"reason": "Duplicate payment for order ORD-1043",
"provider": "card",
"providerId": "VND-RFD-1029384756",
"createdAt": "2026-11-17T10:42:18.000Z",
"updatedAt": "2026-11-26T14:05:51.000Z"
}
}reversal_declined
The reason is in meta.admin_reason.
{
"event.type": "reversal_declined",
"data": {
"id": 512,
"uid": 7,
"refid": "48213907561",
"businessId": 6,
"walletId": 39,
"commissionWallet": 40,
"transactionId": 90817,
"tranRef": "2795167047787452481",
"amount": 15000,
"currency": "NGN",
"status": "failed",
"meta": {
"customer_reason": "Customer was charged twice for the same order",
"total": 15000,
"fee": 225,
"commission": 0,
"charge_customer": false,
"fee_structure": {
"fee": 1.5,
"percent": true,
"threshold": {
"min": 0,
"max": 2000
},
"commission": 0,
"charge_customer": false
},
"admin_reason": "Payment was already refunded to the customer"
},
"reason": "Duplicate payment for order ORD-1043",
"provider": null,
"providerId": null,
"createdAt": "2026-11-17T10:42:18.000Z",
"updatedAt": "2026-11-24T09:31:07.000Z"
}
}