BILL PAYMENT

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 must validate the meter number to retrieve the customer's name and ensure the account is active.

POST /api/v1/electricity/validate

PARAMETER	TYPE	DESCRIPTION	REQUIRED
`disco`	string	e.g., KEDCO, IKEDC, AEDC, IBEDC.	Required
`meter_number`	string	The customer's meter number.	Required
`meter_type`	string	`prepaid` or `postpaid`.	Required

Step 2: Payment Endpoint

Once validated, use this endpoint to finalize the transaction and receive a token (for prepaid) or payment confirmation.

POST /api/v1/electricity/pay

PARAMETER	TYPE	DESCRIPTION	REQUIRED
`disco`	string	Distribution company identifier.	Required
`meter_number`	string	The 10 to 13-digit meter number.	Required
`amount`	numeric	Amount in Naira.	Required
`phone`	string	Customer's phone number.	Required
`reference`	string	Your unique transaction reference.	Required

Example Response (Prepaid Token)

{
    "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"
    }
}