API - Airtime

Parameters:
Parameter_Name Description
username Your Subremit username
apiKey Your Subremit API Key
network MTN, GLO, AIRTEL or 9MOBILE (UPPERCASE)
phoneNumber recipient number
amount airtime amount

API Command:


https://subremit.com/api/airtime.php?username=****&apiKey=****&network=****&phoneNumber=****&amount=****
//Replace **** with your username, api key...

E.g.
https://subremit.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://subremit.com/api/query_airtime.php?username=****&apiKey=****&trans_id=****
//Replace **** with your username, api key...

E.g.
https://subremit.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 Subremit"}