Skip to main content

Overview

Electricity purchases follow a two-step flow:
  1. Validate the meter number to confirm it’s active and retrieve the customer name
  2. Buy units (prepaid token) or pay a postpaid bill
Supported DISCOs include IKEDC, EKEDC, AEDC, PHEDC, and others.

Authentication

Both endpoints require your merchant API key and the channel: API header.

Step 1 — Validate meter

Request body

Sample response

Always show customerName to the user before proceeding to purchase — it confirms the meter number is correct.

Step 2 — Buy electricity token

Request body

Sample response (prepaid)

For prepaid meters, the token field in the response is the recharge token to give the customer. Store it with the transaction record.

Full purchase flow

The minimum vend amount is ₦500. Requests below this threshold return a 400 validation error.

Next steps