× Integration Introduction page Airtime API Documentation Data API Documentation Cable TV API Documentation Electricity API Documentation Bulk SMS API Documentation Data Pin API Documentation Exam Pin API Documentation Internet Bundles API Documentation Recharge Card Pin API Documentation

Data Pin API Integration

(Live Environment)

Welcome to the Data Pin API Integration page. This guide will help you integrate our Data Pin API into your system.

cURL Init Sample

curl -X POST https://vtunaija.com.ng/api/datapin/ \
-H "Authorization: Token YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"network": "1",
"quantity": "3",
"data_plan": "2",
"businessname": "Boma Enterprise",
"ref": "878753234",
}'

Successful API Response

{
"Status": "successful",
"status": "success",
"api_response": "Data Card Printing Successful",
"id": "78977865523",
"ident": "78977865523",
"plan_amount": "3000",
"pin": "3487746837,3475987844,3579789874",
"serial": "5344587876,3987647598,94876765456"
}

Failed API Response

{
"Status": "failed",
"status": "fail",
"api_response": "Transaction Fail",
"id": "78977865523",
"ident": "78977865523",
"plan_amount": "0"
}

Post Terms Defined and Interpreted

network: This field specifies the network for which the user is purchasing data pins. The *network* field is represented by the numbers 1, 2, 3, or 4, where 1 corresponds to MTN, 2 to GLO, 3 to 9Mobile, and 4 to Airtel. For a complete list of Vtunaija Network IDs and Plan IDs, refer to API Documentation Page 1.

quantity: This field indicates the total number of data pins the user wishes to purchase.

data_plan: This field specifies the particular data pin plan the user wants to purchase. Data pin plans are identified by Plan IDs. For the full list of Vtunaija Network IDs and Plan IDs, refer to API Documentation Page 1.

businessname: This field should contain the name of the business or user purchasing the data pins through the API request.

ref: This is a unique ID provided as the Request ID. This field is optional, meaning you may choose not to include it in your data pin API purchase request.