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

Internet Bundles (Spectranet and SMILE) API Integration

(Sandbox Environment) Register and Login on the Sandbox Website to get your Sandbox API Key for the Sandbox Integration Click Here

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 Init Sample

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

Successful API Response

{
"Status": "successful",
"status": "success",
"api_response": "TRANSACTION SUCCESSFUL",
"id": "78977865523",
"ident": "78977865523",
"plan_amount": "3600"
}

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 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 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 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. This field is optional, meaning you may choose not to include it in your internet bundle API purchase request.