Welcome to the Data Pin API Integration page. This guide will help you integrate our Data Pin API into your system.
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",
"request-id": "878753234"
}'
This is an example of the response returned for a successful DataCard Purchase.
{
"Status": "successful",
"status": "success",
"api_response": "Data Card Printing Successful",
"id": "78977865523",
"ident": "78977865523",
"plan_amount": "3000.00",
"transaction_internal_id": "2217"
"pin": "3487746837,3475987844,3579789874",
"serial": "5344587876,3987647598,94876765456"
}
This is an example of the response returned for a failed DataCard Purchase.
{
"Status": "failed",
"status": "fail",
"api_response": "Transaction Fail",
"id": "78977865523",
"ident": "78977865523",
"plan_amount": "0.00",
"transaction_internal_id": "2217"
}
This is an example of the response returned for a pending DataCard Purchase.
{
"Status": "processing",
"status": "processing",
"api_response": "Pending DataCard Purchase, transaction pending",
"id": "78977865523",
"ident": "78977865523",
"plan_amount": "3000.00",
"transaction_internal_id": "2217"
}
This is an example of a failed API response caused by factors such as an insufficient wallet balance, an incorrect API key, missing POST fields and so on.
{
"Status": "failed",
"status": "fail",
"message": "Insufficient wallet balance",
}
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 9MobileT2mobiile(9Mobile), and 4 to Airtel. For a complete list of Vtunaija Network IDs and Plan IDs, please refer to the Plan IDs and Pricing Page of the Live Website.
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, please refer to the Plan IDs and Pricing Page of the Live Website.
businessname: This field should contain the name of the business or user purchasing the data pins through the API request.
request-id: This is the unique ID you send as the Request ID.