API - Cable TV

API Verify Customer:


https://subremit.com/api/verify_bills.php?username=****&apiKey=****&service=****&smartNumber=****
//Replace **** with your username, api key...

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


Response:


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"}


Parameters:
Parameter_Name Description
username Your Subremit username
apiKey Your Subremit API Key
service DSTV, GOTV or STARTIMES (UPPERCASE)
bills_code bills code, click Here to see
smartNumber Decoder, IUC or smartcard number

API Command:


https://subremit.com/api/bills.php?username=****&apiKey=****&service=****&bills_code=****&smartNumber=****
//Replace **** with your username, api key...

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


Response:


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


Responses:
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

API Query:


https://subremit.com/api/query_bills.php?username=****&apiKey=****&trans_id=****
//Replace **** with your username, api key...

E.g.
https://subremit.com/api/query_bills.php?username=Peter&apiKey=sag8rqpfa8vkpn1ler56ygh8kxxw1aor8&trans_id=88c4r5one73
//where username is Peter, apiKey is sag8rqpfa8vkpn1ler56ygh8kxxw1aor8, trans_id is 88c4r5one73



Response:


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 Subremit"}



DSTV:
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

GOTV:
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)

STARTIMES:
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)