{
"id": "1301",
"event": "BILLS_PURCHASE_NOTIFICATION",
"created_at": "2026-10-28T09:00:00Z",
"data": {
"businessCode": "BUS001",
"vertical": "AIRTIME",
"reference": "BILL-example-001",
"status": "Successful",
"amount": 1000,
"currency": "NGN",
"customerIdentifier": "08012345678",
"message": "Purchase successful"
},
"livemode": true,
"signature": null
}{
"received": true
}API Reference
Bills purchase 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.
WEBHOOK
billsPurchase
{
"id": "1301",
"event": "BILLS_PURCHASE_NOTIFICATION",
"created_at": "2026-10-28T09:00:00Z",
"data": {
"businessCode": "BUS001",
"vertical": "AIRTIME",
"reference": "BILL-example-001",
"status": "Successful",
"amount": 1000,
"currency": "NGN",
"customerIdentifier": "08012345678",
"message": "Purchase successful"
},
"livemode": true,
"signature": null
}{
"received": true
}Authorizations
Body
application/json