Skip to main content
POST
Pay Electricity Bill
disco is the numeric ID returned by List DISCOs. Always Verify Meter first. amount is in Naira. Pass your own request-id to make the purchase idempotent and to track it later via Requery.

Authorizations

Authorization
string
header
required

Send your API key as Token <your_api_key>.

Use your live key for real transactions, or your sandbox key (sk_test_…) to test — sandbox calls return a realistic simulated result and never touch your wallet. Add "sandbox_status": "fail" to any sandbox request to simulate a failure.

Body

application/json
disco
integer
required

Disco plan_id (from GET /api/discos)

Example:

1

meter_type
enum<string>
required
Available options:
prepaid,
postpaid
Example:

"prepaid"

meter_number
string
required
Example:

"12345678901"

amount
integer
required

Amount in Naira

Example:

1000

request-id
string

Your unique reference (idempotency key). Reuse with GET /api/requery/{reference}. Optional - one is generated if omitted.

Example:

"Bill_12345678900"

Response

200 - application/json

Result