Skip to main content
POST
Pay Electricity Bill

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