Cuenta bancaria USD
Una Cuenta Bancaria USD es una cuenta bancaria en Estados Unidos, a nombre de la empresa, con su propio número de cuenta y su propio número de ruta. Es una cuenta de verdad: esos números se le pueden dar a un tercero para que mande dinero a ella, y lo que llegue ahí llega a nombre del comercio.
Esa es toda la descripción que hace falta. Lo que conviene añadir es lo que cambia al tenerla, porque no es una Billetera más ni un ajuste de configuración: es una vía de entrada de dinero distinta de la local, con sus propios plazos y su propio riesgo.
Lo que permite, y que la vía local no permite
Son dos cosas, y las dos son entradas de dinero:
- Cobrar en USD. Sin esta cuenta, una Solicitud de Pago puede pedirse en cualquiera de las monedas locales pero no en dólares. El cobro en USD no se hace con un medio de pago local: el pagador autoriza un débito contra su cuenta bancaria, y eso necesita una cuenta al otro lado que lo reciba.
- Recibir transferencias. Cualquiera puede mandar dinero a esos números sin que medie ninguna Solicitud de Pago. Es el caso de una plataforma que liquida a sus vendedores, o de un cliente que paga por su cuenta. Ese ingreso se acredita entero: un depósito no lleva Comisión.
Lo que llega por cualquiera de las dos vías se acredita en la Billetera USD de la cuenta y produce un Pago Recibido, igual que un cobro local. El campo source distingue los dos orígenes —payment_link para lo cobrado con una Solicitud de Pago, deposit para lo recibido sin ella—, y las estadísticas de cobro dejan fuera los depósitos.
El dinero que hay ahí no sale por donde sale el resto
Conviene decirlo pronto porque es lo que más desconcierta: con el saldo de la Cuenta Bancaria USD no se ordena un Retiro ni un Envío. Las salidas hacia una cuenta bancaria propia o de un tercero se financian desde la Billetera local, y una orden contra la cuenta en dólares se rechaza. El rechazo además no la nombra, así que hay que reconocerlo por descarte.
La vía que sí existe es pasar ese saldo a la Billetera local, y eso es una conversión. Una vez convertido, el dinero está en la Billetera de siempre y se comporta como el resto: financia Retiros y Envíos sin nada especial.
Activarla es una verificación con documentos, no un interruptor
La cuenta tiene que estar habilitada para el comercio. Mientras no lo esté, las operaciones que la describen no responden datos vacíos: se rechazan antes, con 403 FEATURE_NOT_ENABLED.
Habilitarla no es marcar una casilla. Hay que aceptar un contrato específico para el servicio en dólares —distinto de los términos generales de la plataforma, y que solo puede aceptar la persona titular de la cuenta—, completar los datos que exige la revisión y enviarlos. Después hay una revisión externa que puede tardar y que puede pedir correcciones.
Los datos que se piden dependen de si el comercio es una empresa o una persona, y en el caso de una empresa alcanzan también a quienes son sus dueños:
- Una empresa declara su razón social, su forma jurídica, su identificador fiscal, la fecha de constitución, a qué se dedica, el volumen mensual que espera mover, un teléfono y su domicilio —y el domicilio operativo aparte, si no coincide con el registrado—. Además tiene que declarar al menos un beneficiario final y una persona con control, cada uno con su fecha de nacimiento, su correo, su identificador fiscal y su domicilio completo, y adjuntar un comprobante de domicilio.
- Una persona declara nombre y apellidos, fecha de nacimiento, correo, teléfono, identificador fiscal y domicilio, más el país de ciudadanía cuando el tipo de identificador fiscal lo exige. Aquí no se pide comprobante de domicilio.
Antes de enviar nada se puede consultar qué falta: hay una operación que responde si los datos están completos y, si no lo están, la lista de lo que queda pendiente. Es la comprobación que conviene hacer primero, porque enviar con datos incompletos se rechaza sin llegar a la revisión.
Esta verificación es aparte de Verificar Identidad y de la Verificación Comercial que Aloha pide para operar. Tener aquellas hechas no adelanta esta, y viceversa: son trámites distintos, con datos distintos y con revisiones distintas.
Lo que pasa después de enviar
La solicitud queda en revisión. A partir de ahí hay cuatro desenlaces posibles y no todos se corrigen igual:
| Situación | Qué se puede hacer |
|---|---|
| En revisión | Corregir los datos enviados y volver a mandarlos, mientras siga en revisión |
| Aprobada | Ya no se edita desde aquí. La cuenta queda operativa |
| Rechazada | Se corrige y se vuelve a enviar |
| Suspendida | No se resuelve solo: hay que hablar con soporte |
Las correcciones tienen un límite que conviene conocer de antemano, porque no es evidente: los datos de la empresa se corrigen en el sitio, pero añadir o quitar un beneficiario final no se puede. Corregir los datos de uno que ya está declarado, sí. Y un documento que la revisión vuelva a pedir se sube y se adjunta con una operación propia, no se manda otra vez con el formulario.
Hasta que la solicitud se aprueba no hay cuenta bancaria, y la operación que devuelve sus datos no devuelve una cuenta vacía: no devuelve ninguna. La cuenta se abre al aprobarse, y sus números y su saldo aparecen cuando queda operativa. En el hueco entre una cosa y la otra el saldo viene vacío en lugar de venir en cero, y un saldo vacío ahí no es un saldo de cero.
Cuando la cuenta queda activa, Aloha lo avisa por correo a la dirección configurada en la cuenta —y no lo manda si las notificaciones por correo están desactivadas o si no hay dirección—. Es el único aviso que Aloha manda en todo el trámite: un rechazo y una suspensión no lo tienen, y los dos hay que ir a mirarlos.
Un cobro en USD puede devolverse después de haberse acreditado
Es la contrapartida de esta vía y no tiene equivalente en las monedas locales, así que vale la pena repetirla aquí aunque esté contada entera en Pagos Recibidos: un débito bancario en dólares tarda en liquidar, y cuando liquida el dinero entra en la Billetera. Pero el banco del pagador todavía puede revertirlo después. Cuando eso pasa, Aloha descuenta el importe, el Saldo disponible puede quedar en negativo, y no se avisa por ningún canal: ni correo, ni notificación, ni webhook.
Lo mismo vale para una transferencia recibida sin Solicitud de Pago: también puede volverse atrás después de acreditada, con el mismo descuento y el mismo silencio.
La consecuencia práctica es la misma en los dos casos, y es de las que se pagan caras: conciliar los ingresos en dólares corre por cuenta del comercio, y quien entregue bienes o servicios contra uno tiene un motivo para no darlo por cerrado el mismo día en que se acredita.
En la API
Desde la API externa no hay ninguna operación de Cuenta Bancaria USD. Lo que sí hay es la consecuencia de tenerla o no tenerla, al crear una Solicitud de Pago en dólares:
| Operación | Ruta |
|---|---|
| Crear una Solicitud de Pago | POST /v1/payment-links |
Con currency en USD, esa llamada comprueba primero que la cuenta pueda cobrar en dólares. Si no puede, responde 422 USD_ACCOUNT_NOT_ENABLED y no llega a crear nada. Es una comprobación previa deliberada: sin ella se crearía un cobro que el pagador no podría completar nunca, porque la vía local no ofrece ningún medio de pago en dólares.
Ese 422 no distingue entre «todavía no se solicitó», «está en revisión» y «se rechazó». Las tres cosas responden lo mismo, y en qué punto está la solicitud se mira en el panel.
Desde la API del panel, bajo /api/v1/clients, están las operaciones con las que el panel monta la pantalla:
| Operación | Ruta |
|---|---|
| Datos de depósito y saldo | GET /api/v1/clients/usd-wallet |
| Si los datos están completos, y qué falta | GET /api/v1/clients/usd-account/preview |
| Guardar los datos de la empresa | POST /api/v1/clients/usd-account/business-data |
| Guardar los datos de la persona | POST /api/v1/clients/usd-account/individual-data |
| Subir un documento | POST /api/v1/clients/usd-account/documents |
| Enviar la solicitud | POST /api/v1/clients/usd-account/activate |
| Corregir los datos enviados | PATCH /api/v1/clients/usd-account/legal-entity |
Ninguna de ellas exige un Permiso concreto: lo que exigen es tener la cuenta habilitada, y sin eso responden 403 FEATURE_NOT_ENABLED. Las dos últimas exigen además el contrato del servicio en dólares aceptado. Hay más operaciones de las que aparecen aquí —listar y borrar documentos, corregir a una persona declarada, adjuntar un documento que la revisión vuelva a pedir—, y todas viven bajo el mismo prefijo.
Esa API es la que usa el panel; no es una superficie de integración y no se documenta aquí. Se nombra para poder emparejar lo que se ve en pantalla con la operación que hay detrás.
Relacionado
- Conversiones USD — cómo pasa ese saldo a la Billetera local, y qué se cotiza antes.
- Pagos Recibidos — el cobro devuelto después de acreditarse, entero y con sus rastros.
- Billeteras y monedas — en qué Billetera cae cada cobro y por qué no se elige.
- Retiros — la salida que esta cuenta no financia.
- Solicitudes de Pago — lo que se decide al crear un cobro, en dólares o en moneda local.
- Glosario — la definición de cada término de esta página.
Updated 26 days ago
