Retiros

Un Retiro saca dinero de una Billetera hacia una Cuenta Bancaria del propio comercio. Es la salida que devuelve el dinero a su dueño: cambia de sitio, no de titular.

Si la cuenta que recibe no es del comercio, esta no es la página. Pagar a un proveedor, a un empleado o a un cliente es un Envío a terceros: mismo motor, mismo Saldo y misma reserva, con un destinatario registrado aparte y un paso más para confirmarlo.

Instantáneo y Regular se eligen al ordenarlo, y no se cambian después

Un Retiro nace de uno de los dos tipos y se queda con él: no hay ninguna operación que lo convierta en el otro ni que lo modifique después de creado.

Lo que cambia entre los dos es el precio. Sobre la Comisión del Retiro, que es la misma para ambos, el Instantáneo suma un porcentaje adicional propio, configurado por cuenta. El detalle de cómo se compone y de dónde sale está en Comisiones.

Lo que no cambia conviene decirlo entero, porque es casi todo: los dos salen de la misma Billetera, exigen la misma Cuenta Bancaria verificada, reservan el monto igual, pasan por los mismos Estados y se miden contra el mismo mínimo. Y el plazo estimado que se puede consultar antes de ordenarlo depende de la ruta de destino, no del tipo.

Hay una condición más que tampoco depende del tipo, sino de la Billetera que paga: no todas pueden financiar un Retiro. La Cuenta Bancaria USD es el caso a tener presente, porque aparece con su propio saldo en el inventario de Billeteras que describe Billeteras y monedas y es fácil leerla como una más. Ese dinero está en esa cuenta bancaria, no en una Billetera de las que pagan Retiros, y ordenar uno contra ella se rechaza. Conviene saberlo de antemano, porque ese rechazo no viene traducido y tampoco la nombra: hay que reconocerlo por descarte.

Hay además un tercer origen que no se ordena a mano: el Retiro automático. Una cuenta puede pedir que su Saldo disponible salga solo, cada día, cada semana o cada dos semanas, y esa frecuencia se configura en el panel. Cuando está activo, el Retiro que se crea es siempre Regular, sale siempre hacia la Cuenta Bancaria marcada como predeterminada, y se crea uno por cada Billetera que pueda financiar un Retiro y tenga Saldo disponible, arrastrando todo lo disponible de cada una y no una parte. Dos cosas lo dejan sin efecto en silencio: que la cuenta no tenga una Cuenta Bancaria predeterminada verificada, y que lo disponible no llegue al mínimo. En ninguno de los dos casos se avisa.

La Cuenta Bancaria tiene que estar verificada, y eso vale para los dos tipos

Registrar una Cuenta Bancaria no alcanza para poder retirar a ella. La comprobación que hace Aloha antes de crear el Retiro es doble: la cuenta tiene que estar verificada y tiene que estar activa. Una recién cargada, una que esté en revisión y una que haya sido rechazada fallan igual.

Y fallan mal, que es la parte que hay que saber de antemano: este rechazo no llega como un error que nombre el problema, sino como un error genérico de la operación. Si un Retiro falla sin explicación, lo primero que conviene mirar es el Estado de la Cuenta Bancaria elegida, porque el mensaje no lo va a decir.

Conviene leerlo dos veces, porque la regla es más ancha de lo que suele suponerse: la comprobación es exactamente la misma para los dos tipos y para los dos orígenes, manual o automático. Sin una Cuenta Bancaria verificada y activa no sale ningún Retiro, por mucho Saldo que haya.

Verificar la cuenta bancaria es un trámite aparte de Verificar Identidad y de la Verificación Comercial, que también hacen falta: ordenar un Retiro las exige a las dos, y sin ellas la operación se rechaza antes de mirar siquiera la Cuenta Bancaria.

Queda una última condición que no depende de los datos sino del estado de la cuenta: Aloha puede tener los Retiros deshabilitados para ella, o la cuenta entera en pausa. En los dos casos el rechazo llega con un mensaje que lo dice y remite a soporte, y no hay nada que corregir en la solicitud: lo que hay que resolver está fuera de ella.

El mínimo depende del destino, y se comprueba sobre lo que queda

No hay un mínimo único. Lo fija la ruta por la que sale el dinero —el país de la Cuenta Bancaria que recibe— y la comprobación se hace en la moneda de la Billetera que paga, así que dos Retiros de la misma cuenta pueden tener mínimos distintos.

De ahí sale la trampa, que es de las que solo se descubren cuando falla: el mínimo no se compara contra el monto que se ordena, sino contra el que queda después de descontar las Comisiones y el impuesto. Ese resto sigue expresado en la moneda de la Billetera —se mide antes de convertir, no sobre lo que acaba recibiendo la cuenta destino—, y pedir exactamente el mínimo devuelve un error de monto insuficiente, porque después de los descuentos queda algo menos. El error trae el mínimo exigido, la moneda y lo que se intentó, que es lo que hace falta para corregirlo.

