Sign in

v7

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-31249122.2 KB
VAS

Buy electricity token

Vend prepaid electricity units or pay a postpaid bill.

post/api/v1/electricity/buy

Request body

meterNumberstring required
billerCodestring required

Biller code from GET /api/v1/products (e.g. EKEDC) or display name (e.g. Eko Electricity).

meterType'prepaid' | 'postpaid' required
amountnumber required
customerNamestring required
addressstring required
customerRefstring

Example request

{
  "meterNumber": "45012345678",
  "billerCode": "EKEDC",
  "meterType": "prepaid",
  "amount": 2000,
  "customerName": "Jane Doe",
  "address": "12 Lekki Phase 1, Lagos",
  "customerRef": "ELEC-REF-001"
}

Response

OK