Skip to main content
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

Headers

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.