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 | Plan |
---|---|
dstv-padi | DSTV Padi |
dstv-yanga | DSTV Yanga Bouquet |
dstv-confam | DSTV Confam Bouquet |
dstv79 | DSTV Compact |
dstv7 | DSTV Compact Plus |
dstv3 | DSTV Premium |
Bills code | Plan |
---|---|
gotv-max | GOtv Max |
gotv-jolli | GOtv Jolli |
gotv-jinja | GOtv Jinja |
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) |
ng_gotv_gotvopn | GOTV Open |
Bills code | Plan |
---|---|
super | StarTimes Super |
classic | StarTimes Classic |
smart | StarTimes Smart(Basic) |
basic | StarTimes Basic |
nova | StarTimes Nova |
nova-weekly | StarTimes Nova (Weekly) |
basic-weekly | StarTimes Basic (Weekly) |
smart-weekly | StarTimes Smart(Basic)-Weekly |
classic-weekly | StarTimes Classic (Weekly) |
super-weekly | StarTimes Super (Weekly) |
uni-1 | StarTimes Chinese (Dish) |
You can use the link below to get the all cable TV bundles and prices in JSON format
https://subandgain.com/api/cablebundles.php