BILL PAYMENT

Airtime Topup

Recharge airtime seamlessly across all major Nigerian telecommunication networks (MTN, GLO, AIRTEL, 9MOBILE).

POST /api/v1/airtime

Authentication & Headers

HEADER	VALUE	REQUIRED
`Authorization`	`Bearer YOUR_API_TOKEN`	Yes
`Content-Type`	`application/json`	Yes

Request Parameters

PARAMETER	TYPE	DESCRIPTION	REQUIRED
`network`	string	Network ID (e.g., MTN, GLO, AIRTEL, 9MOBILE).	Required
`phone`	string	The 11-digit recipient phone number.	Required
`amount`	numeric	The amount in Naira (NGN) to recharge.	Required
`reference`	string	A unique transaction reference for your system.	Required

JSON Payload

JSON

{
    "network": "MTN",
    "phone": "08012345678",
    "amount": 500,
    "reference": "TXN_123456789"
}

Success Response

{
    "status": true,
    "message": "Airtime purchased successfully",
    "data": {
        "transaction_id": "ASI-123456789",
        "reference": "TXN_123456789",
        "network": "MTN",
        "phone": "08012345678",
        "amount": 500,
        "balance_before": 1500,
        "balance_after": 1000
    }
}