Airtime Recharge PIN (EPIN) API

Generate and print Airtime Recharge PINs (EPIN) using a secure HTTPS GET API. Suitable for Web, Mobile Apps, USSD, ATM, and other e-channels. Responses are returned in JSON.

GET HTTPS JSON

Your Credentials

UserID

APIKey

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

Generate New Key

Endpoints

Buy Airtime EPIN

APIEPINV1.asp

https://www.nellobytesystems.com/APIEPINV1.asp?UserID=your_userid&APIKey=your_apikey&MobileNetwork=mobilenetwork_code&Value=value&Quantity=quantity&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

Discount / Available Services

Use this endpoint to retrieve available EPIN services (and discounts) in JSON:

APIEPINDiscountV2.asp

https://www.nellobytesystems.com/APIEPINDiscountV2.asp?UserID=

Try It (Quick Test)

Build a request URL and test quickly. (Uses browser fetch; CORS depends on server settings.)

UserID

APIKey

MobileNetwork

Value

Quantity

Allowed range: 1 to 100

RequestID (recommended)

CallBackURL (optional)

Idle

Request URL

—

Response

—

Request Parameters

Parameter	Description
UserID	Your account UserID.
APIKey	Your API key used to authenticate requests.
MobileNetwork	Mobile network code: `01` = MTN `02` = Glo `03` = Etisalat `04` = Airtel
Value	EPIN value. Allowed: `100`, `200`, `500`.
Quantity	Number of PINs to generate. Allowed: `1` to `100`.
RequestID	Unique request ID (recommended for reconciliation and safe retries).
CallBackURL	Callback URL for asynchronous transaction status updates.

Examples

Sample: Print 1 quantity of ₦100 MTN EPIN (RequestID 789)

Replace credentials with yours

https://www.nellobytesystems.com/APIEPINV1.asp?UserID=CK123&APIKey=456&MobileNetwork=01&Value=100&Quantity=1&RequestID=789&CallBackURL=http://www.your-website.com

JSON response (sample)

{
  "TXN_EPIN": [
    {
      "transactionid": "6329036611",
      "transactiondate": "12/20/2019 9:08:00 PM",
      "mobilenetwork": "MTN",
      "amount": "100",
      "batchno": "82057",
      "sno": "00000003802132587",
      "pin": "14819613681469920"
    }
  ]
}

Query by RequestID

https://www.nellobytesystems.com/APIQueryV1.asp?UserID=CK123&APIKey=456&RequestID=789

Query response (sample)

{
  "TXN_EPIN": [
    {
      "transactionid": "6329036611",
      "requestid": "",
      "transactiondate": "12/20/2019 9:08:00 PM",
      "batchno": "82057",
      "mobilenetwork": "MTN",
      "sno": "00000003802132587",
      "pin": "14819613681469920",
      "amount": "100"
    }
  ]
}

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_VALUE`	Value is empty.
`INVALID_VALUE`	Value is not valid.
`INVALID_QUANTITY`	Invalid quantity.
`VALUE_ALLOWED_100_200_500`	Allowed values: 100, 200 or 500.
`MINIMUM_QUANTITY_1`	Minimum quantity is 1.
`MAXIMUM_QUANTITY_100`	Maximum quantity is 100.
`REQUEST_QUEUED`	Request is queued.
`REQUEST_PROCESSING`	Request is processing.
`QUANTITY_NOT_AVAILABLE`	Requested quantity not available.
`PIN_NOT_AVAILABLE`	PIN not available.
`INSUFFICIENT_WALLET_BALANCE`	Insufficient wallet balance.

Since we use a GET API, responses are returned in JSON.

Airtime Recharge PIN (EPIN) API

Latest Posts

Useful Links

Contact Us