Wallet

Airtime to Cash

Convert MTN/Airtel airtime to wallet cash via a 3-step Share-and-Sell flow (Tier 2+ KYC required).

  • Step 1 {step:1, network, phone} — start; an OTP is sent and a verification data token is returned.
  • Step 2 {step:2, network, phone, otp, data} — verify the OTP.
  • Step 3 {step:3, network, phone, data, share_pin, amount} — complete; your wallet is credited.
post/api/cash

Request

  • Base URL: https://api.mysubwallet.ng
  • URL: https://api.mysubwallet.ng/api/cash
  • Auth: API key in header Authorization

Request body

step1 | 2 | 3 required
networkinteger required

Network plan ID (MTN or Airtel only).

phonestring required
otpstring

Step 2 — OTP received from the network.

datastring

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

share_pinstring

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

amountnumber

Step 3 — airtime amount to convert.

Example request

{
  "step": 1,
  "network": 1,
  "phone": "2347013397088",
  "otp": "123456",
  "share_pin": "1234",
  "amount": 1000
}

Response

Result

Changes

No recorded changes to this operation across all 1 revision of this API.