Electricity Bill Payment API

Pay electricity bills (e.g., EKEDC, IKEDC, AEDC, KEDCO, PHEDC, JEDC, and others) using a secure HTTPS GET API. Responses are returned in JSON.

GET HTTPS JSON

Your Credentials

UserID

APIKey

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

Generate New Key

Endpoints

Pay Electricity Bill

APIElectricityV1.asp

https://www.nellobytesystems.com/APIElectricityV1.asp?UserID=your_userid&APIKey=your_apikey&ElectricCompany=electric_company_code&MeterType=meter_type&MeterNo=meter_no&Amount=amount&PhoneNo=recipient_phoneno&RequestID=request_id&CallBackURL=callback_url

Verify Meter Number

APIVerifyElectricityV1.asp

https://www.nellobytesystems.com/APIVerifyElectricityV1.asp?UserID=your_userid&APIKey=your_apikey&ElectricCompany=electric_company_code&MeterNo=meter_no&MeterType=meter_type

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

Try It (Quick Test)

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

UserID

APIKey

ElectricCompany

MeterType

MeterNo

Amount

PhoneNo

RequestID

CallBackURL

Idle

Request URL

—

Response

—

Request Parameters

Parameter	Description
UserID	Your account UserID.
APIKey	Your API key used to authenticate requests.
ElectricCompany	Electric company code (see “Available Electricity Companies” below)
MeterType	Meter type code (see “Available Meter Types” below)
MeterNo	Customer meter number.
Amount	Amount to purchase.
PhoneNo	Recipient phone number (for notifications).
RequestID	Unique request ID (recommended for reconciliation and retries).
CallBackURL	Callback URL for asynchronous transaction status updates.

Available Electricity Companies

This section is loaded from the live electricity discos endpoint:

Electric Company Code	Electricity Company	Meter Type Code	Discount Amount	Discount

Examples

Sample: EKEDC Prepaid ₦2000 for MeterNo 1234567890

Replace credentials with yours

https://www.nellobytesystems.com/APIElectricityV1.asp?UserID=CK123&APIKey=456&ElectricCompany=01&MeterType=01&MeterNo=1234567890&Amount=2000&PhoneNo=08149659347&CallBackURL=http://www.your-website.com

JSON response (order received)

{
  "orderid": "789",
  "statuscode": "100",
  "status": "ORDER_RECEIVED",
  "meterno": "1234567890",
  "metertoken": "000123"
}

Verify meter number (sample)

https://www.nellobytesystems.com/APIVerifyElectricityV1.asp?UserID=CK123&APIKey=456&ElectricCompany=01&MeterNo=1234567890&MeterType=01

Verify response

{
  "customer_name": "BALOGUN SUNDAY"
}

If verification fails, the API may return: {"customer_name":"INVALID_METERNO"}

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=TRANSACTION%20SUCCESSFUL

JSON format

{
  "orderdate": "22th-Jul-2023",
  "orderid": "6501321715",
  "requestid": "",
  "statuscode": "200",
  "orderstatus": "ORDER_COMPLETED",
  "orderremark": "TRANSACTION SUCCESSFUL"
}

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_Electricity`	Electricity Company field is empty.
`MISSING_MeterType`	MeterType field is empty.
`INVALID_MeterNo`	An invalid Meter number was entered.
`MeterType_NOT_AVAILABLE`	Selected MeterType is not currently available.
`ORDER_RECEIVED`	Your order has been received.

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

Electricity Bill Payment API

Latest Posts

Useful Links

Contact Us