{
"id": "1303",
"event": "TRANSFER_NOTIFICATION",
"created_at": "2026-10-28T09:00:00Z",
"data": {
"businessCode": "BUS001",
"reference": "TRF-example-001",
"type": "FundTransfer",
"service": "FUNDTRANSFER",
"direction": "DEBIT",
"status": "Successful",
"requestState": "Completed",
"currency": "NGN",
"trxAmount": 5000,
"trxFee": 25,
"isReversed": false
},
"livemode": true,
"signature": null
}{
"received": true
}Transfer notification
Numero POSTs this event to your subscription URL. The request below is the notification payload received by your server; the response is your server’s acknowledgement, not a Numero API response. Verify X-Numero-Signature using HMAC-SHA256 of ”.” with your signing secret. FUNDING_NOTIFICATION and PAYOUT_NOTIFICATION use the same envelope and transaction data shape.
{
"id": "1303",
"event": "TRANSFER_NOTIFICATION",
"created_at": "2026-10-28T09:00:00Z",
"data": {
"businessCode": "BUS001",
"reference": "TRF-example-001",
"type": "FundTransfer",
"service": "FUNDTRANSFER",
"direction": "DEBIT",
"status": "Successful",
"requestState": "Completed",
"currency": "NGN",
"trxAmount": 5000,
"trxFee": 25,
"isReversed": false
},
"livemode": true,
"signature": null
}{
"received": true
}Authorizations
Your business API key (live_key_...). Issued on business approval.
Body
Persisted notification ID; stable across retries.
The data of a FUNDING_NOTIFICATION (money in) or TRANSFER_NOTIFICATION (money out).
Field names are camelCase; amounts are in naira (major units).
Show child attributes
Show child attributes
False for Test subscriptions; true for Live.
Legacy nullable field. Verify the X-Numero-Signature header, never this field.
Response
Your receiver accepted the event. This JSON body is optional; Numero only checks the 2xx status.