Buy stablecoins
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:
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
Create a quote
You can create as many quotes as necessary before creating an order.
Go to create quote endpoint
Create order
Once you are satisfied with a quote, you can create an order for the quoted amount.
Go to create order
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
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
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.
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
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.