https://subandgain.com/api/verify_bills.php?username=****&apiKey=****&service=****&smartNumber=****
//Replace **** with your username, api key...
E.g.
https://subandgain.com/api/verify_bills.php?username=Peter&apiKey=sag8rqpfa8vkpn1ler56ygh8kxxw1aor8&service=GOTV&smartNumber=7035232726
//where username is Peter, apiKey is sag8rqpfa8vkpn1ler56ygh8kxxw1aor8, service is GOTV, smartNumber is 7035232726
JSON Format:
{"status":"success","customerName":" CANW10 LAWAL KAMALDEEN","smartNumber":"7035232726"}
Else, if there is an error in your request, the response will be displayed in this format:
{"error":"ERR210","description":"Invalid Customer"}
Parameter_Name | Description |
---|---|
username | Your SubAndGain username |
apiKey | Your SubAndGain API Key |
service | DSTV, GOTV or STARTIMES (UPPERCASE) |
bills_code | bills code, click Here to see |
smartNumber | Decoder, IUC or smartcard number |
https://subandgain.com/api/bills.php?username=****&apiKey=****&service=****&bills_code=****&smartNumber=****
//Replace **** with your username, api key...
E.g.
https://subandgain.com/api/bills.php?username=Peter&apiKey=sag8rqpfa8vkpn1ler56ygh8kxxw1aor8&service=GOTV&bills_code=gotv-jinja&smartNumber=7035232726
//where username is Peter, apiKey is sag8rqpfa8vkpn1ler56ygh8kxxw1aor8, service is GOTV, bills_code is gotv-jinja, smartNumber is 7035232726
JSON Format:
{"status":"Approved","trans_id":"88c4r5one73","service":"GOTV","package":"GOtv Jinja","smartNumber":"7035232726","amount":"1720","balance":"2500"}
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
Error | Description |
---|---|
ERR200 | Username Field Is Empty |
ERR201 | Invalid Username or Api Key |
ERR202 | Invalid IUC / Smartcard Number |
ERR203 | Insufficient Balance |
ERR204 | Invalid Service |
ERR206 | Order Not Processed |
ERR207 | Bills code does not tally with service |
https://subandgain.com/api/query_bills.php?username=****&apiKey=****&trans_id=****
//Replace **** with your username, api key...
E.g.
https://subandgain.com/api/query_bills.php?username=Peter&apiKey=sag8rqpfa8vkpn1ler56ygh8kxxw1aor8&trans_id=88c4r5one73
//where username is Peter, apiKey is sag8rqpfa8vkpn1ler56ygh8kxxw1aor8, trans_id is 88c4r5one73
JSON Format:
{"status":"Approved","trans_id":"88c4r5one73","package":"GOtv Jinja","smartNumber":"7035232726","amount":"1720"}
Else, if there is an error in your request, response will be displayed in this format:
{"error":"ERR210","description":"Transaction not found on SubAndGain"}
Bills code | Package |
---|---|
dstv-padi | Dstv Padi |
dstv-yanga | DSTV Yanga Bouquet |
dstv-confam | DSTV Confam Bouquet |
dstv6 | Dstv Asia |
dstv79 | Dstv Compact |
dstv7 | Dstv Compact Plus |
dstv3 | Dstv Premium |
dstv10 | Dstv Premium Asia |
Bills code | Package |
---|---|
gotv-jinja | Gotv Jinja |
gotv-jolli | Gotv Jolli |
gotv-max | Gotv Max |
gotv-smallie | Gotv Smallie Monthly |
gotv-smallie-3months | Gotv Smallie Quarterly |
gotv-smallie-1year | Gotv Smallie Yearly |
gotv-supa | GOtv Supa (Monthly) |
gotv-supa-plus | GOtv Supa Plus (Monthly) |
Bills code | Package |
---|---|
nova | Startimes Nova |
basic | Startimes Basic |
smart | Startimes Smart |
classic | Startimes Classic |
super | Startimes Super |
nova-weekly | StarTimes Nova (Weekly) |
basic-weekly | StarTimes Basic (Weekly) |
smart-weekly | StarTimes Smart (Weekly) |
classic-weekly | StarTimes Classic (Weekly) |
super-weekly | StarTimes Super (Weekly) |
nova-daily | StarTimes Nova (Daily) |
basic-daily | StarTimes Basic (Daily) |
smart-daily | StarTimes Smart (Daily) |
classic-daily | StarTimes Classic (Daily) |
super-daily | StarTimes Super (Daily) |