​
Requirements to start the flow.

API key

Have an API key (Tutorial here).

​
Order flow

The process of placing a T+n order is very similar to the process of placing a regular order, but with the addition of a few steps. In this guide, we will go through the process of placing a T+1 buy order.
Disclaimer: Settlement does not imply custody or receipt of funds before the order is executed on the date specified in the settlement details.
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

When creating a T+n order, you need to specify the number of days until the order is settled. This is done by setting the twoWaySettlementType body parameter of the request to TPlusOffset and the twoWaySettlementDateOffset parameter to the number of business days until the order is settled. For example, if you want to place a T+0 buy order, you need to set the twoWaySettlementDateOffset field to 0 and if you want to place a T+1 buy order, you need to set the twoWaySettlementDateOffset field to 1, etc. Keep in mind that banking hours and holidays may cause the effective settlement date to be different than what you expected. Please always confirm the twoWaySettlementDate field of the quote to get the effective settlement date and make sure it matches your expectation 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. After this, you have until the payment due date (specified in the paymentInstructions field of the order) to pay for the order.

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 amountFiat field of the order object to the bank account specified in the paymentInstructions field of the order. Do not forget to send the reference.
6

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

7

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.