Testing API Limitations
On ramp Payment Methods and limits
Some payment methods restrict the amount of fiat you can use on testing environments (for Khipu it’s around 50 USD maximum, for Palomma it’s around 1.25 USD minimum, in the local currencies). We recommend testing with less than 50 dollars or the equivalent amount in local currency to prevent errors.
You will also notice the amount limits are different on the testing API. Whereas in production you will see a minimum amount of around 25 USD and a maximum of 8,000 USD, the testing API will allow lower and higher amounts.
Testnet tokens and prices
Some tokens avaialable in production are NOT available on the some of the testnets. For example, USDT is not available on Polygon testnets, and thus will not be available on our testing API. However, it will available on production.
Additionally, you might encounter prices that are off market or pairs that are not available.
How we use the Testing API
When we do our testing, we usually start with an on ramp to get the test tokens we’ll need to do an off ramp.
- We create users using
accounts
for each of the countries we want to test. - For each user and country, we create JWT session tokens using the authentication endpoint.
- We create executable quotes for the tokens we want to test. We always choose payment methods that have testing capabilities, like Khipu or Palomma.
- With the quote, we test if the duration is sufficient for users to confirm the order.
- If the quote is still valid, we create an order using it, making sure we pass the right wallet address on the
providedAddress
field. - We follow the link returned by the API to pay the order.
- We follow through the payment steps of each payment method. Usually, the passwords or codes are either
1234
or123456
or are stated on the screen. - We wait for the webhooks and blockchain confirmations, occasionally querying the orders endpoint to check the status.
After receiving test tokens, we can try out the off ramps:
- We create a bank account for each user.
- We get an executable quote for an off ramp. The only difference is switching the order of the symbols. For on ramps,
symbolOut
will be a crypto symbol; for off ramps it will be a fiat symbol. - Passing the
bankAccount
id in theprovidedAddress
field, we create an off ramp order. - The API returns a wallet address to which we send the exact amount we ordered.
- We wait for the webhooks and blockchain confirmations, occasionally querying the orders endpoint to check the status.
For off ramps, once we have confirmed the testnet crypto payment, we always simulate a successful bank transaction. To add more real world conditions, we’re working on simulating failed transfers.
OffRamp in Argentina
In Argentina, in order to make the corresponding transfer, bank accounts will be validated to ensure they are not blocked or inactive, and that the bank account holder matches the user who is operating the account. To do this, we have a batch of specific data.
The operation procedure is as follows:
- We must have a user account with any document mentioned above.
- Create a bank account POST /bank-accounts. We will use the corresponding bank account number for the document of the previously created user account. Example for a user account with document number: 34770518
- If everything is fine, the bank account will be verified and can be operated through it. Otherwise, the bank account will be invalid for that user account.
- Create the quote POST /quotes.
- Create the order POST /orders.