Buy airtime for a phone number on any supported Nigerian network. Discover the networks with
fetch-providers rather than hardcoding them — the list changes without an API version bump.
Get Airtime Networks
Signature required: No
Request example
Response
Use code as the network value when you purchase.
Buy Airtime
Signature required: Yes
Body
validationCode and transactionPin are not used on this channel. The API key plus the request
signature authorise a server-to-server purchase; there is no session to send a code to. Both remain in
force on the merchant dashboard, which is a different channel.
Request example
Response
Checking the outcome
A purchase can settle after the response returns. Poll
GET /business/vas/status with your reference, or handle the
VAS_NOTIFICATION webhook — do not treat the absence of an error as proof the top-up landed.
Fees
Airtime carries a per-transaction fee on your account. Read the charge from the transaction record
rather than assuming a rate; pricing is per merchant.