Skip to main content
POST
Buy airtime

Authorizations

Authorization
string
header
required

Paste your secret key as the bearer token: sk_test_… (test) or sk_live_… (live). That is all a normal API call needs. OAuth access tokens from POST /v1/oauth/token also work, but a client id/secret is only for platforms acting on another tenant's behalf, not for your own integration.

Body

application/json
network
enum<string>
required
Available options:
MTN,
AIRTEL,
GLO,
9MOBILE
phoneNumber
string
required
Example:

"08012345678"

amount
integer
required

Naira (1 to 500,000).

Example:

500

Response

Bill transaction

id
string
category
enum<string>
Available options:
airtime,
data,
betting,
cabletv,
electricity
provider
string
recipient
string
amount
integer

Minor units (kobo).

currency
string
status
enum<string>
Available options:
success,
processing,
failed
reference
string
nombaReference
string | null
meta
object | null

Provider metadata, e.g. a prepaid electricity token.

createdAt
string<date-time>