​
Requirements to start the flow.

API key

Have an API key (Tutorial here).

​
Order flow

The process of buying stablecoins on Rio is done through the following steps:
1

Register the deposit crypto address

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

Go to create a new crypto address

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.

Go to create order

4

Wait for the order to be ready to accept payment.

Poll the order or subscribe to our webhooks. Wait for the order to have a status of awaitingPayment.

Go to check order status

5

Get payment instructions

The bank account and reference number can be unique per order, so this step must be called for each order.

Go to get bank payment details

6

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

Please send the amount specified in the amountFiat field of the order object to the bank account retrieved in the previous step. Do not forget to send the reference.
7

Confirm payment (optional)

This final step is only necessary if the payment is made in USD outside of the United States, or if the order was placed in our sandbox environment and you want to simulate a successful payment.

Go to confirm payment

8

Wait for funds

Rio will send the funds to your wallet 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.