Skip to main content
POST
Buy airtime

Authorizations

Authorization
string
header
required

See Authentication for the full explanation of session tokens vs. API keys and when each is used.

Headers

Idempotency-Key
string
required

Required on purchase endpoints. Use a new key for each intended purchase, and reuse that same key when retrying the same request after a timeout. A completed key replays the original response. The same key with a different body is rejected. Keys expire after 24 hours. A missing key returns 400 with no error_code.

Maximum string length: 255

Body

application/json
phone
string
required

Nigerian format — 0 followed by 10 digits.

Pattern: ^0\d{10}$
amount
number
required
Required range: 50 <= x <= 500000
network
enum<string>
required
Available options:
mtn,
glo,
airtel,
9mobile
customer_reference
string | null
Maximum string length: 100

Response

Purchased