Ultra Fast Airtime Top-Up API
Airtime VTU API Nigeria
Instant automated airtime vending for MTN, Airtel, Glo, and 9mobile. Low latency, failover redundancy, and up to 5% developer discounts.
POST
https://babspay.com.ng/api/airtime
Dispatches instant airtime to any Nigerian phone number.
Headers
Authorization: Bearer YOUR_SECRET_API_KEY
Content-Type: application/json
Accept: application/json
Request Body (JSON)
{
"network": 1, // 1: MTN, 2: GLO, 3: 9MOBILE, 4: AIRTEL
"amount": 1000, // Airtime face value (NGN)
"mobile_number": "08137000125",
"Ported_number": true
}
Success Response (200 OK)
{
"status": "success",
"message": "Airtime recharge successful",
"transaction_id": "BP-AIRTIME-451298",
"network": "MTN",
"amount_vended": 1000.00,
"discount_applied": "3.5%",
"amount_charged": 965.00,
"balance_after": 24150.00
}
Frequently Asked Questions (FAQ)
How does the Airtime API handle discounts?
Your developer account wallet is charged the discounted amount directly based on your tier (e.g. ₦97.00 charged for ₦100 airtime).
What happens if a recipient phone number is invalid?
The API validates phone numbers instantly and returns a 400 Bad Request with a clear JSON error message, without debiting your wallet.
Can I query the status of an airtime transaction?
Yes, use the GET /api/transaction/{transaction_id} endpoint to retrieve the real-time status and carrier reference.