FAQ's

FAQ - Frequently Asked Questions

General

1. What format is required for thenationalities field?
   The nationalities field should be an array of strings using the alpha-2 code format (e.g., BR for Brazilian, MX for Mexican). Foreign nationals can be serviced if they provide the required documentation for KYC approval:

   • Brazil: CPF number
   • Argentina: DNI (Documento Nacional de Identidad)
   • Mexico: INE (Instituto Nacional Electoral)

2. What format is required for thedateOfBirth field?
   Format: YYYY-MM-DD

3. Is there a minimum age for DOB?
   Yes, the minimum age is 18 years old.

4. What documents are accepted for National ID verification?

   • Brazil: CPF number (no need for National ID file upload)
   • Argentina: DNI (Documento Nacional de Identidad)
   • Mexico: INE (Instituto Nacional Electoral)

5. Can foreign nationals living in Argentina sign up?
   Yes, as long as they have a DNI.

6. What happens if a user changes their phone number?
   The initial valid phone number submission is sufficient. It does not impact the flow since it is a compliance requirement, not a communication method.

7. Do you have a list of error codes?
   Yes, refer to the provided documentation for error codes.

8. Can eitherfromAmount OR toAmount be provided?
   Yes, reverse quote functionality is available.

9. Is the amount in/offramp and /onramp based on fromCurrency?
   Yes, the amount is tied to fromAmount.

10. Will the same customer have the samecustomer_id across different countries?
    No, customer_id differs by country.

11. Do you support other identifiers for PIX beyond CPF?
    Yes, supported identifiers include Email, Phone Number, and CPF.

12. How is CBU validated? Do you support CBU aliases?
    Name and CUIT are verified against the CVU. Yes, alias support is available.

Transactions & Operations

13. What are the transaction statuses?
    Onramp Statuses:

    • CREATED
    • FIAT_DEPOSIT_RECEIVED
    • TRADE_COMPLETED
    • ON_CHAIN_INITIATED
    • ON_CHAIN_COMPLETED
    • FAILED

    Offramp Statuses:

    • CREATED
    • ON_CHAIN_DEPOSIT_RECEIVED
    • TRADE_COMPLETED
    • FIAT_TRANSFER_INITIATED
    • FIAT_TRANSFER_COMPLETED
    • FAILED

14. Is KYC required before deposits/withdrawals?
    Yes, full KYC is required before any deposit or withdrawal.

15. What are the required KYC fields?
    Required fields vary by country, including personal details, address details, and national ID document uploads where applicable.

16. Is KYC Lite available?
    Yes, for some countries, KYC Lite may be used - a KYC Lite is considered a validation without document/file uploads.

17. Can a trader use acustomerId after KYC approval for transactions?
    Yes, once approved, the customerId suffices for deposits/withdrawals.

18. What deposit and withdrawal methods are available?

    • Deposits (On-ramp): Bank deposits, with Cash in development for some regions.
    • Withdrawals (Off-ramp): Bank and Cash.

19. Is user registration mandatory for transactions?
    Yes, users must be registered before making deposits or withdrawals.

Technical & Compliance

20. How do you verify callback signatures?
    Use the provided public key to validate the signature against received callback data.

21. What is the transaction flow for deposits?

    1. Register the customer
    2. Complete KYC
    3. Generate a quote
    4. Initiate the transaction
    5. Make the deposit
    6. Receive cryptocurrency

22. What is the transaction flow for withdrawals?

    1. Register the customer
    2. Complete KYC
    3. Generate a quote
    4. Initiate the transaction
    5. Make the deposit
    6. Receive fiat currency

23. How does a user make a fiat payment?
    Users push payments from their bank accounts using deposit instructions displayed at checkout.

24. Where are payment instructions displayed?
    On the final screen of the widget, with an option to copy details.

25. How is the webhook URL set up?

    • Send the URL for webhook configuration.
    • Only one URL can be used.
    • Webhooks notify of transactional and KYC updates.

26. Is there a webhook monitoring system?
    Yes, there is a monitoring system to alert of outages.

27. Is webhook setup mandatory?
    Yes, for receiving transaction and KYC updates.

28. What happens if a transaction verification fails?
    A FAILED status is returned with an accompanying failure reason.

29. What is the API rate limit?
    No strict rate limit; one call per second is acceptable.

30. Are transaction fees included in the quote?
    Yes, all costs are included in the quote.

31. Is there a session timeout for the widget?
    No, but quotes expire in 30 minutes.

32. What currency precision is supported?

    • Fiat: 2 decimal places
    • Crypto: 6 decimal places

33. Can transaction status be retrieved via API?
    Yes, using List Onramp Transactions By Id to check status updates.

34. What are the final transaction statuses?

    • ON_CHAIN_COMPLETED (Success)
    • FAILED (Failure, may require support follow-up)

35. Does a transaction inON_CHAIN_COMPLETED or FAILED remain final?
    Yes, unless Customer Support intervenes due to specific failure reasons.

This document consolidates the most frequently asked questions regarding compliance, transactions, and API operations.