Smile Databundle API
Integrate using a secure HTTPS GET API. Responses are returned in JSON.
GET
HTTPS
JSON
Your Credentials
UserID
APIKey
********************************
Endpoints
Buy Smile Databundle
https://www.nellobytesystems.com/APISmileV1.asp?UserID=your_userid&APIKey=your_apikey&MobileNetwork=smile-direct&DataPlan=dataplan_code&MobileNumber=smile_account_id&RequestID=request_id&CallBackURL=callback_url
Verify Smile Account
APIVerifySmileV1.asp
https://www.nellobytesystems.com/APIVerifySmileV1.asp?UserID=your_userid&APIKey=your_apikey&MobileNetwork=smile-direct&MobileNumber=smile_account_id
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
Available Smile Packages (JSON)
Retrieve available Smile packages and variation codes:
APISmilePackagesV2.asp
https://www.nellobytesystems.com/APISmilePackagesV2.asp?UserID=
Try It (Quick Test)
Build a request URL and test quickly. (Uses browser fetch; CORS depends on server settings.)
Idle
Operational Notes
- Verify the Smile Account ID first using APIVerifySmileV1.
- Use a unique RequestID to support safe retries and reconciliation.
- Use APIQueryV1 to confirm final status for queued/processing transactions.
- Cancellation is allowed only for
ORDER_RECEIVED or ORDER_ONHOLD.
Request Parameters
| Parameter |
Description |
| UserID | Your account UserID. |
| APIKey | Your API key used to authenticate requests. |
| MobileNetwork | Smile network code: smile-direct. |
| DataPlan | Smile package variation code (from APISmilePackagesV2). |
| MobileNumber | Recipient Smile Account ID (phone number format). |
| RequestID | Unique request ID (recommended). |
| CallBackURL | Callback URL for asynchronous transaction status updates. |
| OrderID | Returned after request is received. Used for query/cancel operations. |
Examples
Sample: Buy Smile 1GB Flexi (variation code 624) for Smile Account ID 1234567890
Replace credentials with yours
https://www.nellobytesystems.com/APISmileV1.asp?UserID=CK123&APIKey=456&MobileNetwork=smile-direct&DataPlan=624&MobileNumber=1234567890&RequestID=789&CallBackURL=http://www.your-website.com
Immediate response (sample)
{
"orderid": "789",
"statuscode": "100",
"status": "ORDER_RECEIVED"
}
Query by OrderID
https://www.nellobytesystems.com/APIQueryV1.asp?UserID=CK123&APIKey=456&OrderID=789
Query response (sample)
{
"date": "17th-Mar-2019",
"orderid": "798",
"requestid": "",
"statuscode": "200",
"status": "ORDER_COMPLETED",
"remark": "TRANSACTION SUCCESSFUL",
"ordertype": "1GB Flexi for 1days - 300 Naira",
"mobilenumber": "1234567890",
"amountcharged": "2000",
"walletbalance": "863210.1"
}
Cancel an Order (OrderID 789)
https://www.nellobytesystems.com/APICancelV1.asp?UserID=CK123&APIKey=456&OrderID=789
Cancel response (sample)
{
"status": "ORDER_CANCELLED",
"orderid": "789"
}
Note: You can only cancel transactions whose status is ORDER_RECEIVED or ORDER_ONHOLD.
Verify Smile Account
Verify the Smile Account ID before purchase. A successful verification returns the account holder name.
Verify request
https://www.nellobytesystems.com/APIVerifySmileV1.asp?UserID=CK123&APIKey=456&MobileNetwork=smile-direct&MobileNumber=1234567890
Verify response (success)
{
"customer_name": "BALOGUN SUNDAY LIV LADORITE"
}
Verify response (error)
{
"customer_name": "INVALID_ACCOUNTNO"
}
Callback (CallBackURL)
After processing, we will call your CallBackURL with the OrderID, StatusCode, OrderStatus, and OrderRemark.
You can also use APIQueryV1 to confirm final status.
Callback example (query string)
https://your_callback_url?orderdate=22th-Jul-2023&orderid=6501321715&statuscode=200&orderstatus=ORDER_COMPLETED&orderremark=TRANSACTION%20SUCCESSFUL
Callback example (JSON)
{
"orderdate": "22th-Jul-2023",
"orderid": "6501321715",
"requestid": "",
"statuscode": "200",
"orderstatus": "ORDER_COMPLETED",
"orderremark": "TRANSACTION SUCCESSFUL"
}
Status Codes
Common responses 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 is empty. |
MISSING_APIKEY | APIKey is empty. |
MISSING_MOBILENETWORK | MobileNetwork is empty. |
MISSING_DATAPLAN | DataPlan is empty. |
INVALID_ACCOUNTNO | An invalid Smile Account ID was entered. |
DATAPLAN_NOT_AVAILABLE | Selected data plan is not currently available. |
ORDER_RECEIVED | Your order has been received. |
Since we use a GET API, responses are returned in JSON.
Smile Packages (Optional Display)
You can display Smile package codes and names server-side (as you do with APIVTPassServiceVariations),
or call APISmilePackagesV2 to retrieve packages in JSON format. For performance, consider caching results
briefly (e.g., 5–15 minutes).
https://www.nellobytesystems.com/APISmilePackagesV2.asp?UserID=