Cuentas bancarias EEUU

Activa y consulta la cuenta en dólares (USD) que Colurs habilita para tu usuario. Es la cuenta donde puede recibir depósitos en USD; una vez activada, obtienes los datos (routing, número de cuenta) para mostrarlos en tu app.

Todos los endpoints requieren autenticación con Authorization: Bearer [TOKEN] y x-api-key.

Flujo para activar la cuenta USD

1. Habilitar la cuenta USD

Llama a PATCH /profile/wallet-visibility con wallet_info_enabled: true. El sistema crea el usuario y la wallet USD si no existen.

2. Obtener datos de la cuenta

Llama a GET /usd/user/wallet para obtener el número de cuenta, routing (wire y ACH) y demás datos de la cuenta donde el usuario recibirá depósitos en USD.

3. Mostrar en tu app

Consume los datos de la respuesta y muéstralos en tu interfaz para que el usuario sepa a qué cuenta enviar sus depósitos. Una vez confirmada la transacción, el saldo se acredita automáticamente.

Endpoints

Habilitar wallet USD (activar cuenta)

Habilita la cuenta USD que Colurs asigna al usuario. Crea el usuario y la wallet en el marketplace USD si aún no existen.

Habilitar cuenta USD

Autorización

Se requieren el header x-api-key y Authorization: Bearer <token>.

Endpoint

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

Headers Requeridos

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

Request Body

Campo	Tipo	Requerido	Descripción
wallet_info_enabled	boolean	✓	Debe ser true para habilitar la wallet USD

request.json{
"wallet_info_enabled": true
}

Ejemplo cURL

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}'

Respuesta

response.json

200 OK — actualiza el perfil y habilita la wallet USD

Si es la primera vez, el sistema crea el usuario en el marketplace USD y la wallet asociada. En llamadas posteriores solo actualiza la visibilidad.

Obtener datos de la cuenta para recibir depósitos

Devuelve los datos de la cuenta USD habilitada (routing, número de cuenta) para que los consumas y muestres en tu app. El usuario o sus clientes pueden enviar USD a esa cuenta y el saldo se acredita automáticamente.

Consultar datos de la cuenta USD

Autorización

Se requieren el header x-api-key y Authorization: Bearer <token>.

Endpoint

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

Headers Requeridos

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

Ejemplo cURL

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

Respuesta

response.json

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

Usa estos datos (account number, routing) para mostrarlos en tu app y que el usuario sepa a qué cuenta enviar sus depósitos USD.

🔒

Los datos sensibles se guardan encriptados en el servidor. La API los devuelve solo al cliente autorizado (JWT + x-api-key).

📄

Para recargar USD (flujo completo de fondeo), consulta Wallet USD en la sección Fondeo. Para retiros desde el balance USD, consulta Retiros Bancarios o Retiros México (MXN) según el destino.

Cuentas bancarias Colombia Cuentas Mxn