Skip to Content
Electricity

Electricity

Pay prepaid or postpaid electricity for Nigerian DisCos. Use product ELECTRICITY, put the meter number in customer_msisdn, and send a catalog plan_code.

POST /ext/breeze/v1/transactions

External create is async — poll Check status with your client_request_id until response_code is 00 or 01.

1. List electricity plans

GET /ext/breeze/v1/plans/bills/electricity

Optional filter: ?network=IKEDC.

curl "https://staging-intelligent-70287b6a3284.herokuapp.com/ext/breeze/v1/plans/bills/electricity?network=IKEDC" \
  -H "X-Merchant-Key: mk_live_your_key_id" \
  -H "X-Merchant-Secret: sk_live_your_secret"

Use the returned plan id as plan_code on purchase.

DisCo network values

IKEDC, EKEDC, AEDC, IBEDC, EEDC, KEDCO, JED, PHED, BEDC, ABEDC, KAEDCO, YEDC, ABA

2. Pay electricity

curl -X POST "https://staging-intelligent-70287b6a3284.herokuapp.com/ext/breeze/v1/transactions" \
  -H "Content-Type: application/json" \
  -H "X-Merchant-Key: mk_live_your_key_id" \
  -H "X-Merchant-Secret: sk_live_your_secret" \
  -d '{
    "merchant_code": "YOUR_MERCHANT",
    "customer_msisdn": "45012345678",
    "network": "IKEDC",
    "product": "ELECTRICITY",
    "plan_code": "1001",
    "amount": "5000",
    "client_request_id": "breeze-electricity-001"
  }'
FieldRequiredDescription
merchant_codeYesYour merchant profile
customer_msisdnYesMeter number
networkYesDisCo code (e.g. IKEDC)
productYesELECTRICITY
plan_codeYesCatalog id from plans list
amountYesPayment amount in Naira (string)
client_request_idYesUnique idempotency key

HTTP 200 — pending:

{
  "status": "pending",
  "response_code": "02",
  "response_message": "Pending",
  "data": {
    "internal_reference": "019262ab-7c4d-7000-8000-000000000010",
    "msisdn": "45012345678",
    "product": "ELECTRICITY",
    "request_id": "breeze-electricity-001",
    "network": "IKEDC",
    "amount": "5000",
    "plan": "1001",
    "merchant_id": 10
  }
}

3. Check status

GET /ext/breeze/v1/transactions/status/{client_request_id}

Successful prepaid electricity may include token and units in data. See Transactions — Check status.

Ask your account manager to enable electricity on your merchant profile before go-live.

Last updated on
TransactionsCable TV