POST
/
api
/
payments
/
crypto
/
bulk
curl --request POST \
  --url https://app.sandbox.rio.trade/api/payments/crypto/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "crypto": "USDC",
  "country": "MX",
  "userId": "6757546b4c5d19bf3cd7b09c"
}'
{
  "createdAt": "2025-01-04T01:37:25.259Z",
  "userId": "6757546b4c5d19bf3cd7b09c",
  "orderIds": [],
  "amount": 0,
  "orderIdsPaid": [],
  "crypto": "USDC",
  "country": "MX",
  "status": "awaitingPayment",
  "depositAddress": "5BZDQjWad45rT1vYT5KdJHgSU4rWXL1Y5nDoTwSrT8Pr",
  "id": "677890d5d520f9ecb10e9c33"
}

​
Requirements to consume the endpoint.

Create and modify role

The user must have the role to create and modify.

User approved

The user must be approved in at least one country.

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
crypto
enum<string>

The type of cryptocurrency involved in the order

Available options:
USDC,
USDC_POLYGON,
USDC_POLYGON_NXTB,
SOL_USDC_PTHX,
USDT_POLYGON,
USDT_ERC20,
TRX_USDT_S2UZ
​
country
enum<string>

The country of the user

Available options:
MX,
PE,
US
​
userId
string

The unique identifier of the user

Response

201 - application/json
Created
​
createdAt
string

The date and time the order was created

​
userId
string

The unique identifier of the user

​
orderIds
string[]

List of order IDs associated with the user

​
amount
number

The total amount of the orders

​
orderIdsPaid
string[]

List of order IDs that have been paid

​
crypto
enum<string>

The type of cryptocurrency involved in the order

Available options:
USDC,
USDC_POLYGON,
USDC_POLYGON_NXTB,
SOL_USDC_PTHX,
USDT_POLYGON,
USDT_ERC20,
TRX_USDT_S2UZ
​
country
enum<string>

The country of the operation

Available options:
MX,
PE,
US
​
status
enum<string>

The current status of the bulk crypto payment

Available options:
awaitingDepositAddress,
awaitingPayment,
complete,
failed,
cancelled,
insufficientAmountReceived,
excessAmountReceived
​
depositAddress
string

The deposit address for the order

​
id
string

The unique identifier of the bulk crypto payment

Confirm crypto paymentGet bulk crypto payment