Electricity Bill Payment API

Pay electricity bills for Nigerian distribution companies (discos) programmatically. You verify the meter holder, pay a variable amount in kobo, and for prepaid meters the recharge token comes straight back in the response.

Electricity is the bill type where correctness matters most: you verify the meter number first to confirm the customer, which lets them catch a wrong number before any money moves.

Payments are idempotent on your clientReference and settle or refund automatically, so a timeout never charges a customer twice for power.

The API call

One authenticated POST /api/v1/electricity request, idempotent on your clientReference, with all money in integer kobo:

# 1) verify the meter, then 2) pay
curl -X POST https://api.plustiveimpact.com/api/v1/electricity \
  -H "Authorization: Bearer pk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "productId": "ikedc-prepaid", "meterNumber": "04123456789",
        "amount": 500000, "clientReference": "pow_4001" }'
  # amount 500000 = ₦5,000.00

→ { "status": "Success", "token": "1234-5678-9012-3456" }

What you get

• Prepaid and postpaid meters across the major discos.
• Verify the meter holder before paying (returns the customer name).
• Variable amount in kobo (minimum ₦100); prepaid token returned in the response.
• Idempotent, auto-reconciled, and auto-refunded on failure.