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

********************************

Generate New Key

Endpoints

Buy Education e-PIN

APIWAECV1.asp

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

By OrderID

https://www.nellobytesystems.com/APIQueryV1.asp?UserID=your_userid&APIKey=your_apikey&OrderID=order_id

By RequestID

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.)

UserID

APIKey

ExamType

For the latest list, call APIWAECPackagesV2.

PhoneNo

RequestID (recommended)

CallBackURL (optional)

Idle

Request URL

—

Response

—

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.

WAEC e-PIN API

Latest Posts

Useful Links

Contact Us