Welcome to the Internet Bundles API Sandbox Integration page. This guide will help you integrate our Sandbox Internet Bundles API into your system.
On Sandbox environment the mobile number you are purchasing internet bundle for must be 08011111111 for SMILE while 1212121212 for Spectranet any other mobile number that is not 08011111111 for SMILE while 1212121212 for Spectranet the internet bundle purchase request will fail.
curl -X POST https://sandbox.vtunaija.com.ng/api/internetbundles/ \
-H "Authorization: Token YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"network": "1",
"data_plan": "2",
"mobile_number": "08012345678",
"account_Id": "293848479774",
"Ported_number": "true",
"request-id": "78977865523"
}'
This is an example of the response returned for a successful Internet Bundle Purchase.
{
"Status": "successful",
"status": "success",
"api_response": "TRANSACTION SUCCESSFUL",
"id": "78977865523",
"ident": "78977865523",
"plan_amount": "3600.00",
"transaction_internal_id": "7851"
}
This is an example of the response returned for a failed Internet Bundle Purchase.
{
"Status": "failed",
"status": "fail",
"api_response": "Failed Failed Failed. Something went wrong",
"id": "78977865523",
"ident": "78977865523",
"plan_amount": "0"
}
This is an example of the response returned for a pending Internet Bundle Purchase.
{
"Status": "processing",
"status": "processing",
"api_response": "Pending Internet Bundle Purchase, transaction pending",
"id": "78977865523",
"ident": "78977865523",
"plan_amount": "3600.00",
"transaction_internal_id": "7851"
}
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 identifies the specific network for which the user is purchasing internet bundle. The network post field is represented by the numbers 5, or 6: 5 indicates SMILE, and 6 indicates Spectranet. For the complete list of Sandbox Vtunaija Network IDs and Plan IDs, check the API Documentation Page 1.
data_plan: This is the particular internet bundle plan that the user wants to buy. The internet bundle plans are represented by Plan IDs. For the complete list of Sandbox Vtunaija Network IDs and Plan IDs, check the API Documentation Page 1.
account_Id: This is field is only required for SMILE internet bundle api integration. It is not compulsory you add this field for spectranet internet bundle api integration. This field is for the SMILE account id. On Sandbox environment the account Id must be 08011111111 any other account id entered in this postfield that is not 08011111111 the internet bundle purchase request will fail.
mobile_number: This is the phone number for which the user wants to purchase the internet bundle. On Sandbox environment the mobile number you are purchasing internet bundle for must be 08011111111 for SMILE while 1212121212 for Spectranet any other mobile number that is not 08011111111 for SMILE while 1212121212 for Spectranet the internet bundle purchase request will fail.
Ported_number: This field is used to bypass the mobile number validator. Setting this field to 'true' means the validator is bypassed, while 'false' means it is not bypassed. This field is optional and defaults to 'true' if not provided during API internet bundle integration.
request-id: This is the unique ID you send as the Request ID.