Requirements to start the flow.

API key

Have an API key (Tutorial here).

Order flow

The process of selling stablecoins is done through the following steps:

1

Register the receiving bank account

Before creating an order, you need to register the bank account that will receive the funds. This only needs to be done once per bank account-currency pair.

Go to create a new bank account

2

Create a quote

You can create as many quotes as necessary before creating an order.

Go to create quote endpoint

3

Create order

Once you are satisfied with a quote, you can create an order for the quoted amount. Make sure to pass the ID for the bank account to which you would like to receive the funds through the payoutBankAccountId field.

Go to create order

4

Wait for the order to be ready to accept your payment

Poll the order or subscribe to our webhooks. Wait for the order to have a status of awaitingPayment. Remember to add the payoutBankAccountId field when creating the order in the previous step. Otherwise, the resulting status will be awaitingBankPayoutDetails.

Go to check order status

5

Pay for the order (skip if placing the order in our sandbox environment)

Please send the amount specified in the amountCrypto field of the order object to the address specified in the depositAddress field of the order.

Go to confirm payment

6

Confirm payment (optional)

This final step is only necessary to simulate a successful payment in our sandbox environment.

Go to confirm payment

7

Wait for funds

Rio will send the funds to your bank account in the next few minutes.

Poll order status or subscribe to webhooks

Go to check order status

Disclaimer: All technical documentation is subject to the terms and conditions, which apply supplementarily and take precedence over the documentation.