Getting Started ARS

Learn the first steps you need to take to use the API.

To have access to the service, you need to complete the following steps:

  1. Contact our sales team at [email protected] to indicate your interest in the International Payments product. Only business users are eligible to have this feature active in their accounts.

  2. Undergo and approve the KYC compliance assessment. To go through the KYC process, you must create a Bitso business account (production environment) at the Bitso business register. The only way to access the API is through a Bitso account.

    Meanwhile, you can create a testing account to evaluate the product. For further details on creating an account and generating API keys, see the section, Set Up Your Testing Environment. You can verify how to build signed requests in Authentication and explore the endpoints' documentation in the sections, How to Use the Service ARS.

    When creating your API key, ensure you grant the following authorization permissions: Place orders and Make withdrawals; see Figure 1. Otherwise, your API key cannot execute international transfer quotes or list them. The remaining permissions are optional.

Figure 5. API Permissions Needed for International Payments in ARS

Figure 1. API Permissions Needed for International Payments in ARS

  1. Sign the International Payments contract (offline).
  2. Send an email message to [email protected] to request the items listed below. Remember to include your user ID (stage) in your message.
    1. The activation of the International Payments API in your testing account for the countries where you want to conduct payments.
    2. Funds for your Bitso testing account. To be able to test, your testing account must have funds.


Going to production?

When going to production, you need to repeat Step 4.i, providing your prod user ID. The testing and the production environments work the same way.

You also need to generate new API keys in your prod account.