WAEC e-PIN API
Integrate using a secure HTTPS GET API. Responses are returned in JSON.
GET
HTTPS
JSON
CANCEL
Important: The “Buy e-PIN” endpoint shown below is APIWAECV1.asp and supports
ExamType values for available packages (e.g., WAEC).
If you intend to present this page strictly as WAEC e-PIN, rename the heading and update examples
to WAEC-specific packages while keeping the same structure.
Your Credentials
UserID
APIKey
********************************
Endpoints
Buy Education e-PIN
https://www.nellobytesystems.com/APIWAECV1.asp?UserID=your_userid&APIKey=your_apikey&ExamType=exam_code&PhoneNo=recipient_phoneno&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
Available Packages
Use this endpoint to retrieve supported ExamType values in JSON:
APIWAECPackagesV2.asp
https://www.nellobytesystems.com/APIWAECPackagesV2.asp?UserID=
Try It (Quick Test)
Build and test a purchase request. (Uses browser fetch; CORS depends on server settings.)
For the latest list, call APIWAECPackagesV2.
Idle
Request Parameters
| Parameter |
Description |
| UserID | Your account UserID. |
| APIKey | Your API key used to authenticate requests. |
| ExamType |
Package code (e.g., WAEC package).
You can fetch available codes using:
APIWAECPackagesV2.asp?UserID=...
Examples from this page: waecdirect, waec-registration.
|
| PhoneNo | Recipient phone number. |
| RequestID | Unique request ID (recommended for reconciliation and safe retries). |
| CallBackURL | Callback URL for asynchronous transaction status updates. |
| OrderID | Used for querying or cancelling a transaction (system-generated after purchase). |
Examples
Sample: Buy WAEC Checker PIN for PhoneNo 08149659347
Replace credentials with yours
https://www.nellobytesystems.com/APIWAECV1.asp?UserID=CK123&APIKey=456&ExamType=waecdirect&PhoneNo=08149659347&RequestID=789&CallBackURL=http://www.your-website.com
JSON response (sample)
{
"date": "17th-Mar-2019",
"orderid": "798",
"statuscode": "200",
"status": "ORDER_COMPLETED",
"remark": "TRANSACTION SUCCESSFUL",
"ordertype": "WAEC Result Checker PIN",
"carddetails": "Serial No:WRN200343867, pin: 572871474684",
"phoneno": "08149659347",
"amountcharged": "2000",
"walletbalance": "863210.1"
}
Query by OrderID
https://www.nellobytesystems.com/APIQueryV1.asp?UserID=CK123&APIKey=456&OrderID=789
Cancel by OrderID
https://www.nellobytesystems.com/APICancelV1.asp?UserID=CK123&APIKey=456&OrderID=789
Cancel response (sample)
{
"status": "ORDER_CANCELLED",
"orderid": "789"
}
Cancellation rule: You can only cancel a transaction whose status is
ORDER_RECEIVED or ORDER_ONHOLD.
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_EXAMTYPE | ExamType field is empty. |
INVALID_PHONENO | An invalid phone number was entered. |
ORDER_RECEIVED | Your order has been received. |
Since we use a GET API, responses are returned in JSON.