Smile Recharge :: API

Smile Recharge

User Validation:

A customer must be validated before processing subscription. This will return the customer’s name. 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: SMILE_RECHARGE, number: Decoder or Smart Number.

You can use this smart number 1402000567 for testing on SMILE_RECHARGE
SMILE_RECHARGE JSON return format:
{"details":{"firstName":"Sunday","lastName":"Ojo","middleName":""}}

Parameters:

Parameter_Name Type Description
username String Your MobileNig username
api_key String The api_key generated on MobileNig
smartno Number Your 10 digits smile device account number e.g 1402000567
amount Number The amount you wish to recharge e.g 1000
trans_id Number Unique transaction id e.g 128233240003

Command:

https://mobilenig.com/API/bills/smile_recharge.php?username=****&api_key=****&smartno=****&amount=****&trans_id=****
//Replace **** with your username, api_key...

For Api test use https://mobilenig.com/API/bills/smile_recharge_test.php?username=****&api_key=****&smartno=1402000567&amount=4000&trans_id=128233240003
Api Example: https://mobilenig.com/API/bills/smile_recharge?username=PAUL&api_key=64125agshaii168sdhd4b6bdb5&smartno=1402000567&amount=4000&trans_id=128233240003
//where username is PAUL and api_key is 64125agshaii168sdhd4b6bdb5, smartno is 1402000567, amount is 4000 and trans_id is 128233240003.

Response:
If successful: A response will be desplayed in JSON format e.g {"trans_id":"1224000223","details":{"service":"SMILE_RECHARGE","package":"#4000 smile recharge","smartno":"1402000567","amount":"4000","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

Query:

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

Response:
If successful: A response will be desplayed in JSON format e.g {"trans_id":"1283240003","details":{"service":"SMILE_RECHARGE","package":"#4000 smile recharge","smartno":"1402000567","amount":"4000","status":"SUCCESSFUL"}}
Else, response will be displayed in this format {"code": "ERR204", "description": "Could't find transaction on MobileNig"}