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.net/api/balance.php/?username=****&password=****

Replace **** with your username and password. E.g. https://mobilenig.net/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.net/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.net/api/data.php/?username=PAUL&password=1234&network=9MOBILE&phoneNumber=08142290649&amount=250&ref=11225588&return_url=https://subnig.net/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.net/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.net/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

DSTV

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

Request can be made using the smart card number.

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

Parameters:
username: Use your MobileNig Username
password: Your MobileNig account password
service: DSTV
number: Decoder or Smart Number

You can use this smart number 4131953321 for testing on DSTV

DSTV JSON return format:
{"details":{"accountStatus":"OPEN","firstName":"ESU","lastName":"INI OBONG BASSEY","customerType":"SUD","invoicePeriod":1,"dueDate":"2018-11-13T00:00:00+01:00","customerNumber":275953782}}

PROCESSING SUBSCRIPTION

Command:

https://mobilenig.net/api/bills/dstv?username=****&password=****&smartno=****&product_code=****&customer_name=****&customer_number=****&ref=****&amount=****

NOTE: For testing purpose, you can use dstv_test instead. By this, the url will become
https://mobilenig.net/api/bills/dstv_test?username=****&password=****&smartno=4131953321&product_code=MOBMAXI&customer_name=E INI OBONG BASSE&customer_number=275953782&ref=11111&amount=790

PARAMETERS: Username, Password, smartno, product_code:, customer_name, customer_number, ref, amount

Parameters:
username: Use your MobileNig Username
password: Your MobileNig account password
smartno: The decoder number
product_code: Product code as shown in the table below
customer_name: Customer's name as shown in the request above
customer_number: Customer's number as shown in the request above
ref: Use a unique reference number
amount: amount as shown in the tabe below

Package

Package Product Code Amount
DStv Mobile MAXI MOBMAXI 790
DStv Mobile MAXI Plus (For Premium Only) MOMAXIP 990
DStv FTA Plus FTAE36 1600
DStv Access ACSSE36 2000
DStv Family COFAME36 4000
Asian Bouqet ASIAE36 4800
DStv Compact COMPE36 6800
DStv Compact Plus COMPLE36 10650
DStv Premium PRWE36 15800
PRWASIE36 PRWE36 15740

Response:
00 = Success
01 = Unsuccessful
02 = Incomplete Parameters
03 = Insufficient Balance
04 = Wrong Username or Password
05 = ref already exist, use a unique one
06 = Duplicate Order. Same smart card number and package had been ordered for in the last few minutes.
07 = Invalid amount
08 = Invalid product code


GOTV

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

Request can be made using the smart card number.

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

Parameters:
username: Use your MobileNig Username
password: Your MobileNig account password
service: GOTV
number: Decoder or Smart Number

You can use this smart number 2005129242 for testing on GOTV

GOTV JSON return format:
{"details":{"accountStatus":"OPEN","firstName":"KENNY","lastName":"AKINTIMEHIN","customerType":"GOTVSUD","invoicePeriod":1,
"dueDate":"2018-06-08T00:00:00+01:00","customerNumber":291631845}}

PROCESSING SUBSCRIPTION

Command:

https://mobilenig.net/api/bills/gotv?username=****&password=****&smartno=****&product_code=****&customer_name=****&customer_number=****&ref=****&amount=****

NOTE: For testing purpose, you can use gotv_test instead. By this, the url will become
https://mobilenig.net/api/bills/gotv_test?username=****&password=****&smartno=2005129242&product_code=GOTVPLS&customer_name=K AKINTIMEHIN&customer_number=291631845&ref=3221111&amount=1900

PARAMETERS: Username, Password, smartno, product_code:, customer_name, customer_number, ref, amount

Parameters:
username: Use your MobileNig Username
password: Your MobileNig account password
smartno: The decoder number
product_code: Product code as shown in the table below
customer_name: Customer's name as shown in the request above
customer_number: Customer's number as shown in the request above
ref: Use a unique reference number
amount: amount as shown in the tabe below

Package

Package Product Code Amount
GOtv LITE GOLITE 400
GOtv Mobile Access GOTVM 630
GOtv Value GOTV 1250
GOtv Plus GOTVPLS 1900
GOtv Max GOTVMAX 3200

Response:
00 = Success
01 = Unsuccessful
02 = Incomplete Parameters
03 = Insufficient Balance
04 = Wrong Username or Password
05 = ref already exist, use a unique one
06 = Duplicate Order. Same smart card number and package had been ordered for in the last few minutes.
07 = Invalid amount
08 = Invalid product code


STARTIMES

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

Request can be made using the smart card number.

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

Parameters:
username: Use your MobileNig Username
password: Your MobileNig account password
service: STARTIMES
number: Decoder or Smart Number

You can use this smart number 02027336692 for testing on STARTIMES

STARTIMES JSON return format:
{"details":{"returnCode":"0","customerType":1,"billAmount":0.0,"balance":2343.81,"returnMessage":"Success","smartCardNumber":"02027336692",
"customerNumber":null,"customerName":"Danny"}}

PROCESSING SUBSCRIPTION

Command:

https://mobilenig.net/api/bills/startimes?username=****&password=****&smartno=****&product_code=****&customer_name=****&ref=****&amount=****

NOTE: For testing purpose, you can use startimes_test instead. By this, the url will become
https://mobilenig.net/api/bills/startimes_test?username=****&password=****&smartno=02027336692&product_code=STARN&customer_name=Danny&ref=322611111&amount=900

PARAMETERS: Username, Password, smartno, product_code:, customer_name, ref, amount

Parameters:
username: Use your MobileNig Username
password: Your MobileNig account password
smartno: The decoder number
product_code: Product code as shown in the table below
customer_name: Customer's name as shown in the request above
ref: Use a unique reference number
amount: amount as shown in the tabe below

