PATCH
/
api
/
bank
/
accounts
/
{id}
curl --request PATCH \
  --url https://app.sandbox.rio.trade/api/bank/accounts/{id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "notes": "Notes"
}'
{
  "userId": "66562bc04fe8bf83c577c178",
  "createdAt": "2024-05-31T13:55:11.452Z",
  "bankName": "BANAMEX",
  "country": "MX",
  "accountHolderName": "Account holder name",
  "fiat": "USD",
  "accountNumber": "0123456789",
  "swiftCode": "BBVAESMMXXX",
  "CLABE": "0023764000000012345",
  "approved": true,
  "notes": "Bank Account",
  "advancedVerificationStatus": "initiated",
  "id": "6659d6bfd78151f639e74d53"
}

​
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

Path Parameters

​
id
string
required

Body

application/json
​
notes
string

Notes related to the bank account.

Response

200
application/json
OK
​
userId
string

Id of the user who updated the bank account.

​
createdAt
string

Creation date and time of the bank account.

​
bankName
string

Name of the bank.

​
country
enum<string>

Country of the bank.

Available options:
MX,
PE,
US
​
accountHolderName
string

Name of the account holder.

​
fiat
enum<string>

Fiat currency of the bank account.

Available options:
USD,
MXN,
PEN
​
accountNumber
string

Number of the bank account.

​
swiftCode
string

The SWIFT/BIC code associated with the bank account, used for international wire transfers.

​
CLABE
string

The Standardized Bank Code (CLABE) associated with the bank account, used in Mexico.

​
approved
boolean

Indicates if the bank account has been approved.

​
notes
string

Notes about the bank account.

​
advancedVerificationStatus
enum<string>

Advanced verification status of the bank account.

Available options:
initiated,
sent,
passed,
cancelled
​
id
string

Id of the updated bank account.

Delete a bank accountGet bank payment