Send transfer reversal webhook

WEBHOOK transfer.reversal

Example

{
  "webhook_id": "<string>",
  "timestamp": 123,
  "type": "charge.completed",
  "data": {
    "id": "<string>",
    "source_currency": "NGN",
    "destination_currency": "EUR",
    "amount": 3000.44,
    "reference": "<string>",
    "proof": "<string>",
    "status": "FAILED",
    "disburse_datetime": "2023-11-07T05:31:56Z",
    "bank": {
      "account_number": "0690000031",
      "code": "044",
      "branch": "1812051EPC",
      "name": "Commonwealth Bank of Australia",
      "routing_number": "110000",
      "swift_code": "CTBAAU2S"
    },
    "mobile_money": {
      "network": "<string>",
      "country": "MTN",
      "msisdn": "251911234567"
    },
    "wallet": {
      "provider": "flutterwave",
      "identifier": "00118468"
    },
    "cash_pickup": {
      "network": "<string>"
    },
    "fee": {
      "currency": "NGN",
      "value": 10.35
    },
    "debit_information": {
      "currency": "NGN",
      "actual_debit_amount": 100.35,
      "rate_used": 100.35,
      "vat": 100.35
    },
    "payment_information": {
      "proof": "11000224070317345400001414441712312381"
    },
    "provider_response": {
      "type": "transfer_amount_exceeds_limit",
      "code": "<string>",
      "message": "DISBURSE FAILED: Insufficient wallet balance"
    },
    "meta": {},
    "reversal": {
      "reversal_datetime": "2023-11-07T05:31:56Z",
      "initial_status": "SUCCESSFUL",
      "reconciliation_status": "REVERSED",
      "reconciliation_type": "D"
    }
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Notification about a transfer reversal

Transfer Reversal webhook payload

webhook_id · string · required

Webhook event identifier

timestamp · integer<int64> · required

Webhook event timestamp

type · enum<string> · required

Webhook event type

Available options: charge.completed, transfer.disburse, transfer.reversal, order.authorization

data · object · required

Show child attributes

Response

200

Return a 200 status to indicate that the webhook was received successfully