Package

Package Product Code Amount
StarTimes Nova STARN 900
StarTimes Basic STARB 1300
StarTimes Smart STARS 1900
StarTimes Classic STARC 2600
StarTimes Unique STARU 3800

Response:
00 = Success
01 = Unsuccessful
02 = Incomplete Parameters
03 = Insufficient Balance
04 = Wrong Username or Password
05 = ref already exist, use a unique one
06 = Duplicate Order. Same smart card number and package had been ordered for in the last few minutes.
07 = Invalid amount
08 = Invalid product code

SPECTRANET PIN

Customer validation is not required for this service

PROCESSING SUBSCRIPTION

Command:

https://mobilenig.net/api/bills/spectranet?username=****&password=****&amount=****&product_code=****&ref=****

NOTE: For testing purpose, you can use spectranet_test instead. By this, the url will become
https://mobilenig.net/api/bills/spectranet_test?username=****&password=****&amount=980&product_code=1000&ref=13112231

PARAMETERS: Username, Password, product_code:, ref, amount

Parameters:
username: Use your MobileNig Username
password: Your MobileNig account password
product_code: Product code as shown in the table below
ref: Use a unique reference number
amount: amount as shown in the tabe below

Package

Package Product Code Amount
#1000 Spectranet Pin 1000 980
#2000 Spectranet Pin 2000 1960
#5000 Spectranet Pin 5000 4900
#7000 Spectranet Pin 7000 6860
#10000 Spectranet Pin 10000 9800

Response:
if successful, a JSON response will be returned in the format below:

{"transactionNumber":12296,"details":{"exchangeReference":"12296","pins":[{"serialNumber":"6501011012320866", "pin":"0525339051","expiresOn":"2018-11-30","value":1000}],"statusMessage":"Successful PIN purchase.","status":"ACCEPTED","statusCode":"0"}}

Other Response are:
01 = Unsuccessful
02 = Incomplete Parameters
03 = Insufficient Balance
04 = Wrong Username or Password
05 = ref already exist, use a unique one
06 = Duplicate Order. Same package had been ordered for in the last few minutes.
07 = Invalid amount
08 = Invalid product code


SMILE DATA BUNDLE

A customer must be validated before processing subscription. This will return the customer’s name.

Request can be made using the customer number.

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

Parameters:
username: Use your MobileNig Username
password: Your MobileNig account password
service: SMILE_DATA
number: Customer Number

You can use this customer number 1402000567 for testing on SMILE

SMILE JSON return format:
{"details":{"firstName":"Sunday","lastName":"Ojo","middleName":""}}

PROCESSING SUBSCRIPTION

Command:

https://mobilenig.net/api/bills/smile_data?username=****&password=****&smartno=****&product_code=****&ref=****&amount=****

NOTE: For testing purpose, you can use smile_data_test instead. By this, the url will become
https://mobilenig.net/api/bills/smile_data_test?username=****&password=****&smartno=1402000567&product_code=4000&ref=1223111&amount=3940

PARAMETERS: Username, Password, smartno, product_code, ref, amount

Parameters:
username: Use your MobileNig Username
password: Your MobileNig account password
smartno: The customer number
product_code: Product code as shown in the table below
ref: Use a unique reference number
amount: amount as shown in the tabe below

Package

Package Product Code Amount
Smile 5GB Night & Weekend Data Bundle 4000 3940
Smile 3GB Data Bundle 3000 2955
Smile 5GB Data Bundle 5000 4925
Smile 10GB Night & Weekend Data Bundle 7500 7388
Smile 10GB Data Bundle 9000 8865
Smile 20GB Night & Weekend Data Bundle 14000 13790
Smile 20GB Data Bundle 17000 16745
Smile 50GB Data Bundle 36000 35460
Smile 100GB Data Bundle 70000 68950

Response:
00 = Success
01 = Unsuccessful
02 = Incomplete Parameters
03 = Insufficient Balance
04 = Wrong Username or Password
05 = ref already exist, use a unique one
06 = Duplicate Order. Same smart card number and package had been ordered for in the last few minutes.
07 = Invalid amount
08 = Invalid product code

WAEC RESULT CHECKER PIN

Customer validation is not required for this service

PROCESSING SUBSCRIPTION

Command:

https://mobilenig.net/api/bills/waec?username=****&password=****&amount=****&product_code=****&ref=****

NOTE: For testing purpose, you can use waec_test instead. By this, the url will become
https://mobilenig.net/api/bills/waec_test?username=****&password=****&amount=650&product_code=1&ref=111223312231

PARAMETERS: Username, Password, product_code:, ref, amount

Parameters:
username: Use your MobileNig Username
password: Your MobileNig account password
product_code: Product code as shown in the table below
ref: Use a unique reference number
amount: amount as shown in the tabe below

Package

Package Product Code Amount
One piece of waec result checker 1 650
Two pieces of waec result checker 2 1300
Three pieces of waec result checker 3 1950
Four pieces of waec result checker 4 2600
Five pieces of waec result checker 5 3250

Response:
if successful, a JSON response will be returned in the format below:

{"transactionNumber":12300,"details":{"exchangeReference":"12300","pins":[{"serialNumber":"WRCP10000166","pin":"234567848854","expiresOn":null}], "statusMessage":"Successful PIN purchase.","status":"ACCEPTED","statusCode":"0"}}

Other Response are:
01 = Unsuccessful
02 = Incomplete Parameters
03 = Insufficient Balance
04 = Wrong Username or Password
05 = ref already exist, use a unique one
06 = Duplicate Order. Same package had been ordered for in the last few minutes.
07 = Invalid amount
08 = Invalid product code

Thanks for choosing MobileNig.