Skip to main content
POST
Purchase Airtime

Overview

Purchase airtime for any Nigerian phone number on supported networks. The airtime will be credited instantly to the recipient’s phone.

Request Body

Send an array with one or more airtime purchases.

Response Fields

string
Reference to store for reconciliation and support.
object
Details of the accepted batch.

Status Codes

Supported Networks

  • MTN - MTN Nigeria
  • AIRTEL - Airtel Nigeria
  • GLOBACOM - Glo Nigeria
  • 9MOBILE - 9mobile Nigeria

Notes

  • Airtime is credited instantly to the recipient’s phone
  • The minimum purchase amount is ₦100; refer to the airtime catalog for network-specific limits.
  • Maximum purchase amounts are returned by the airtime catalog
  • Phone numbers are accepted as 080..., 23480..., or 80... and normalized to the 11-digit local format; non-Nigerian mobile numbers are rejected before any charge
  • Transaction processing may take a few seconds
  • Store the requestReference returned by the API for reconciliation and support

Authorizations

Authorization
string
header
required

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

Body

application/json
Minimum array length: 1
amount
number
required

Amount of airtime to purchase (in Naira)

Example:

50

phoneNumber
string
required

Recipient's phone number. Accepted as 08012345678, 2348012345678, or 8012345678 — normalized to the 11-digit local format.

Example:

"08107176819"

network
enum<string>
required

Network provider

Available options:
MTN,
AIRTEL,
GLOBACOM,
9MOBILE
Example:

"MTN"

productCode
string
required

Product code returned by the Airtime catalog

Example:

"MTN_AIRTIME_PRODUCT_CODE"

voucherCode
string

Voucher code returned by the Airtime catalog, when provided

Example:

""

operator
string

Operator value returned by the Airtime catalog

Example:

"MTN"

region
string

Region value returned by the Airtime catalog

Example:

"NG"

Response

Batch accepted for processing. Airtime is credited within a few seconds; use each reference in data.references to track individual items.

gatewayStatus
string
Example:

"00"

gatewayMessage
string
Example:

"Successfully Processed"

requestReference
string
Example:

"JJqI1HCxemtGpMOWOESU"

data
object