Skip to main content
POST
Buy Data

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_abc124"

service_code
string
required

A data service code from List Billers (category=data).

Example:

"mtn-data"

phone_number
string
required

An 11 digit Nigerian mobile number, starting with 0.

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

"08031234567"

bundle_id
string
required

A bundle ID from List Data Bundles for the same service_code.

Example:

"mtn-2gb-30days"

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