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
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 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 |
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
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://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
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"}
| 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) |
| 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) |