Ikeja Token

Ikeja Token :: API

Ikeja Electric Token Purchase

User Validation:

A customer must be validated before processing subscription. This will return the account status and associated information such as the address, minimumAmount, canVend, name, meterNumber, customerAccountType and customerDtNumber. 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: IKEJA_TOKEN, number: Customer number.

You can use this meter number 04042404048 for testing on IKEJA_TOKEN

IKEJA_TOKEN JSON return format:
{"details":{"canVend":true,"address":"ABULE - EGBA BU ABULE","meterNumber":"04042404048","name":"TESTMETER1","minimumAmount":0,"customerDtNumber":"007903312"}}

Parameters:

Parameter_Name	Type	Description
username	String	Your MobileNig username
api_key	String	The api_key generated on MobileNig
meterNumber	Number	The meter number e.g 2005129242
phoneNumber	Number	Customer's phone number
email	String	Customer's email
customerName	String	Customer's name gotten from user validation
customerAddress	String	Customer's address gotten from user validation
customerAccountType	String	customerAccountType gotten from user validation
customerDtNumber	Number	Customer's DtNumber gotten from user validation
amount	Number	Amount of electricity bills e.g 2000
trans_id	Number	Unique transaction id e.g 12823327903

Command:

https://mobilenig.com/API/bills/ikeja_token?username=****&api_key=****&meterNumber=****&phoneNumber=****&email=****&customerName=****&customerAddress=****&customerAccountType=****&customerDtNumber=****&amount=****&trans_id=****

//Replace **** with your username, api_key...

For Api test use https://mobilenig.com/API/bills/ikeja_token_test?username=****&api_key=****[email protected]ail.com&customerName=TESTMETER1&customerAddress=ABULE - EGBA BU ABULE&customerAccountType=PRIME&customerDtNumber=007903312&amount=2000&trans_id=157636277382
Api Example: https://mobilenig.com/API/bills/ikeja_token?username=PAUL&api_key=64125agshaii168sdhd4b6bd[email protected]gmail.com&customerName=TESTMETER1&customerAddress=ABULE - EGBA BU ABULE&customerAccountType=PRIME&customerDtNumber=007903312&amount=2000&trans_id=157636277382

//where username is PAUL and api_key is 64125agshaii168sdhd4b6bdb5, meterNumber is 04042404048, phoneNumber is 08093000000, email is [email protected], customerName is TESTMETER1, customerAddress is ABULE - EGBA BU ABULE, customerAccountType is PRIME, customerDtNumber is 007903312, and trans_id is 157636277382.

Response:
If successful: A response will be desplayed in JSON format e.g {"trans_id":"13311522727447382","details":{"service":"IKEJA_TOKEN","package":"#100 Ikeja Electric Token Purchase","tokenAmount":"2000","creditToken":"97687698878407820677","tariff":"StubTariff","utilityName":"Eskom","taxAmount":"","amountOfPower":"100 kWh","amount":"2000","status":"SUCCESSFUL","balance":"6943"}}
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/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":"123311522727447382","details":{"service":"IKEJA_TOKEN","package":"#100 Ikeja Electric Token Purchase","tokenAmount":"100","creditToken":"02459177415780983545","tariff":"StubTariff","utilityName":"Eskom","taxAmount":"","amountOfPower":"100 kWh","amount":"100","status":"SUCCESSFUL"}}
Else, response will be displayed in this format {"code": "ERR204", "description": "Could't find transaction on MobileNig"}