Welcome to the Recharge Card API Integration page. This guide will help you integrate our Recharge Card API into your system.
curl -X POST https://vtunaija.com.ng/api/rechargepin/ \
-H "Authorization: Token YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"network": "1",
"network_amount": "100",
"quantity": "10",
"name_on_card": "Boma Enterprise"
}'
{
"Status": "successful",
"status": "success",
"api_response": "Transaction Successful",
"id": "78977865523",
"ident": "78977865523",
"plan_amount": "1000",
"pin": "12345678901234567,23456789012345678,34567890123456789,45678901234567890,56789012345678901,67890123456789012,78901234567890123,89012345678901234,90123456789012345,01234567890123456
",
"serial": "98765432101234567,87654321098765432,76543210987654321,65432109876543210,54321098765432109,43210987654321098,32109876543210987,21098765432109876,10987654321098765,09876543210987654
"
}
{
"Status": "failed",
"status": "fail",
"api_response": "failed failed failed. Something went wrong",
"id": "78977865523",
"ident": "78977865523",
"plan_amount": "0"
}
network: This field specifies the network for which the user is purchasing recharge card pins. The network field is represented by the values 1, 2, 3, or 4, where 1 corresponds to MTN, 2 to GLO, 3 to 9Mobile, and 4 to Airtel. For a comprehensive list of Vtunaija Network IDs and Plan IDs, please refer to Page 1 of the API Documentation.
network_amount: This field indicates the recharge amount the user intends to purchase, which must be either ₦100, ₦200, or ₦500. The network_amount field should be set to 100, 200, or 500.
quantity: This field specifies the total number of recharge card pins the user wishes to purchase. The minimum quantity per transaction is 10.
name_on_card: This field must contain the name of the business or individual making the purchase through the API request.