Ikeja :: API

Ikeja Electric Bill Payment

User Validation:

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

You can use this customer number 04042404139 for testing on IKEJA
IKEJA JSON return format:
{"details":{"address":"6 ABIODUN ODESEYE Shomolu BU","outstandingAmount":31829,"name":"NP NGEMA","minimumAmount":250,"accountNumber":"04042404139","customerDtNumber":"007903312"}}

Parameters:

Parameter_Name Type Description
username String Your MobileNig username
api_key String The api_key generated on MobileNig
accountNumber Number The customer 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?username=****&api_key=****&accountNumber=****&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_test?username=****&api_key=****[email protected]gmail.com&customerName=NP NGEMA&customerAddress=6 ABIODUN ODESEYE Shomolu BU&customerAccountType=PRIME&customerDtNumber=007903312&amount=2000&trans_id=157636277382
Api Example: https://mobilenig.com/API/bills/ikeja?username=PAUL&api_key=64125agshaii168sdhd4b6bdb5[email protected]gmail.com&customerName=NP NGEMA&customerAddress=6 ABIODUN ODESEYE Shomolu BU&customerAccountType=PRIME&customerDtNumber=007903312&amount=2000&trans_id=157636277382
//where username is PAUL and api_key is 64125agshaii168sdhd4b6bdb5, accountNumber is 04042404139, phoneNumber is 08093000000, email is [email protected], customerName is NP NGEMA, customerAddress is 6 ABIODUN ODESEYE Shomolu BU, 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":"157636277382","details":{"service":"IKEJA","package":"#2000 Ikeja Electric Bill Payment","customerName":"NP NGEMA","accountNumber":"04042404139","utilityName":"Eskom","amount":"2000","status":"SUCCESSFUL","balance":"9048"}}
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/ikeja_query?username=****&api_key=****&trans_id=****
//Replace **** with your username, api_key...
Api Example: https://mobilenig.com/API/ikeja_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":"157636277382","details":{"service":"IKEJA","package":"#2000 Ikeja Electric Bill Payment","accountNumber":"04042404139","amount":"2000","status":"SUCCESSFUL"}}
Else, response will be displayed in this format {"code": "ERR204", "description": "Could't find transaction on MobileNig"}