Menu

Getting Started

Create an account and learn how to integrate BlinkCard into your website.

The BlinkCard provides endpoints to check balances, purchase airtime and data, pay for cable and electricity, and more. It is a RESTful API and all responses are returned in JSON.

Create an account to start integrating our API into your application.

Airtime API Documentation
Data API Documentation
Cable TV API Documentation
Electricity API Documentation
Data Pin API Documentation
Exam Pin API Documentation

Obtaining API

To start using our VTU API, you need to generate your unique API Key from the developer dashboard.

This key is used to authenticate all your requests and must be kept secure. Kindly follow th steps below to generate your API Keys. Once obtained, you can begin integrating our services into your application.

  • Register for an account on Blinkcard.net.
  • Log into your dashboard.
  • Upgrade to Agent account
  • Navigate to the API Settings section.
  • Generate and copy your API key.

Authorization

Each request requires authentication using your API key.

All calls to our API endpoints must be authenticated - no exceptions - and must be over HTTPS. To accomplish this, include your API key in the Authorization header of every request you make. You should send your Authorization header in the following format: 

    Authorization: Token YOUR_API_KEY

Check Balance

Retrieve your wallet balance instantly

The Check Balance endpoint allows you to query and retrieve your current wallet balance in real time. This is especially useful for validating whether sufficient funds are available before processing airtime, data, or bill payment requests. By integrating this endpoint, your application can automatically monitor wallet status, prevent failed transactions due to insufficient balance, and provide users with a seamless transaction experience.

Endpoint: https://blinkcard.net/api/user/

Method: GET

curl --location 'https://blinkcard.net/api/user/' \
--header 'Authorization: Token YOUR_API_KEY' \
--header 'Content-Type: application/json'

Airtime

Recharge any mobile number instantly from your app.

The Airtime Purchase endpoint allows you to top up any mobile number in real time with flexible recharge amounts. This feature supports all major network providers, ensuring fast and reliable airtime delivery. It is designed to help businesses and developers integrate seamless airtime recharge into their applications, websites, or platforms. With this endpoint, you can automate airtime vending, track transactions, and provide users with a smooth recharge experience without manual intervention.

Endpoint: https://blinkcard.net/api/airtime/

Method: GET

curl --location 'https://blinkcard.net/api/airtime/' \
--header 'Authorization: Token YOUR_API_KEY' \
--header 'Content-Type: application/json'
-d '{
"network": "1",
"mobile_number": "09025858831",
"Ported_number": "true",
"request-id": "549778655345",
"amount": "500",
"airtime_type": "VTU"
}'

Successful Response

{
"Status": "successful",
"status": "success",
"api_response": "You have successfully sent Airtime of ₦800 to 09025858831. Your API airtime balance is ₦52,200",
"id": "549778655345",
"ident": "549778655345",
"plan_amount": "800"
}

Failed Response

{
"Status": "failed",
"status": "fail",
"api_response": "Failed Failed Failed. Something went wrong",
"id": "68973456345",
"ident": "68973456345",
"plan_amount": "0"
}

Data

Buy mobile data bundles instantly from your app.

The Data Purchase endpoint provides a seamless way to purchase mobile internet bundles in real time. It supports multiple network providers and offers flexible bundle options to meet different user needs. With this feature, developers and businesses can integrate reliable data vending services into their platforms, enabling users to top up their data effortlessly. The system ensures quick delivery, secure transactions, and transparent reporting, making it ideal for automated platforms, mobile apps, and reseller services.

Endpoint: https://blinkcard.net/api/data/

Method: GET

curl --location 'https://blinkcard.net/api/data/' \
--header 'Authorization: Token YOUR_API_KEY' \
--header 'Content-Type: application/json'
-d '{
"network": "1",
"mobile_number": "09025858831",
"Ported_number": "true",
"request-id": "68973456345",
"plan": "2",
}

Successful Response

{
"Status": "successful",
"status": "success",
"api_response": "Dear Customer, You have successfully shared 1GB Data to 2349025858831. Thankyou",
"id": "68973456345",
"ident": "68973456345",
"plan_amount": "260"
}

