Dstv
User Validation:
A customer must be validated before processing subscription. This will return the account status and associated information such as the customer’s name, customer's number, invoice period and due date.
Request can be made using the smart card number.
Command:
https://mobilenig.com/API/bills/user_check?username=****&api_key=****&service=****&number=****
//where username: Use your MobileNig Username, api_key: Your api_key, service: DSTV, number: Decoder or Smart Number.
You can use this smart number 4131953321 for testing on DSTV
DSTV JSON return format:
{"details":{"accountStatus":"OPEN","firstName":"ESU","lastName":"INI OBONG BASSEY","customerType":"SUD","invoicePeriod":1,"dueDate":"2018-11-13T00:00:00+01:00","customerNumber":275953782}}
Get Renewal Details:
This will return renewal amount and due date.
Command:
https://mobilenig.com/API/bills/get_renewal_details?username=****&api_key=****&service=****&customerNumber=****
//where username: Use your MobileNig Username, api_key: Your api_key, service: DSTV, customerNumber: customer number gotten from user validation.
You can use this customer number 275953782 for testing on DSTV
DSTV JSON return format:
{"details":{"amount":2500, "dueDate":"2021-08-15T11:13:28.197+02:00"}}
Get Package:
This will return the name on client's current package.
Command:
https://mobilenig.com/API/bills/get_package?username=****&api_key=****&service=****&customerNumber=****
//where username: Use your MobileNig Username, api_key: Your api_key, service: DSTV, customerNumber: customer number gotten from user validation.
You can use this customer number 275953782 for testing on DSTV
DSTV JSON return format:
{"packageName":"DStv French Touch Add-on Bouquet E36 + DStv Yanga Bouquet E36"}
Command:
RENEW SUBSCRIPTION
https://mobilenig.com/API/bills/dstv?username=****&api_key=****&smartno=****&customer_name=****&customer_number=****&price=****&trans_id=****
NOTE: Do not include product_code for renew subscription. Also, kindly refer to Get Renewal Details to get transaction price.
CHANGE SUBSCRIPTION
https://mobilenig.com/API/bills/dstv?username=****&api_key=****&smartno=****&product_code=****&customer_name=****&customer_number=****&price=****&trans_id=****
//Replace **** with your username, api_key...
For Api test use https://mobilenig.com/API/bills/dstv_test?username=****&api_key=****&smartno=4131953321&product_code=MOBMAXI&customer_name=E INI OBONG BASSE&customer_number=275953782&price=790&trans_id=12823327903
Api Example: https://mobilenig.com/API/bills/dstv?username=PAUL&api_key=64125agshaii168sdhd4b6bdb5&smartno=4131953321&product_code=MOBMAXI&customer_name=E INI OBONG BASSE&customer_number=275953782&price=790&trans_id=12823327903
//where username is PAUL and api_key is 64125agshaii168sdhd4b6bdb5, smartno is 4131953321, product_code is MOBMAXI, customer_name is E INI OBONG BASS, customer_number is 275953782, price is 790 and trans_id is 12823327903.
Response:
If successful: A response will be desplayed in JSON format e.g {"trans_id":"122790223","details":{"service":"DSTV","package":"DStv Mobile MAXI","smartno":"4131953321","price":"790","status":"SUCCESSFUL","balance":"7931"}}
Else, one of the responses below will be displayed in this format {"code": "ERR101", "description": "Invalid username or api_key"}
Query:
https://mobilenig.com/API/query?username=****&api_key=****&trans_id=****
//Replace **** with your username, api_key...
Api Example: https://mobilenig.com/API/query?username=PAUL&api_key=64125agshaii168sdhd4b6bdb5trans_id=12823327903
//where username is PAUL and api_key is 64125agshaii168sdhd4b6bdb5, trans_id is 12823327903.
Response:
If successful: A response will be desplayed in JSON format e.g {"trans_id":"128327903","details":{"service":"DSTV","package":"DStv Mobile MAXI","smartno":"4131953321","price":"786","status":"SUCCESSFUL"}}
Else, response will be displayed in this format {"code": "ERR204", "description": "Could't find transaction on MobileNig"}