API - Airtime
Parameters:
| Parameter_Name | Description |
|---|---|
| username | Your SubAndGain username |
| apiKey | Your SubAndGain API Key |
| network | MTN, GLO, AIRTEL or 9MOBILE (UPPERCASE) |
| phoneNumber | recipient number |
| amount | airtime amount |
API Command:
https://subandgain.com/api/airtime.php?username=****&apiKey=****&network=****&phoneNumber=****&amount=****
//Replace **** with your username, api key...
E.g.
https://subandgain.com/api/airtime.php?username=Peter&apiKey=sag8rqpfa8vkpn1ler56ygh8kxxw1aor8&network=MTN&phoneNumber=09067879810&amount=300
//where username is Peter, apiKey is sag8rqpfa8vkpn1ler56ygh8kxxw1aor8, network is MTN, phoneNumber is 09067879810, amount = 300,
Response:
JSON Format:
{"status":"pending","trans_id":"6389736270","network":"MTN","phoneNumber":"09067879810","amount":"300","balance":"3000"}
Else, if there is an error in your request, one of the responses below will be displayed in this format:
{"error":"ERR201","description":"Invalid Username or Api Key"}
status can be - Pending, Approved or Cancelled
Responses:
| Error | Description |
|---|---|
| ERR200 | Username Field Is Empty |
| ERR201 | Invalid Username or Api Key |
| ERR202 | Invalid Recipient number |
| ERR203 | Insufficient Balance |
| ERR204 | Invalid Network |
| ERR205 | Less Than Minimum Amount |
| ERR206 | Order Not Processed |
API Query:
https://subandgain.com/api/query_airtime.php?username=****&apiKey=****&trans_id=****
//Replace **** with your username, api key...
E.g.
https://subandgain.com/api/query_airtime.php?username=Peter&apiKey=sag8rqpfa8vkpn1ler56ygh8kxxw1aor8&trans_id=6389736270
//where username is Peter, apiKey is sag8rqpfa8vkpn1ler56ygh8kxxw1aor8, trans_id is 6389736270
Response:
JSON Format:
{"status":"Approved","trans_id":"6389736270","network":"MTN","phoneNumber":"09067879810","amount":"300"}
Else, if there is an error in your request, response will be displayed in this format:
{"error":"ERR210","description":"Transaction not found on SubAndGain"}