Reversal events

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.

EventSent whenReversal status
reversal_createdA reversal is created and your wallet is debitedpending
reversal_processedThe money has been returned to the customercompleted
reversal_declinedThe reversal is declined and the money returned to your walletfailed

Payload

FieldTypeDescription
event.typeStringreversal_created, reversal_processed or reversal_declined
dataObjectThe 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"
  }
}