Pay an electricity bill

POST 
/api/v1/electricity

Vend electricity units for a meter. Electricity is variable-amount — pass amountKobo (minimum ₦100 = 10000 kobo). Idempotent via clientReference. The prepaid token is returned in the token field.

Request

Responses

200

Accepted.

401

Missing or invalid API key.

403

This service is not enabled for your account (e.g. airtime is disabled), or the plan is not in your catalog.

409

The clientReference was already used for a different order (a different plan, recipient, or amount). We reject the reuse instead of replaying the unrelated original — no purchase is made and your wallet is not debited. Use a unique clientReference per order; a genuine retry with the same parameters returns the original transaction (see Idempotency).

422

The request body failed validation, or your wallet has insufficient funds.