Skip to main content
POST
Airtime to Cash

Authorizations

Authorization
string
header
required

Send your API key as Token <your_api_key>.

Use your live key for real transactions, or your sandbox key (sk_test_…) to test — sandbox calls return a realistic simulated result and never touch your wallet. Add "sandbox_status": "fail" to any sandbox request to simulate a failure.

Body

application/json
step
enum<integer>
required
Available options:
1,
2,
3
Example:

1

network
integer
required

Network plan ID (MTN or Airtel only).

Example:

1

phone
string
required
Example:

"2347013397088"

otp
string

Step 2 — OTP received from the network.

Example:

"123456"

data
string

Steps 2 & 3 — verification token returned by the previous step.

share_pin
string

Step 3 — your 4-digit network Share-and-Sell PIN.

Example:

"1234"

amount
number

Step 3 — airtime amount to convert.

Example:

1000

Response

200 - application/json

Result