{
"event": "transfer.failed",
"data": {
"id": "64b2c1234567890",
"reference": "txn_123456",
"amount": 1000,
"fee": 50,
"currency": "NGN",
"type": "transfer",
"status": "failed",
"reason": "Beneficiary bank unavailable",
"narration": "Payment for services",
"accountDetails": {
"accountNumber": 123456789,
"accountName": "JOHN DOE",
"bankName": "Access Bank"
},
"createdAt": "2026-07-10T12:00:00.000Z",
"updatedAt": "2026-07-10T12:03:00.000Z"
}
}Webhooks
Transfer failed
Sent when the transfer cannot be completed. Debited funds are returned to your balance. Delivered as a POST to your webhook URL; return a 2xx to acknowledge.
WEBHOOK
transfer.failed
{
"event": "transfer.failed",
"data": {
"id": "64b2c1234567890",
"reference": "txn_123456",
"amount": 1000,
"fee": 50,
"currency": "NGN",
"type": "transfer",
"status": "failed",
"reason": "Beneficiary bank unavailable",
"narration": "Payment for services",
"accountDetails": {
"accountNumber": 123456789,
"accountName": "JOHN DOE",
"bankName": "Access Bank"
},
"createdAt": "2026-07-10T12:00:00.000Z",
"updatedAt": "2026-07-10T12:03:00.000Z"
}
}Authorizations
Your Business API Key
Headers
Hex HMAC-SHA512 of the raw request body, keyed with your webhook secret. Verify it before trusting the payload.
Body
application/json
Response
200
Return any 2xx once the event is stored.