Frequently Asked Questions
What are the different testing environment URLs?
Sandbox (Testing Environment):
https://sandbox.valuetopup.com
Please use this URL for all initial integration and testing.
Production (Live Environment): https://www.valuetopup.com
This is the live site for processing real-time transactions.
How do I authenticate my requests?
Authentication is performed via HTTP Basic Authentication using a Username and Password.
What are common API HTTP status codes?
Some of the most commonly used status codes are:
200 – OK
Indicates that the request was successful and the API returned the expected response.
401 – Unauthorized
Indicates that the request lacks valid authentication credentials, such as an invalid or expired API key/token, or a missing authorization header.
500 – Internal Server Error
Indicates a server-side issue where the request could not be processed due to an unexpected error.
How can I obtain Sandbox account access?
Contact ops@prepaynation.com to request Sandbox account access.
How to simulate APIs in Sandbox?
Use API Integration Test Scenarios to simulate them in sandbox environment.
How can I obtain Production account access?
All APIs must first be tested in the Sandbox environment. After testing, contact ops@prepaynation.com to request Production account access.
Who to contact for support during and after API integration?
During API integration, please contact ops@prepaynation.com
For questions or immediate assistance related to your Production account, or at any later stage, contact the Support Team at support@prepaynation.com
How do I interpret my account balance ?
Prepaid accounts: The balance is shown as a negative number, representing the funds available.
Credit accounts: The balance reflects the amount you owe.
What are different available Product Categories?
Products are categorized as Pin, Rtr, Bill Pay, Gift Card and eSim.
What is a SKU?
An SKU is specific code representing the denomination details of a product.
How to retrieve SKU IDs for different products?
Gift Card SKUs: Use the endpoint /api/v2/catalog/skus/giftcards to fetch SKU IDs specifically for gift cards.
Non-Gift Card SKUs: Use the endpoint /api/v2/catalog/skus to retrieve SKU IDs for all other products (excluding gift cards).
Does the Catalog API support Pagination?
Pagination is supported only for gift card SKUs. It is not available for non-gift card SKUs.
Do the APIs support Localization?
Yes, the following APIs support localization:
Catalog SKUs
Gift Card SKUs
Mobile Number Lookup
How can we get information in local language and request new language?
For more details, see the Localization and Multilingual Response Support section.
If you need support for additional languages, please contact ops@prepaynation.com.
What are 'Range' products?
Some products allow a range amount. For these, you must check the Min Value and Max Value in the catalog APIs before sending a transaction.
What are ‘Fixed’ products?
These are products with a predefined amount. Before processing a transaction, ensure that the Min Value and Max Value in the catalog APIs are the same.
What do you mean by exchange rate for a SKU?
It provides the conversion rate between your account currency and the destination country's local currency.
Why are the SKU exchange rates incorrect in the sandbox environment?
The SKU exchange rates in the sandbox environment do not match the live rates in production. This is expected, as production always uses real-time rates.
What is Estimated Cost?
The Estimated Cost API is used to calculate the approximate total cost of a transaction before you actually submit it.
How can I identify the operator for a specific mobile number?
User needs to refer Mobile Number Lookup API. This is essential to get operator and product information for a specific mobile number.
What should I do if response of Transaction API is taking longer than usual or I didn’t receive any response after posting a transaction ?
Most transactions are completed within seconds. However, in rare cases, a recharge transaction may not return a response within the timeout period configured in your system. When this happens, your system may generate a timeout error and assume that no response was received from our API. It’s important to note that a timeout error does not indicate that the transaction has failed on our end - it only means your system stopped waiting after the defined timeout duration. If the transaction is actually successful, your account will still be charged. To confirm the accurate and final status of the transaction, we recommend using the Check Status method with the customer’s unique correlation ID. This will provide the definitive outcome of the original transaction.
Where can I find a list of error codes?
You can use API - /api/v2/catalog/errors to get full list of system and operator-specific error codes.
How can I view Transaction and Other Reports?
These reports can be accessed through the Customer Portal. Please contact ops@prepaynation.com to request access.
How can we see products and product updates ?
You can access the product catalog through both the Portal and API. We recommend keeping your catalog up to date using one of the following approaches:
Daily updates
Weekly updates
On-demand updates, triggered when you receive a product update notification from us
Can the min and max send values be changed or can product or SKU is changed ?
Yes, certain changes can occur to a product or SKU. These may include:
Price updates
Discount changes
Temporary discontinuation for a specific period
In all such scenarios, you will receive notifications from our system to keep you informed of these updates.
How Can I whitelist an IP for my account ?
To enhance your account security, you are required to restrict access to specific IP addresses. To add, remove or update your whitelisted IPs, please submit your request to support@prepaynation.com. Our team will process these changes to ensure your account remains protected.