Skip to main content
POST
/
purchaseAirtime
Purchase Airtime
curl --request POST \
  --url https://api.bleeprs.com/api/purchaseAirtime \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "amount": 50,
    "phoneNumber": "08107176819",
    "network": "MTN",
    "productCode": "LA_MTN"
  }
]
'
{
  "gatewayStatus": "00",
  "gatewayMessage": "Sucessfully Processed",
  "requestReference": "JJqI1HCxemtGpMOWOESU",
  "data": "Airtime purchased processing"
}

​
Overview

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

​
Supported Networks

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

​
Notes

  • Airtime is credited instantly to the recipient’s phone
  • Minimum purchase amount is ₦100
  • Maximum purchase amount varies by network (typically ₦30,000)
  • Phone numbers should be in Nigerian format (e.g., 08107176819)
  • Transaction processing may take a few seconds

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 (Nigerian format)

Example:

"08107176819"

​
network
enum<string>
required

Network provider

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

"MTN"

​
productCode
enum<string>
required

Standard product code retrieved from the Airtime catalog

Available options:
LA_MTN,
LA_AIRTEL,
LA_GLOBACOM,
LA_9MOBILE,
BP_MTN,
BP_AIRTEL,
BP_GLOBACOM,
BP_9MOBILE
Example:

"LA_MTN_VTU"

​
voucherCode
string

Provider-specific voucher SKU if applicable

Example:

""

Response

202 - application/json

Airtime purchase accepted for processing

​
gatewayStatus
string
Example:

"00"

​
gatewayMessage
string
Example:

"Sucessfully Processed"

​
requestReference
string
Example:

"JJqI1HCxemtGpMOWOESU"

​
data
string
Example:

"Airtime purchased processing"