Failed Response

{
"Status": "failed",
"status": "fail",
"api_response": "Failed Failed Failed. Something went wrong",
"id": "68973456345",
"ident": "68973456345",
"plan_amount": "0"
}

Electricity

Pay electricity bills instantly for your users.

The Data Purchase endpoint provides a seamless way to purchase mobile internet bundles in real time. It supports multiple network providers and offers flexible bundle options to meet different user needs. With this feature, developers and businesses can integrate reliable data vending services into their platforms, enabling users to top up their data effortlessly. The system ensures quick delivery, secure transactions, and transparent reporting, making it ideal for automated platforms, mobile apps, and reseller services.

Endpoint: https://blinkcard.net/api/electricity/

Method: GET

curl --location 'https://blinkcard.net/api/electricity/' \
--header 'Authorization: Token YOUR_API_KEY' \
--header 'Content-Type: application/json'
-d '{
"disco_name": "1",
"meter_number": "580745439",
"MeterType": "prepaid",
"amount": "5000"
}'

Successful Response

{
"Status": "successful",
"status": "success",
"api_response": "TRANSACTION SUCCESSFUL",
"id": "68973456345",
"ident": "68973456345",
"plan_amount": "5000",
"token": "Token: 576578478667889587123",
"electricitytoken": "Token: 576578478667889587123"
}

Failed Response

{
"Status": "failed",
"status": "fail",
"api_response": "Failed Failed Failed. Something went wrong",
"id": "68973456345",
"ident": "68973456345",
"plan_amount": "0"
}

Cable

Pay and renew subscriptions for supported TV providers instantly.

The Cable TV Subscription endpoint allows users to easily renew or activate their favorite TV packages across multiple service providers, including DSTV, GOTV, and Startimes. This feature ensures uninterrupted entertainment by processing payments securely and delivering instant confirmation. It supports both bouquet renewals and top-ups, providing flexibility for users. Businesses and resellers can integrate this endpoint to expand their service offerings, boost customer retention, and provide a smooth entertainment experience without service disruption.

Endpoint: https://blinkcard.net/api/cabletv/

Method: GET

curl --location 'https://blinkcard.net/api/cabletv/' \
--header 'Authorization: Token YOUR_API_KEY' \
--header 'Content-Type: application/json'
-d '{
"cablename": "1",
"smart_card_number": "275835427",
"cableplan": "3"
}'

Successful Response

{
"Status": "successful",
"status": "success",
"api_response": "TRANSACTTION SUCCESSFUL",
"id": "68973456345",
"ident": "68973456345",
"plan_amount": "5800"
}

Failed Response

{
"Status": "failed",
"status": "fail",
"api_response": "Failed Failed Failed. Something went wrong",
"id": "68973456345",
"ident": "68973456345",
"plan_amount": "0"
}

Exam Pin

Purchase and deliver examination PINs such as WAEC, NECO, and NABTEB.

The Exam PIN endpoint enables users to conveniently purchase and instantly receive examination PINs required for registrations and result checking, such as WAEC, NECO, and JAMB e-PINs. With this service, students and educational centers can avoid the stress of physical purchases by obtaining secure digital PINs anytime. Resellers can also leverage this feature to expand their offerings, ensuring quick delivery and a reliable experience for learners preparing for key examinations. This solution guarantees authenticity, speed, and efficiency in accessing educational services.

Endpoint: https://blinkcard.net/api/exam/

Method: GET

curl --location 'https://blinkcard.net/api/exam/' \
--header 'Authorization: Token YOUR_API_KEY' \
--header 'Content-Type: application/json'
-d '{
"exam_name": "2",
"quantity": "1",
}'

Successful Response

{
"Status": "successful",
"status": "success",
"api_response": "Transaction Successful",
"id": "68973456345",
"ident": "68973456345",
"plan_amount": "4500",
"pin": "12345678901234567",
"serial": "98765432101234567"
}

Failed Response

