Recharge Card API Integration

Welcome to the Recharge Card API Sandbox Integration page. This guide will help you integrate our Sandbox Recharge Card API into your system.

The minimum quantity per transaction is 10. The minimum quantity of pins you can purchase per purchase request is 10. Therefore enter 10 or above in the quantity postfields

cURL Init Sample


curl -X POST https://sandbox.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" 
       
}'

Successful API Response


{ 

    "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
" 
 
}

Failed API Response


{ 

    "Status": "failed", 
  
    "status": "fail", 

    "api_response": "failed failed failed. Something went wrong", 

    "id": "78977865523", 

    "ident": "78977865523", 

    "plan_amount": "0" 
 
}

Post Terms Defined and Interpreted

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.