Skip to main content
POST
Purchase electricity token/payout
Purchases prepaid/postpaid electricity token for a verified meter.

Environment Notes

  • Production key -> uses the live business NGN wallet balance and runs the live purchase flow.
  • Test key -> uses the sandbox business NGN wallet balance and completes without vending real electricity.

Authorizations

x-api-key
string
header
required

Merchant API Key (e.g., nexa-prod-... or nexa-test-...)

Headers

x-business-env
enum<string>
default:prod

Target environment selector (live production vs. simulated sandbox).

Available options:
prod,
test

Body

application/json
electricity
string
required

The disco code (e.g. ikeja-electric).

amount
number
required
meterNumber
string
required
type
enum<string>
required
Available options:
prepaid,
postpaid
businessId
string

Response

202

Transaction initiated.