Qué es Aloha

Aloha cobra pagos en línea en América Latina y guarda lo cobrado en una Billetera hasta que se ordena sacarlo. El pagador paga con los medios de pago que se usan en su país —hay cobro local en Argentina, Brasil, Chile, Colombia, México y Bolivia— o con tarjeta, que se liquida en USD. El dinero queda acreditado en la moneda de la cuenta, y desde ahí sale hacia una Cuenta Bancaria del propio comercio o hacia la de un tercero.

El dinero entra en una moneda y se acredita en otra

Esa sola frase explica casi todo lo demás. Una Solicitud de Pago se cobra en la moneda del pagador y se acredita en la moneda de la Billetera, así que en medio hay un cambio de moneda, y ese cambio deja tres marcas visibles:

• Hay una Tasa de Cambio, y la que resulta de la operación no es la tasa de referencia del mercado. La Comisión por cambiar de moneda tiene su propio porcentaje y se calcula sobre el monto, pero nunca se presenta como una línea aparte: por eso la tasa que se deduce de la operación sale ya cargada con ella.
• Hay una Comisión sobre el cobro, y se descuenta después del cambio. Lo que llega a la Billetera es menor que el resultado de la conversión.
• Una Solicitud de Pago tiene dos montos: el que paga el pagador y el que recibe la cuenta. Al crearla se elige cuál de los dos queda fijo —el campo amount_type— y el otro se calcula con la tasa del momento. Cuando las dos monedas coinciden, un cobro en USD contra una Billetera en USD, no hay nada que elegir y el campo no cambia nada.

Un cobro en la misma moneda de la Billetera se ahorra el cambio y la elección; la Comisión sobre el cobro sigue estando.

Dos lectores, y el mismo dinero debajo

El comercio opera desde el panel: crea Solicitudes de Pago, sigue los Pagos Recibidos, mira el Saldo y sus Movimientos de Saldo, y ordena Retiros y Envíos.

Quien integra hace la parte del cobro desde la API: crea Solicitudes de Pago, las consulta, las cancela, cotiza una conversión antes de decidir un precio y registra webhooks para enterarse de lo que pasa sin tener que preguntar.

No son dos productos. Una Solicitud de Pago creada desde el panel y otra creada por la API son la misma cosa: se cobran igual, se acreditan igual, y la API puede consultar y cancelar las que se crearon desde el panel, siempre que pertenezcan al usuario dueño de la Clave API. Por eso esta documentación describe el producto una sola vez, en «Conceptos», y deja para «Usar la API» lo que solo aplica a quien integra.

Antes de cobrar hay que verificar la cuenta

Crear un cobro exige las dos verificaciones de la cuenta: Verificar Identidad, que es sobre la persona, y Verificación Comercial, que es sobre la empresa. Mientras falte cualquiera de las dos, la creación se rechaza, desde el panel y desde la API por igual. Consultar y cancelar lo que ya existe sigue funcionando.

Es la primera piedra con la que tropieza una integración nueva, y conviene saber leerla: no es un problema de la Clave API. La clave es válida; la cuenta todavía no.

Seguir por aquí

• El recorrido del dinero — la secuencia completa, de la Solicitud de Pago al Retiro, en orden.
• Glosario — qué significa cada palabra que usa el producto.
• Solicitudes de Pago — la primera parada del recorrido, y lo que se decide al crear un cobro.
• Verificación de la cuenta — las dos verificaciones, qué desbloquea cada una y qué deja de funcionar sin ellas.
• Inicio rápido — para quien integra: de una Clave API a un cobro, en cuatro llamadas.