{
"Status": "failed",
"status": "fail",
"api_response": "Failed Failed Failed. Something went wrong",
"id": "68973456345",
"ident": "68973456345",
"plan_amount": "0"
}

Data Pin

Purchase and deliver internet bundle PINs across all major networks instantly.

The Data PIN endpoint provides a seamless way to buy and deliver mobile data recharge PINs (also known as data vouchers) for all major networks. Instead of direct data top-up, this service generates a secure PIN that can be shared, sold, or redeemed later by the user. It is especially useful for resellers, agents, and businesses looking to distribute bulk data conveniently. With instant delivery and guaranteed authenticity, the Data PIN solution ensures customers have flexible access to affordable internet bundles, whether for personal use, resale, or gifting.

Endpoint: https://blinkcard.net/api/datapin/

Method: GET

curl --location 'https://blinkcard.net/api/datapin/' \
--header 'Authorization: Token YOUR_API_KEY' \
--header 'Content-Type: application/json'
-d '{
"network": "1",
"data_plan": "2",
"mobile_number": "09025858831",
"account_Id": "2349025858831",
"Ported_number": "true",
"request-id": "68973456345"
}'

Successful Response

{
"Status": "successful",
"status": "success",
"api_response": "TRANSACTION SUCCESSFUL",
"id": "68973456345",
"ident": "68973456345",
"plan_amount": "3600"
}

Failed Response

{
"Status": "failed",
"status": "fail",
"api_response": "Failed Failed Failed. Something went wrong",
"id": "68973456345",
"ident": "68973456345",
"plan_amount": "0"
}

Verify Cable

Pay and renew subscriptions for supported TV providers instantly.

The Cable TV Subscription endpoint allows users to easily renew or activate their favorite TV packages across multiple service providers, including DSTV, GOTV, and Startimes. This feature ensures uninterrupted entertainment by processing payments securely and delivering instant confirmation. It supports both bouquet renewals and top-ups, providing flexibility for users. Businesses and resellers can integrate this endpoint to expand their service offerings, boost customer retention, and provide a smooth entertainment experience without service disruption.

Endpoint: https://blinkcard.net/api/cabletv/verify/

Method: GET

curl --location 'https://blinkcard.net/api/cabletv/verify/' \
--header 'Authorization: Token YOUR_API_KEY' \
--header 'Content-Type: application/json'
-d '{
"cablename": "1",
"smart_card_number": "275835427"
}'

Successful Response

{
"Status": "successful",
"status": "success",
"api_response": "Cable Verification Name gotten successfully",
"id": "68973456345",
"ident": "68973456345",
"Customer_Name": "Adebayo olawole",
"name": "Adebayo olawole"
}

Failed Response

{
"Status": "failed",
"status": "fail",
"api_response": "Meter Name Verification Failed",
"id": "68973456345",
"ident": "68973456345"
}

Verify Electricity

Pay and renew subscriptions for supported TV providers instantly.

The Cable TV Subscription endpoint allows users to easily renew or activate their favorite TV packages across multiple service providers, including DSTV, GOTV, and Startimes. This feature ensures uninterrupted entertainment by processing payments securely and delivering instant confirmation. It supports both bouquet renewals and top-ups, providing flexibility for users. Businesses and resellers can integrate this endpoint to expand their service offerings, boost customer retention, and provide a smooth entertainment experience without service disruption.

Endpoint: https://blinkcard.net/api/electricity/verify/

Method: GET

curl --location 'https://blinkcard.net/api/electricity/verify/' \
--header 'Authorization: Token YOUR_API_KEY' \
--header 'Content-Type: application/json'

Successful Response

{
"Status": "successful",
"status": "success",
"api_response": "Meter Verification Name gotten successfully",
"id": "68973456345",
"ident": "68973456345",
"Customer_Name": "Adebayo Olawole",
"name": "Adebayo Olawole",
"Customer_Address": "Lagos - 107 Close, Banana Island"
}

Failed Response

{
"Status": "failed",
"status": "fail",
"api_response": "Meter Name Verification Failed",
"id": "68973456345",
"ident": "68973456345"
}