Skip to main content
POST
Purchase mobile airtime
Purchases mobile network airtime for a customer.

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 airtime.

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
serviceID
string
required

The mobile network code (mtn, airtel, glo, etisalat).

amount
number
required
phone
string
required
businessId
string

Response

Airtime purchase transaction initiated/queued.