Electricity Bill Payment

Purchase electricity tokens or pay postpaid bills for all major distribution companies (DisCos) in Nigeria.

Step 1: Validate Meter Number

Before making a payment, you should validate the meter number to retrieve the customer's name.

POST /electricity/validate

Parameter	Type	Description
`disco`	`string`	e.g., KEDCO, IKEDC, AEDC, IBEDC.
`meter_number`	`string`	The customer's meter number.
`meter_type`	`string`	`prepaid` or `postpaid`.

Step 2: Payment Endpoint

POST /electricity/pay

Parameters

Parameter	Type	Description
`disco`	`string`	Distribution company identifier.
`meter_number`	`string`	The 10 to 13-digit meter number.
`meter_type`	`string`	`prepaid` or `postpaid`.
`amount`	`numeric`	Amount in Naira.
`phone`	`string`	Customer's phone number.
`reference`	`string`	Your unique transaction reference.

Example Response (Prepaid Token)

JSON

{
    "status": true,
    "message": "Electricity token generated successfully",
    "data": {
        "transaction_id": "ELEC-999000",
        "customer_name": "JOHN DOE",
        "meter": "0123456789",
        "amount": 2000,
        "token": "4521 8905 1234 5678 9012",
        "units": "34.5 kWh"
    }
}