{
"id": "1302",
"event": "DIGITAL_PURCHASE_NOTIFICATION",
"created_at": "2026-10-28T09:00:00Z",
"data": {
"businessCode": "BUS001",
"vertical": "GLOBALAIRTIME",
"reference": "DIGITAL-example-001",
"status": "Successful",
"amount": 2.5,
"currency": "USD",
"customerIdentifier": "+12025550123",
"message": "Purchase successful"
},
"livemode": true,
"signature": null
}{
"received": true
}Digital 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. Subscribe to DIGITAL or this exact event for global airtime, data, gift cards and utilities. Existing Bills subscriptions retain BILLS_PURCHASE_NOTIFICATION until explicitly opting into Digital. No gift-card codes or delivery credentials are included; fetch them through the authenticated delivery endpoint.
{
"id": "1302",
"event": "DIGITAL_PURCHASE_NOTIFICATION",
"created_at": "2026-10-28T09:00:00Z",
"data": {
"businessCode": "BUS001",
"vertical": "GLOBALAIRTIME",
"reference": "DIGITAL-example-001",
"status": "Successful",
"amount": 2.5,
"currency": "USD",
"customerIdentifier": "+12025550123",
"message": "Purchase successful"
},
"livemode": true,
"signature": null
}{
"received": true
}Authorizations
Your business API key (live_key_...). Issued on business approval.
Body
Persisted notification ID; stable across retries.
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.