US bank accounts

Activate and query the USD account that Colurs enables for your user. This is the account where they can receive USD deposits; once activated, you get the details (routing, account number) to display in your app.

All endpoints require authentication with Authorization: Bearer [TOKEN] and x-api-key.

USD Account Activation Flow

1. Enable the USD account

Call PATCH /profile/wallet-visibility with wallet_info_enabled: true. The system creates the user and the USD wallet if they do not exist.

2. Get account details

Call GET /usd/user/wallet to get the account number, routing (wire and ACH), and other details of the account where the user will receive USD deposits.

3. Show in your app

Consume the response data and display it in your UI so the user knows where to send deposits. Once the transaction is confirmed, the balance is credited automatically.

Endpoints

Enable USD wallet (activate account)

Enables the USD account assigned by Colurs to the user. It creates the user and USD wallet if they do not exist yet.

Enable USD account

Authorizations

Both x-api-key and Authorization: Bearer <token> headers are required.

Endpoint

PATCHhttps://dev.backend.colurs.co/profile/wallet-visibility

Required Headers

Content-Type: application/jsonAccept: application/jsonx-api-key: [API_KEY]Authorization: Bearer [ACCESS_TOKEN]

Request Body

Field	Type	Required	Description
wallet_info_enabled	boolean	✓	Must be true to enable the USD wallet

request.json{
"wallet_info_enabled": true
}

cURL Example

curl -X PATCH "https://dev.backend.colurs.co/profile/wallet-visibility" \
-H "Authorization: Bearer [ACCESS_TOKEN]" \
-H "x-api-key: [API_KEY]" \
-H "Content-Type: application/json" \
-d '{"wallet_info_enabled": true}'

Response

response.json

200 OK — updates profile and enables USD wallet

If this is the first time, the system creates the user and associated USD wallet. On later calls, it only updates visibility.

Get account details to receive deposits

Returns details of the enabled USD account (routing, account number) so you can consume and display them in your app. The user or their clients can send USD to that account, and the balance is credited automatically.

Get USD account details

Authorizations

Both x-api-key and Authorization: Bearer <token> headers are required.

Endpoint

GEThttps://dev.backend.colurs.co/usd/user/wallet

Required Headers

Content-Type: application/jsonAccept: application/jsonx-api-key: [API_KEY]Authorization: Bearer [ACCESS_TOKEN]

cURL Example

curl -X GET "https://dev.backend.colurs.co/usd/user/wallet" \
-H "Authorization: Bearer [ACCESS_TOKEN]" \
-H "x-api-key: [API_KEY]"

Response

response.json

{
"wallet_name": "user@example.com Wallet",
"wallet_id": "wlt_xyz123",
"rtp_account": "1234567890",
"rtp_routing": "021000021",
"wire_account": "9876543210",
"wire_routing": "026009593",
"ach_account": "5555555555",
"ach_routing": 
"011000015"}

Use these details (account number, routing) in your app so users know where to send USD deposits.

🔒

Sensitive data is stored encrypted on the server. The API returns it only to authorized clients (JWT + x-api-key).

📄

To fund USD (full funding flow), see USD Wallet in the Funding section. For withdrawals from USD balance, see Bank withdrawals or Mexico withdrawals (MXN) depending on destination.

Colombia bank accounts Cuentas Mxn