MobileNig API

Developers can use the following APIs to connect to MobileNig from their applications. NO ACTIVATION FEE REQUIRED!

BALANCE CHECK API

Command:

https://mobilenig.com/api/balance.php/?username=****&password=****

Replace **** with your username and password. E.g. https://mobilenig.com/api/balance.php/?username=PAUL&password=1234 where username is PAUL and password is 1234.
Response:
Invalid User: Username and Password incorrect

DATA API

Command:

https://mobilenig.com/api/data.php/?username=****&password=****&network=****&phoneNumber=***&amount=****&ref=12345&return_url=****

Parameters:
username: Use your MobileNig Username
password: Your MobileNig account password
network: MTN, 9MOBILE, GLO or AIRTEL (UPPERCASE)
phoneNumber: The beneficiary (080*** format)
amount: Use the price of the data plan e.g. 250 for Etisalat 250mb
ref: Give us your preferred reference number
return_url: Provide the url for order status.
Api Example: https://mobilenig.com/api/data.php/?username=PAUL&password=1234&network=9MOBILE&phoneNumber=08142290649&amount=250&ref=11225588&return_url=https://subnig.com/order_response.php
Response:
00 = Success
01 = Unsuccessful
02 = Incomplete Parameters
03 = Insufficient Balance
04 = Wrong Username or Password
05 = Invalid recipient
06 = Duplicate Order. Same network, dataplan and phone number had been ordered for in the last few minutes.
07 = Invalid Data Amount
08 = Invalid network
09 = Return Url empty
10 = Ref is empty

These parameters will be returned in the return_url:
status, beneficiary and ref
status: Can be Approved or Cancelled
beneficiary: The phone number you ordered the data plan for
ref: The reference number you provided.

AIRTIME VTU API

Command:

https://mobilenig.com/api/airtime.php/?username=****&password=****&network=****&phoneNumber=****&amount=****

Parameters:
username: Use your MobileNig Username
password: Your MobileNig account password
network: MTN, 9MOBILE, GLO or AIRTEL (UPPERCASE)
phoneNumber: The beneficiary (080*** format)
amount: airtime amount (50 - 50000)
Api Example: https://mobilenig.com/api/airtime.php/?username=PAUL&password=1234&network=MTN&phoneNumber=08011223344&amount=200

Response:
00 = Success
01 = Unsuccessful
02 = Incomplete Parameters
03 = Insufficient Balance
04 = Wrong Username or Password.

BILLS API

A customer must be validated before processing subscription. This will return the account status and associated information such as the customer’s name, account number, invoice period and due date.

Request can be made using the smart card number.

Command:
https://mobilenig.com/api/user_check.php/?username=****&password=****&service=****&number=****

Parameters:
username: Use your MobileNig Username
password: Your MobileNig account password
service: GOTV, DSTV or STARTIMES (UPPERCASE)
number: Decoder or Smart Number

You can use this smart number 1004748590 for testing on DSTV and GOTV. Use 02110144711 for testing on STARTIMES

GOTV or DSTV JSON return format:
Array ( [details] => Array ( [accountStatus] => SUSPENDED [firstName] => F [lastName] => IGBENI [customerType] => SUD [invoicePeriod] => 1 [dueDate] => 2001-01-01T00:00:00+01:00 [customerNumber] => 259758691 ) )

STARTIMES JSON return format:
Array ( [details] => Array ( [returnCode] => 0 [customerType] => 1 [billAmount] => 0 [balance] => 74.3 [returnMessage] => Success [smartCardNumber] => 02110144711 [customerNumber] => [customerName] => fatai ) )

PROCESSING SUBSCRIPTION

Command:

https://mobilenig.com/api/bills_process.php/?username=****&password=****&service=GOTV&smartno=1011992299&package=1&phone_number=08099112233

NOTE: For testing purpose, you can use bills_process_test.php instead. By this, the url will become
https://mobilenig.com/api/bills_process_test.php/?username=****&password=****&service=GOTV&smartno=1011992299&package=1&phone_number=08099112233

PARAMETERS: Username, Password, Service, Smartno, Price, Phone_number

Parameters:
username: Use your MobileNig Username
password: Your MobileNig account password
service: GOTV, DSTV or STARTIMES
smartno: The decoder number
phone_number: Customer's Phone Number
Package:



Response:
00 = Success
01 = Unsuccessful
02 = Incomplete Parameters
03 = Insufficient Balance
04 = Wrong Username or Password.
05 = Invalid Customer

Thanks for choosing MobileNig.