⚡ Electricity API
Buy electricity tokens (prepaid) or pay postpaid bills for all Nigerian electricity distribution companies (DisCos). Get instant tokens delivered via API response and webhooks.
🔌 Quick Overview
POST
/devapi/v1/electricity
Instant Tokens
Get electricity tokens in seconds
All DisCos
12 distribution companies supported
Prepaid & Postpaid
Both meter types supported
⚠️ Important: Verify Meter First!
Always Verify Before Purchase
Electricity transactions are non-reversible. Always verify the meter number
using the Verify Customer endpoint before making a purchase.
cURL - Verify Meter First
curl -X POST "https://iacafe.com.ng/devapi/v1/verify-customer" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"customer_id": "12345678901",
"service_id": "ikeja-electric",
"variation_id": "prepaid"
}'
📋 Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
request_id |
string | Yes | Your unique transaction ID |
customer_id |
string | Yes | Meter number |
service_id |
string | Yes | DisCo identifier (see table below) |
variation_id |
string | Yes | prepaid or postpaid |
amount |
number | Yes | Amount in Naira (minimum ₦100) |
🏢 Available Distribution Companies
| DisCo | service_id | Coverage Area |
|---|---|---|
| Ikeja Electric (IKEDC) | ikeja-electric | Lagos (Ikeja axis) |
| Eko Electric (EKEDC) | eko-electric | Lagos (Eko axis) |
| Abuja Electric (AEDC) | abuja-electric | Abuja, Niger, Kogi, Nasarawa |
| Kano Electric (KEDCO) | kano-electric | Kano, Jigawa, Katsina |
| Port Harcourt (PHED) | portharcourt-electric | Rivers, Bayelsa, Cross River, Akwa Ibom |
| Ibadan Electric (IBEDC) | ibadan-electric | Oyo, Ogun, Osun, Kwara |
| Kaduna Electric (KAEDCO) | kaduna-electric | Kaduna, Sokoto, Kebbi, Zamfara |
| Jos Electric (JED) | jos-electric | Plateau, Bauchi, Benue, Gombe |
| Enugu Electric (EEDC) | enugu-electric | Enugu, Anambra, Imo, Abia, Ebonyi |
| Benin Electric (BEDC) | benin-electric | Edo, Delta, Ondo, Ekiti |
| Aba Electric (ABA) | aba-electric | Aba, Abia State |
| Yola Electric (YEDC) | yola-electric | Adamawa, Taraba, Borno, Yobe |
💻 Code Example
cURL - Buy Electricity
curl -X POST "https://iacafe.com.ng/devapi/v1/electricity" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"request_id": "elec_ikeja_1704067200_abc123",
"customer_id": "12345678901",
"service_id": "ikeja-electric",
"variation_id": "prepaid",
"amount": 5000
}'
📤 Response Examples
200 OK Success Response (with Token)
Completed Order
{
"code": "success",
"message": "ORDER COMPLETED",
"data": {
"product_name": "Electricity",
"service_name": "Ikeja (IKEDC)",
"status": "completed-api",
"order_id": 12345,
"customer_id": "12345678901",
"customer_name": "JOHN DOE",
"customer_address": "123 Lagos Street, Ikeja",
// ⚡ THE ELECTRICITY TOKEN!
"token": "1234 5678 9012 3456 7890",
"units": "45.12 kWh",
"band": "A",
"amount": 5000,
"discount": "75.00",
"amount_charged": "4925.00",
"request_id": "elec_ikeja_1704067200_abc123"
}
}
Important Fields
token - The electricity token to enter into the meter
units - The amount of electricity units purchased
band - The tariff band (A, B, C, D, E)
units - The amount of electricity units purchased
band - The tariff band (A, B, C, D, E)