POST
/api/v1/airtime
The Airtime VTU API allows merchants, developers, and fintech platforms to automate instant mobile airtime top-ups across all major Nigerian telecommunication networks including MTN, Airtel, Glo, and 9mobile.
⚡ Automated Cashback & Instant Discount
Service Code:
Sub-Second Delivery: Recharges are fulfilled synchronously in under 2 seconds with automatic retry and upstream failover.
Airtime |
Instant Commission: Up to 2.0% - 3.5% cashback credited automatically to your wallet.
Sub-Second Delivery: Recharges are fulfilled synchronously in under 2 seconds with automatic retry and upstream failover.
Request Headers
| Header | Type | Required | Description |
|---|---|---|---|
Authorization |
string | Required | Bearer API Token (e.g., Bearer your_api_token_here) |
Content-Type |
string | Required | application/json |
Accept |
string | Required | application/json |
Request Parameters (JSON Body)
| Parameter | Type | Required | Description & Example |
|---|---|---|---|
network |
string | Required | Network code or identifier: 101 / mtn, 100 / airtel, 102 / glo, 103 / 9mobile. |
mobileno |
string | Required | Recipient's 11-digit phone number (e.g., 08031234567). |
amount |
numeric | Required | Recharge amount in Naira (Min: 50, Max: 50000). |
request_id |
string | Optional | Unique merchant client reference for idempotency and transaction tracking. |
Integration Code Examples
curl -X POST "https://tente.com.ng/api/v1/airtime" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"network": "mtn",
"mobileno": "08031234567",
"amount": 1000,
"request_id": "REQ_AIR_992019482"
}'
Sample 200 OK Success Response
{
"status": "success",
"message": "Airtime recharge of ₦1,000.00 to 08031234567 was successful.",
"data": {
"transaction_ref": "AIR20260831142055A9B1",
"request_id": "REQ_AIR_992019482",
"network": "101",
"network_name": "Mtn",
"amount": 1000.00,
"phone": "08031234567",
"type": "Airtime Recharge",
"commission_rate": "2%",
"commission_earned": 20.00,
"new_balance": 48500.00,
"status": "completed",
"created_at": "2026-08-31T14:20:55+01:00"
}
}
Supported Network Codes Reference
| Network | Numeric Code | String Identifier | Min / Max Amount | Status |
|---|---|---|---|---|
| MTN Nigeria | 101 |
mtn |
₦50 - ₦50,000 | Active |
| Airtel Nigeria | 100 |
airtel |
₦50 - ₦50,000 | Active |
| Glo (Globacom) | 102 |
glo |
₦50 - ₦50,000 | Active |
| 9mobile (Etisalat) | 103 |
9mobile / etisalat |
₦50 - ₦50,000 | Active |
Error Responses
402 Insufficient Balance
{
"status": "error",
"message": "Insufficient wallet balance."
}
422 Validation Error
{
"status": "error",
"message": "The mobileno field must be 11 digits."
}
401 Unauthorized
{
"status": "error",
"message": "Unauthorized or account restricted."
}