← Slimpay.ng

Used by every "Try It" panel across these docs to call app.slimpay.ng for real. Get one from Authentication — register or log in, then paste the token here. Stored only in this browser (localStorage), never sent anywhere but the Slimpay API, and auto-cleared after 8 hours.

Bills & Utilities

Electricity

Covers AEDC, EKEDC, IKEDC, PHEDC, and other Nigerian discos. Always validate the meter before buying — it confirms the meter number is real and returns the customer name on file, so you can show it for confirmation.

List discos

GET /bills/electricity Requires Auth
bash 
curl https://app.slimpay.ng/api/v1/bills/electricity \
  -H "Authorization: Bearer {token}"
GET /bills/electricity

Validate a meter

POST /bills/electricity/validate Requires Auth
bash 
curl https://app.slimpay.ng/api/v1/bills/electricity/validate \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "disco": "AEDC",
    "meter_number": "04123456789",
    "vend_type": "PREPAID"
  }'
POST /bills/electricity/validate
json 
{
  "status": true,
  "data": { "customer_name": "OBINNA JOHN SAMUEL", "address": "12 Aso Drive, Abuja" }
}

Buy a token

POST /bills/electricity Requires Auth
bash 
curl https://app.slimpay.ng/api/v1/bills/electricity \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "disco": "AEDC",
    "meter_number": "04123456789",
    "vend_type": "PREPAID",
    "amount": 20000,
    "phone_number": "08012345678",
    "transaction_pin": "1234"
  }'
POST /bills/electricity
json 
{
  "status": true,
  "message": "Electricity token purchased successfully.",
  "data": {
    "token": "1234-5678-9012-3456-7890",
    "units_kwh": "142.5",
    "amount": 20000,
    "new_balance": "64200.00"
  }
}

To let users save a meter for one-tap repeat purchases instead of re-entering it every time, see Virtual Meters.

← Previous
Airtime & Data
Next →
Cable TV