VTU API for Airtime, Data (MTN SME, Glo, Airtel & 9mobile), Cable TV (DSTv, GOTv & Startimes) Subscription and Electricity Bills Payment in Nigeria

The VTU API is an HTTPS GET API that allows you (developers) to integrate all virtual top-up (VTU) and bills payment services available on the VTU.ng platform with your application (websites, desktop apps & mobile apps). You can also start your own VTU business by integrating our VTU API and reselling our services in Nigeria.

As an API user, you will enjoy even cheaper prices. You will get 1GB at ₦249; 3% discounts on airtime; 1.5% discounts on cable TV subscription; 1% discounts on electricity bills payment; and ₦0.00 service fees. Please see pricing for more information.

Alright, let me tell you. We have built an internal infrastructure for the best SIM hosting capabilities. We have many SIMs internally hosted on our dedicated server. These SIMs automatically get VTU requests in milliseconds and they constantly deliver our VTU services instantly by dialing the required USSD codes and sending SMSs where necessary. We have also connected our cable TV subscription and electricity bill payment services directly to the providers’ gateways (Premium Direct Connections). We also leverage direct connections to banks where necessary. Now you truly know why we are cheap and reliable.

Here, you will get all premium recharge APIs. From airtime vending API (recharge cards API) to data reselling API to bills payment API. All failed orders are refunded automatically. We are unarguably the best VTU API provider in Nigeria.

Note: You must have a reseller account with us to use our API.

Contents

API Integration
API BASE URL
Authentication
Request Methods
Response
Available Products and Services on the VTU.ng API
How to Get VTU.ng Wallet Balance via VTU.ng HTTP API
– Parameters
– Example [Getting Wallet Balance]
– Sample Response on Success
– Sample Response on Failure
How to Purchase Airtime via VTU.ng HTTP API
– Parameters
– Example [Purchasing Airtime]
– Sample Response on Success
– Sample Response on Failure
How to Purchase Data via VTU.ng HTTP API
– Parameters
– Example [Purchasing Data]
– Sample Response on Success
– Sample Response on Failure
How to Verify Customers via VTU.ng HTTP API
– Parameters
– Example [Verifying Customers]
– Sample Response on Success
– Sample Response on Failure
How to Purchase Cable TV via VTU.ng HTTP API
– Parameters
– Example [Purchasing Cable TV]
– Sample Response on Success
– Sample Response on Failure
How to Purchase Electricity via VTU.ng HTTP API
– Parameters
– Example [Purchasing Electricity]
– Sample Response on Success
– Sample Response on Failure
Response Codes

API Integration

Unfortunately, we currently do not have the Sandbox environment where you can do your tests but don’t get frightened, our HTTPS GET API is very easy to integrate. With the help of our super free VTU API documentation below, you can safely write your codes, believing that it will work and it will work as long as it’s about our simple yet robust API.

API BASE URL

The Live API BASE URL: https://vtu.ng/wp-json/api/v1/

Authentication

The VTU.ng API uses Basic Authentication. You need to always pass your username and password as part of the URL parameters. Your connection is secure.

Request Methods

All request methods are GET. You can also use cURL.

Response

All responses from the VTU.ng API are returned in JSON format.

Available Products and Services on the VTU.ng API include:

1. Balance
2. Airtime
3. Data
4. Customer Verification
5. Cable TV
6. Electricity

How to Get VTU.ng Wallet Balance via VTU.ng HTTP API

Wallet Balance Endpoint URL: https://vtu.ng/wp-json/api/v1/balance

Request Method: GET

Parameters

Example [Getting Wallet Balance]

https://vtu.ng/wp-json/api/v1/balance?username=Frank&password=123456

Sample Response on Success

{"code":"success","message":"Wallet balance successfully retrieved","data":{"balance":"120067.65","currency":"NGN"}}

Sample Response on Failure

{"code":"invalid_username","message":"Unknown username. Check again or try your email address.","data":null}

Airtime Recharge API – How to Purchase Airtime (MTN, Glo, Airtel & 9mobile) via VTU.ng HTTP API

Airtime Endpoint URL: https://vtu.ng/wp-json/api/v1/airtime

Request Method: GET

Parameters

Example [Purchasing Airtime]

https://vtu.ng/wp-json/api/v1/airtime?username=Frank&password=123456&phone=07045461790&network_id=mtn&amount=2000

Sample Response on Success