Antes de ordenar nada se puede simular la operación entera: cuánto se descuenta, a cuánto se convierte, qué recibe la cuenta destino y cuál es el mínimo, ya expresado en la moneda de la Billetera que paga. Esa simulación es la forma fiable de comprobarlo; hay además una operación que responde solo el mínimo, con una salvedad que está al final.

Los Estados, y que ordenarlo no es enviarlo

Un Retiro recorre cuatro Estados y no vuelve atrás:

La parte que sorprende es la primera. Crear el Retiro no lo envía: queda en Solicitado y lo recoge un proceso que corre cada pocos minutos. El hueco es corto, pero existe, y explica por qué un Retiro recién creado todavía no aparece como Procesando.

Ese hueco no es una ventana para arrepentirse: no hay ninguna operación para cancelar un Retiro. Una vez ordenado solo termina por sí mismo, en Completado o en Fallido.

Mientras está en curso, el monto está reservado

Al crear el Retiro, su monto sale del Saldo disponible y pasa a estar reservado. Sigue dentro del Saldo de la Billetera y ya no puede comprometerse en otra salida. Cómo funciona esa reserva, y por qué no deja ninguna fila en la lista de Movimientos de Saldo, está en Saldo y Movimientos.

Lo que hay que retener aquí es cómo se resuelve:

• Al completarse, la reserva se suelta y el Saldo baja. Ahí sí aparece el Movimiento de Saldo, por el monto entero que salió de la Billetera, con la Comisión y el impuesto dentro.
• Al fallar, la reserva se suelta y el monto vuelve al disponible. El Saldo nunca se movió, así que tampoco hay Movimiento que escribir.

Por eso un Retiro fallido no deja rastro en la lista de Movimientos. Lo que cuenta lo que pasó es el Retiro mismo, con su Estado y su motivo.

Qué pasa cuando falla

Un Retiro puede fallar al intentar enviarlo o más tarde, si la cuenta destino lo rechaza. En los dos casos ocurre lo mismo y en este orden: el Retiro queda en Fallido con el motivo escrito, el monto reservado vuelve al Saldo disponible, y se manda un correo a la dirección de notificaciones de la cuenta.

Ese correo dice cuánto se intentó, cuál fue el motivo y qué hacer: corregir los datos y volver a solicitarlo, o escribir a soporte. La dirección de soporte que aparece ahí es siempre la de Aloha. Vale la pena decirlo porque el motivo de un rechazo no siempre lo redacta Aloha, y un texto ajeno puede venir firmado con un buzón ajeno: esas direcciones se sustituyen antes de que el mensaje salga. La cuenta a la que hay que escribir por un Retiro de Aloha es la de Aloha, que es la única que puede identificarlo.

El motivo se guarda con el Retiro, así que también se lee en su detalle y en las exportaciones, no solo en el correo.

En la API

Los Retiros se ordenan y se consultan desde la API del panel, bajo /api/v1/clients:

Al ordenar uno se manda el tipo en type, que vale instant o regular, la Cuenta Bancaria en bank_account_id, la Billetera que paga en virtual_wallet_id, el monto en amount y una descripción en comment, obligatoria y de entre cinco y cincuenta caracteres. El tercer valor que acepta type es transfer, y ese no es un Retiro: es un Envío, pide beneficiary_id en lugar de bank_account_id y no termina en esta llamada.

min-amount acepta destination_country para preguntar por el mínimo de la ruta que de verdad se va a usar. Si se omite, responde el del país de la propia cuenta, que en un Retiro al extranjero es el mínimo equivocado.

Y con destination_country puesto trae una salvedad que hay que tener presente: responde en la moneda del destino, no en la de la Billetera que paga, y lo dice en su campo currency. Sobre una Billetera en CLP pagando a Brasil, ese número viene en reales, mientras que la comprobación al crear el Retiro se hace en pesos chilenos. Sirve para saber que la ruta tiene un piso; no sirve para compararlo con el monto que se va a ordenar. El número comparable es el min_payout_amount que devuelve payouts/calculator, que sí viene en la moneda de la Billetera.

El comprobante se entrega como una dirección firmada y temporal, no como un archivo. Si el Retiro es reciente puede que todavía se esté generando, y la respuesta lo dice en vez de fallar.

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. La API externa no ordena Retiros: cubre el cobro y termina en la Billetera.

Relacionado

• Envíos a terceros — la misma salida cuando la cuenta que recibe no es del comercio.
• Beneficiarios — a quién se le puede enviar dinero, y qué datos hace falta registrar antes.
• Saldo y Movimientos — la reserva, y por qué el disponible baja sin dejar fila.
• Comisiones — qué se descuenta del monto que sale, y por qué el destino recibe menos.
• Billeteras y monedas — de qué Billetera sale el dinero y en qué moneda.
• Glosario — la definición de cada término de esta página.