Skip to main content
POST
Buy Airtime

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
reference
string
required

Your unique reference for this purchase, used for idempotency and tracking.

Maximum string length: 255
Example:

"bill_abc123"

service_code
string
required

An airtime service code from Network Lookup or List Billers (category=airtime).

Example:

"mtn-airtime"

phone_number
string
required

An 11 digit Nigerian mobile number, starting with 0.

Pattern: ^0\d{10}$
Example:

"08031234567"

amount
number
required

Amount in naira, at least 50, with at most 2 decimal places.

Required range: x >= 50
Example:

1000

Response

The purchase was accepted. Check data.status: successful, failed (refunded), or pending (settles later by webhook). The message is Bill payment successful, Bill payment failed or Bill payment is processing to match.

status
string
Example:

"success"

message
string
Example:

"Bill payment successful"

data
object