Requirements to start the flow.

Broker account

You must have a broker account (Tutorial here)

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 necesarry 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

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 necesarry if the payment is done in USD outside of the United States.

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