Abuja Prepaid
User Validation:
A customer must be validated before processing subscription. This will return the account status and associated information such as the uniqueCode, minimumVend, responseMessage and customerName.
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: ABUJA_PREPAID, number: Customer Reference.
You can use this Customer Reference 1012345321 for testing on ABUJA_PREPAID
ABUJA_PREPAID JSON return format:
{"details":{"uniqueCode":"909221855233","minimumVend":250.00,"responseMessage":"Adewale Tompson","customerName":"Adewale Tompson","responseCode":"00"}}
Command:
https://mobilenig.com/API/bills/abuja_prepaid?username=****&api_key=****&customerReference=****&uniqueCode=****&amount=****&trans_id=****
//Replace **** with your username, api_key...
For Api test use https://mobilenig.com/API/bills/abuja_prepaid_test?username=****&api_key=****&customerReference=1012345321&uniqueCode=094876688757&amount=2000&trans_id=157636277382
Api Example: https://mobilenig.com/API/bills/abuja_prepaid?username=PAUL&api_key=64125agshaii168sdhd4b6bdb5&customerReference=1012345321&uniqueCode=094876688757&amount=2000&trans_id=157636277382
//where username is PAUL and api_key is 64125agshaii168sdhd4b6bdb5, customerReference is 1012345321, uniqueCode is 094876688757 and trans_id is 157636277382.
Response:
If successful: A response will be desplayed in JSON format e.g {"trans_id":"15761136277382","details":{"customerReference":"1012345321","meterNumber":"1012345321","tarifInstance":null,"units":"67Kwh","token":"7024-0941-5323-1368-5972","package":"#2000 Abuja Prepaid","amount":"2000","status":"SUCCESSFUL","balance":"14545"}}
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/bills/query?username=****&api_key=****&trans_id=****
//Replace **** with your username, api_key...
Api Example: https://mobilenig.com/API/bills/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":"15761136277382","details":{"customerReference":"1012345321","meterNumber":"1012345321","tarifInstance":null,"units":"67Kwh","token":"7024-0941-5323-1368-5972","package":"#2000 Abuja Prepaid","amount":"2000","status":"SUCCESSFUL"}}
Else, response will be displayed in this format {"code": "ERR204", "description": "Could't find transaction on MobileNig"}