Databundle Purchase API
Integrate using a secure HTTPS GET API. Responses are returned in JSON.
GET
HTTPS
JSON
Your Credentials
UserID
APIKey
********************************
Endpoints
Buy Databundle
https://www.nellobytesystems.com/APIDatabundleV1.asp?UserID=your_userid&APIKey=your_apikey&MobileNetwork=mobilenetwork_code&DataPlan=product_code&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.)
Loading networks and data plans...
Idle
Request Parameters
| Parameter |
Description |
| UserID | Your account UserID. |
| APIKey | Your API key used to authenticate requests. |
| MobileNetwork |
Mobile network code (see “Available Mobile Networks” below)
|
| DataPlan |
Data plan code (PRODUCT_CODE; see “Available Data Plans” below).
|
| MobileNumber | Recipient mobile number (MSISDN). |
| RequestID | Unique request ID (recommended for reconciliation and retries). |
| CallBackURL | Callback URL for asynchronous transaction status updates. |
Available Mobile Networks
You can fetch available networks in JSON using:
https://www.nellobytesystems.com/APIDatabundleNetworkV1.asp?UserID=
| Network |
Mobile Network ID |
Discount Amount |
Discount |
| Loading... |
Available Data Plans
You can fetch plans in JSON using:
https://www.nellobytesystems.com/APIDatabundlePlansV3.asp?UserID=
Examples
Sample: Buy 1GB MTN for 08149659347
Replace credentials with yours
https://www.nellobytesystems.com/APIDatabundleV1.asp?UserID=CK11&APIKey=123&MobileNetwork=01&DataPlan=4&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
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=Dear%20Customer%2C%20You%20have%20successfully%20shared%2050MB%20Data%20to%2008149659347
JSON format
{
"orderdate": "22th-Jul-2023",
"orderid": "6501321715",
"requestid": "",
"statuscode": "200",
"orderstatus": "ORDER_COMPLETED",
"orderremark": "Dear Customer, You have successfully shared 50MB Data to 08149659347"
}
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 | The UserID and API key combination is not correct. |
MISSING_CREDENTIALS | The URL format is not valid. |
MISSING_USERID | UserID field is empty. |
MISSING_APIKEY | API Key field is empty. |
MISSING_MOBILENETWORK | Mobile network is empty. |
MISSING_DATAPLAN | Data plan is empty. |
INVALID_DATAPLAN | Data plan is not valid. |
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.