Startimes :: API

Startimes

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.net/API/bills/user_check?username=****&api_key=****&service=****&number=****
//where username: Use your MobileNig Username, api_key: Your api_key, service: STARTIMES, number: Decoder or Smart Number.

You can use this smart number 02027336692 for testing on STARTIMES
STARTIMES JSON return format:
{"details":{"returnCode":"0","customerType":1,"billAmount":0.0,"balance":63.82,"returnMessage":"Success","smartCardNumber":"02027336692","customerNumber":null,"customerName":"Danny"}}

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 02027336692
product_code String The product code of the selected plan, see plans here
customer_name String Customer name gotten from user validation
price Number The price of the selected plan
trans_id Number Unique transaction id e.g 12823329003

Command:

https://mobilenig.net/API/bills/startimes?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.net/API/bills/startimes_test?username=****&api_key=****&smartno=02027336692&product_code=GOLITE&customer_name=Danny&price=900&trans_id=122790223
Api Example: https://mobilenig.net/API/bills/startimes?username=PAUL&api_key=64125agshaii168sdhd4b6bdb5&smartno=02027336692&product_code=GOLITE&customer_name=Danny&price=900&trans_id=12823329003
//where username is PAUL and api_key is 64125agshaii168sdhd4b6bdb5, smartno is 02027336692, product_code is GOLITE, customer_name is Danny, price is 900 and trans_id is 12823329003.

Response:
If successful: A response will be desplayed in JSON format e.g {"trans_id":"122900223","details":{"service":"STARTIMES","package":"Startimes Mobile MAXI","smartno":"02027336692","price":"900","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

Query:

https://mobilenig.net/API/startimes_query?username=****&api_key=****&trans_id=****
//Replace **** with your username, api_key...
Api Example: https://mobilenig.net/API/startimes_query?username=PAUL&api_key=64125agshaii168sdhd4b6bdb5trans_id=12823329003
//where username is PAUL and api_key is 64125agshaii168sdhd4b6bdb5, trans_id is 12823329003.

Response:
If successful: A response will be desplayed in JSON format e.g {"trans_id":"128329003","details":{"service":"STARTIMES","package":"Startimes Mobile MAXI","smartno":"02027336692","price":"900","status":"SUCCESSFUL"}}
Else, response will be displayed in this format {"code": "ERR204", "description": "Could't find transaction on MobileNig"}

Packages:

Package Product Code Price
StarTimes Nova STARN 900
StarTimes Basic STARB 1300
StarTimes Smart STARS 1900
StarTimes Classic STARC 2600
StarTimes Unique STARU 3800