Endpoints
Buy Airtime
https://www.nellobytesystems.com/APIAirtimeV1.asp?UserID=your_userid&APIKey=your_apikey&MobileNetwork=mobilenetwork_code&Amount=order_amount&MobileNumber=recipient_mobilenumber&RequestID=request_id&CallBackURL=callback_url
Query Transaction
https://www.nellobytesystems.com/APIQueryV1.asp?UserID=your_userid&APIKey=your_apikey&OrderID=order_id
https://www.nellobytesystems.com/APIQueryV1.asp?UserID=your_userid&APIKey=your_apikey&RequestID=request_id
Try It (Quick Test)
Build a request URL and test quickly. (Uses browser fetch; CORS depends on server settings.)
Idle
Available Mobile Networks
You can fetch available networks in JSON using:
https://www.nellobytesystems.com/APIAirtimeNetworkV2.asp?UserID=
| Network |
Mobile Network ID |
Minimum Amount |
Maximum Amount |
Discount Amount |
Discount |
| MTN | 01 | 50.00 | 200,000.00 | 0.970 | 3% |
| Glo | 02 | 50.00 | 200,000.00 | 0.920 | 8% |
| t2mobile | 03 | 50.00 | 200,000.00 | 0.930 | 7% |
| Airtel | 04 | 50.00 | 200,000.00 | 0.970 | 3% |
Examples
Sample: Buy N100 MTN for 08149659347
Replace credentials with yours
https://www.nellobytesystems.com/APIAirtimeV1.asp?UserID=CK123&APIKey=456&MobileNetwork=01&Amount=100&MobileNumber=08149659347&CallBackURL=http://www.your-website.com
JSON response (order received)
{
"orderid": "789",
"statuscode": "100",
"status": "ORDER_RECEIVED"
}
Query transaction (sample)
https://www.nellobytesystems.com/APIQueryV1.asp?UserID=CK123&APIKey=456&OrderID=789
Query response
{
"date": "22th-Jul-2023",
"orderid": "6501321715",
"requestid": "",
"statuscode": "200",
"status": "ORDER_COMPLETED",
"remark": "You have successfully topped up N100.00 to 2348149659347.",
"ordertype": "100 Credit",
"mobilenetwork": "MTN",
"mobilenumber": "08149659347",
"amountcharged": "96.5",
"walletbalance": "3651.449"
}
Cancel transaction (sample)
https://www.nellobytesystems.com/APICancelV1.asp?UserID=CK123&APIKey=456&OrderID=789
Cancel response
{
"status": "ORDER_CANCELLED",
"orderid": "789"
}
Callback (CallBackURL)
After processing, we will call your CallBackURL with the OrderID, StatusCode, OrderStatus, and OrderRemark.
Query string format
http://your_callback_url?orderdate=22th-Jul-2023&orderid=6501321715&statuscode=200&orderstatus=ORDER_COMPLETED&orderremark=You%20have%20successfully%20topped%20up%20N100.00%20to%202348149659347
JSON format
{
"orderdate": "22th-Jul-2023",
"orderid": "6501321715",
"requestid": "",
"statuscode": "200",
"orderstatus": "ORDER_COMPLETED",
"orderremark": "You have successfully topped up N100.00 to 2348149659347."
}
Status Codes
Common errors and statuses are listed below. For the full list, use:
View full list of Status Code and Descriptions
| STATUS |
DESCRIPTION |
INVALID_CREDENTIALS | UserID and APIKey combination is not correct. |
MISSING_CREDENTIALS | URL format is not valid (missing required parameters). |
MISSING_USERID | UserID field is empty. |
MISSING_APIKEY | APIKey field is empty. |
MISSING_MOBILENETWORK | MobileNetwork is empty. |
MISSING_AMOUNT | Amount is empty. |
INVALID_AMOUNT | Amount is not valid. |
MINIMUM_50 | Minimum amount is 50. |
MINIMUM_200000 | Maximum amount is 200,000. |
INVALID_RECIPIENT | An invalid mobile phone number was entered. |
ORDER_RECEIVED | Your order has been received. |
Since we use a GET API, responses are returned in JSON.