{"code":"success","message":"Airtime successfully delivered","data":{"network":"MTN","phone":"07045461790","amount":"NGN2000","order_id":"3100"}}

Sample Response on Failure

{"code":"failure","message":"Your wallet balance (NGN1067.65) is insufficient to make this airtime purchase of NGN2000","order_id":"3289"}

Data Reseller API – How to Purchase Data (MTN, Glo, Airtel & 9mobile) via VTU.ng HTTP API

This endpoint provides you with the ultimate solution to all your data API questions like CG Data API; MTN SME Data Reseller API; Airtel Edusuite Corporate Data Gifting API; Glo Corporate Data Gifting API; MTN Corporate Data Gifting API; Airtel SME Data API; 9mobile Corporate Data Gifting API; Glo SME Data API.

Data Endpoint URL: https://vtu.ng/wp-json/api/v1/data

Request Method: GET

Parameters

Example [Purchasing Data]

https://vtu.ng/wp-json/api/v1/data?username=Frank&password=123456&phone=07045461790&network_id=mtn&variation_id=M1024

Sample Response on Success

{"code":"success","message":"Data successfully delivered","data":{"network":"MTN","data_plan":"MTN Data 1GB (SME) – 30 Days","phone":"07045461790","amount":"NGN259","order_id":"2443"}}

Sample Response on Failure

{"code":"failure","message":"Invalid data variation_id. Please, crosscheck and enter the correct variation_id.","order_id":"3456"}

Meter Number and IUC/Smartcard Number Verification API – How to Verify Customers via VTU.ng HTTP API

We advise that you always verify the customer’s details before submitting requests to purchase the service (cable TV or electricity). The VTU.ng customer verification endpoint allows you to get the customer’s full name, address, and many more.

Customer Verification Endpoint URL: https://vtu.ng/wp-json/api/v1/verify-customer

Request Method: GET

Parameters

Example [Verifying Customers]

https://vtu.ng/wp-json/api/v1/verify-customer?username=Frank&password=123456&customer_id=62418234034&service_id=ikeja-electric&variation_id=prepaid

Sample Response on Success

{"code":"success","message":"Customer details successfully retrieved","data":{"customer_id":"62418234034","customer_name":"FIRSTNAME LASTNAME","customer_address":"10 Example Street, Town, State","customer_arrears":"0.00","decoder_status":null,"decoder_due_date":null,"decoder_balance":null}}

Sample Response on Failure

{"code":"failure","message":"Invalid Meter Number"}

Cable TV Bills Payment API – How to Purchase/Subscribe Cable TV (DSTv, GOTv & Startimes) via VTU.ng HTTP API

Cable TV Endpoint URL: https://vtu.ng/wp-json/api/v1/tv

Request Method: GET

Parameters

Example [Purchasing Cable TV]

https://vtu.ng/wp-json/api/v1/tv?username=Frank&password=123456&phone=07045461790&service_id=gotv&smartcard_number=7032400086&variation_id=gotv-max

Sample Response on Success

{"code":"success","message":"Cable TV subscription successfully delivered","data":{"cable_tv":"GOtv","subscription_plan":"GOtv Max","smartcard_number":"7032400086","phone":"07045461790","amount":"NGN3280","amount_charged":"NGN3247.2","service_fee":"NGN0.00","order_id":"2876"}}

Sample Response on Failure

{"code":"failure","message":"Invalid Smartcard Number","order_id":"3652"}

Electricity Bills Payment API – How to Purchase/Pay Electricity Bills in Nigeria via VTU.ng HTTP API

You can purchase electricity through our API and get an instant token for prepaid meters.

Electricity Endpoint URL: https://vtu.ng/wp-json/api/v1/electricity

Request Method: GET

Parameters

Example [Purchasing Electricity]

https://vtu.ng/wp-json/api/v1/electricity?username=Frank&password=123456&phone=07045461790&meter_number=62418234034&service_id=ikeja-electric&variation_id=prepaid&amount=3000

Sample Response on Success

{"code":"success","message":"Electricity bill successfully paid","data":{"electricity":"Ikeja (IKEDC)","meter_number":"62418234034","token":"Token: 5345 8765 3456 3456 1232","units":"47.79kwH","phone":"07045461790","amount":"NGN3000","amount_charged":"NGN2970","order_id":"4324"}}

Sample Response on Failure

{"code":"failure","message":"Invalid Meter Number","order_id":"3907"}

Response Codes