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: 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"
  }'
const response = await fetch("https://tente.com.ng/api/v1/airtime", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
    "Accept": "application/json"
  },
  body: JSON.stringify({
    network: "mtn",
    mobileno: "08031234567",
    amount: 1000,
    request_id: "REQ_AIR_" + Date.now()
  })
});

const data = await response.json();
console.log(data);
<?php

$client = new \GuzzleHttp\Client();

$response = $client->post('https://tente.com.ng/api/v1/airtime', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_API_TOKEN',
        'Content-Type'  => 'application/json',
        'Accept'        => 'application/json',
    ],
    'json' => [
        'network'    => 'mtn',
        'mobileno'   => '08031234567',
        'amount'     => 1000,
        'request_id' => 'REQ_AIR_' . uniqid(),
    ]
]);

$body = json_decode($response->getBody(), true);
print_r($body);
import requests

url = "https://tente.com.ng/api/v1/airtime"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
    "Accept": "application/json"
}
payload = {
    "network": "mtn",
    "mobileno": "08031234567",
    "amount": 1000,
    "request_id": "REQ_AIR_123456"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

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."
}