Purchase Airtime
Vending
Purchase Airtime
Purchase airtime for a phone number
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..., or80...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
requestReferencereturned by the API for reconciliation and support
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Minimum array length:
1Amount of airtime to purchase (in Naira)
Example:
50
Recipient's phone number. Accepted as 08012345678, 2348012345678, or 8012345678 — normalized to the 11-digit local format.
Example:
"08107176819"
Network provider
Available options:
MTN, AIRTEL, GLOBACOM, 9MOBILE Example:
"MTN"
Product code returned by the Airtime catalog
Example:
"MTN_AIRTIME_PRODUCT_CODE"
Voucher code returned by the Airtime catalog, when provided
Example:
""
Operator value returned by the Airtime catalog
Example:
"MTN"
Region value returned by the Airtime catalog
Example:
"NG"