3. Buy the airtime or data

Tops up a phone with airtime or data from your business balance. There’s no callback: decide on responseCode, and check the transaction status if you need to.

Hash: referenceNumber + amount + destinationPhoneNumber + hashKey

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required
Defaults to AIR-2026-0042

Your unique reference. Hash value 1.

string
required
Defaults to 500

Airtime value, or exactly the bundle’s servicePrice for data. Hash value 2.

string
required
Defaults to 08063332187

Hash value 3.

string
required
Defaults to 42419156-DD57-4737-8373-20678CD9AA29

The network’s mobileOperatorCode.

string
Defaults to NGN
boolean
Defaults to false
string

Data only. The bundle’s serviceId.

boolean
Defaults to false
Headers
string
required
^[0-9a-f]{128}$
Defaults to 27d47579f91402341e76b39d4d5c35393e652ea04c0910424f2b55d135dc66cb4b3873c21912d9384b1ef3ebf7182dd4d3afd8e626e11b05846e8116a1972e1a

SHA-512 of this operation’s hash fields, in order, followed by your hash key, as lowercase hex. See the code samples, or check your value with the Hash generator. Pre-filled with the hash of this step’s example values using the placeholder key YOUR_HASH_KEY, so it shows the right format. Replace it with the hash of your own values and your own hash key.

Response

Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json