Recargar USD

Endpoints para habilitar tu wallet USD y obtener los datos de la cuenta donde recibirás depósitos en dólares. Una vez habilitada, la API te devuelve el account number y routing para que los consumas y muestres en tu app — así tus usuarios pueden enviar USD a esa cuenta y el saldo se acredita automáticamente.

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

Resumen de endpoints

Endpoint	Método	Descripción
`/profile/wallet-visibility`	PATCH	Habilitar wallet USD (crea usuario y wallet si no existen)
`/usd/user/wallet`	GET	Obtener datos de la cuenta para recibir depósitos (wire, ACH, routing)

Flujo para recargar USD

Paso 1: Habilitar wallet USD

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

Paso 2: Obtener datos de la cuenta

Llama a GET /usd/user/wallet para obtener el account number, routing (wire y ACH) y demás datos de la cuenta donde recibirás depósitos.

Paso 3: Mostrar en tu app

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

Paso 1: Habilitar wallet USD

Autorización

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

Endpoint

PATCH/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	✓	Habilita visibilidad de la wallet USD

request.json{
"wallet_info_enabled": true
}

Respuesta

response.json

200 OK — actualiza el perfil

Crea tu usuario en el marketplace USD si no existe y tu wallet USD si no existe.

Paso 2: Obtener datos de la cuenta para recibir depósitos

Autorización

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

Endpoint

GET/usd/user/wallet

Headers Requeridos

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

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 tus usuarios sepan a qué cuenta enviar sus depósitos USD.

🔒

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

Resumen

Para recargar USD solo necesitas 2 endpoints:

PATCH /profile/wallet-visibility → Habilita tu wallet USD (crea usuario y wallet si no existen).
GET /usd/user/wallet → Obtén los datos de la cuenta (wire, ACH, routing) para mostrarlos en tu app y recibir depósitos.

Una vez confirmada la transacción, el saldo se acredita automáticamente en tu wallet USD.

Depósitos México (MXN)Cómo realizar pagos y retiros