Bills purchase notification

{
  "businessCode": "<string>",
  "reference": "<string>",
  "amount": 123,
  "customerIdentifier": "<string>",
  "message": "<string>"
}

WEBHOOK

billsPurchase

{
  "businessCode": "<string>",
  "reference": "<string>",
  "amount": 123,
  "customerIdentifier": "<string>",
  "message": "<string>"
}

Authorizations

X-Numero-Api-Key

string

header

required

Your business API key (live_key_...). Issued on approval; managed in Dashboard → Settings → Developer.

Body

application/json

businessCode

string

vertical

enum<string>

Available options:

AIRTIME,

DATA,

ELECTRICITY,

CABLETV,

BETTING

reference

string

status

enum<string>

Available options:

Successful,

Failed

amount

number

customerIdentifier

string

phone | meter | smartcard | betting customer id.

message

string | null

Response

200

Acknowledge receipt with 2xx.

Utilities

Balance

Cards

Cardholders

Transfers

Virtual Accounts

Airtime

Data

Electricity

Cable TV

Betting

Verification

Credit

Customers

Invoices

Sandbox

Customer Wallets

API Reference

Bills purchase notification

Authorizations

Body

Response