Dstv :: API

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

Parameters:

Parameter_Name Type Description
username String Your MobileNig username
api_key String The api_key generated on MobileNig
smartno Number The decoder smart card number e.g 4131953321
product_code String The product code of the selected plan, see plans here
customer_name String Customer name gotten from user validation
customer_number Number Customer number gotten from user validation
price Number The price of the selected plan
trans_id Number Unique transaction id e.g 12823327903

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

Responses:

Code Description
ERR101 Invalid username or api_key
ERR102 Api service is currently unavailable
ERR103 Requested service is currently unavailable
ERR104 User Suspended
ERR105 Transaction id already exist, kindly generate a unique id
ERR106 Insufficient Balance
ERR107 Transaction Unsuccessful
ERR202 Incomplete Parameters
ERR206 Duplicate transaction, same order details had been made few minutes ago
ERR208 Product code does not tally with price
ERR209 You are trying to recharge the current plan on the smartcard, kindly make PLAN RENEWAL request

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

Packages:

Package Product Code Price
DStv Padi NLTESE36 1850
DStv Yanga Bouquet E36 NNJ1E36 2565
DStv Confam Bouquet E36 NNJ2E36 4615
DStv Asian Bouquet ASIAE36 5540
DStv Compact COMPE36 7900
DStv Compact Plus COMPLE36 12400
DStv Premium French PRWFRNSE36 25550
DStv Premium PRWE36 18400
DStv Premium Asia PRWASIE36 20500
DStv Compact Plus + HDPVR/XtraView DCOHDPV 14900
DStv Compact Plus + Asian Add-on DCOMAS 18600
DStv Compact Plus + French Touch + HDPVR/XtraView DCOFRHD 17200
DStv Premium + HDPVR/XtraView DPRHDP 20900
DStv Premium + French Touch + HDPVR/XtraView DPRFRH 23200
DStv Premium + French Touch DPRFR 20700
DStv Premium Asia + HDPVR/XtraView DPRHD 23000
DStv Premium Asia + French Touch DPRHDF 22800
DStv Yanga Bouquet E36 + French Touch DYBFT 4865
DStv Yanga Bouquet E36 + HDPVR/XtraView DYBHX 5065
DStv Yanga Bouquet E36 + French Touch + HDPVR/XtraView DYBFTHX 7365
DStv Confam Bouquet E36 + French Touch DCBFT 6915
DStv Confam Bouquet E36 + HDPVR/XtraView DCBHX 7115
DStv Confam Bouquet E36 + French Touch + HDPVR/XtraView DCBFTHX 9415