Comisiones
Aloha cobra una Comisión por operación. No hay una sola: hay una familia, cada una atada a un momento del recorrido, y lo que las distingue no es tanto el porcentaje como de dónde sale el dinero para pagarlas. Esta página es sobre eso: dónde se aplica cada una, quién la absorbe y cómo se ve después en el Saldo.
Los porcentajes concretos no están aquí a propósito, porque dependen de cada cuenta y cambian. Se consultan en el panel y, para la parte de las salidas, con la operación que está al final.
Dónde se aplica una Comisión
| Momento | Qué se cobra | De dónde sale |
|---|---|---|
| Cobro | La Comisión del cobro | Se descuenta de lo que se acredita, salvo que la absorba el pagador |
| Cambio de moneda | La Comisión por cambiar de moneda | Depende del cobro; en una salida, del monto que sale |
| Retiro | La Comisión del Retiro, más la del Retiro Instantáneo si lo es | Del monto que sale de la Billetera |
| Envío | La Comisión del Envío | Del monto que sale de la Billetera |
Hay además un impuesto sobre las salidas, que no todas las cuentas tienen. No es una Comisión, pero se descuenta en el mismo sitio y del mismo monto, así que a efectos de cuentas conviene leerlo junto con ellas.
Las dos filas del medio se parecen menos de lo que sugiere la tabla, y la de las salidas es la más fácil de leer al revés: en un Retiro o un Envío, el monto que se ordena es el que sale de la Billetera, y las Comisiones se descuentan de él. No se suman por encima. Quien ordena una salida de mil ve bajar mil de su Billetera, y quien recibe al otro lado recibe menos de mil, porque por el camino se descontaron la Comisión, el impuesto si lo hay y la conversión si la hay.
Una Comisión puede ser un porcentaje, un importe fijo o las dos cosas
Una Comisión se configura por cuenta, y su forma no es la misma en todas: puede ser un porcentaje sobre el monto, un importe fijo por operación, o las dos cosas sumadas. Algunas llevan además un mínimo y un máximo, que acotan el resultado por abajo y por arriba, de modo que un porcentaje pequeño sobre un monto grande deje de crecer a partir de cierto punto. Qué piezas están en juego depende de la Comisión y de la cuenta, y es otra razón para leer el número de la operación en vez de reconstruirlo.
Dos detalles que sorprenden a quien intenta reproducir el cálculo por su cuenta:
- En el cobro, la parte fija se configura en USD y se convierte a la moneda de la operación con la Tasa de Cambio del momento. Contra una Billetera que no sea USD, esa parte fija no es el mismo número dos días distintos, aunque nadie haya tocado la configuración.
- La Comisión del cobro puede depender del medio de pago. Una cuenta puede tener una configuración propia para un medio concreto, que tiene prioridad sobre la general. Y los cobros en USD tienen su propia configuración, separada de la de las monedas locales.
Copiar los porcentajes dentro de una integración para mostrar un desglose es quedarse con la foto de un día. Lo que se muestre al pagador conviene tomarlo del cobro, no de una constante.
La Comisión por cambiar de moneda
Existe solo cuando la moneda del pagador y la de la Billetera son distintas. En un cobro en la misma moneda es cero, y eso incluye a todos los cobros en USD de la API externa.
Tiene su propio porcentaje, aparte del de la Comisión del cobro, y se calcula sobre el monto. Pero nunca se le presenta al pagador como una línea separada: el checkout muestra una cifra a pagar y ya. De dónde sale depende de cuál de los dos montos se haya fijado al crear la Solicitud de Pago:
- Con
receive, que es el valor por omisión, el monto fijado es lo que recibe la Billetera. La Comisión por cambiar de moneda se añade por encima antes de convertir, así que acaba pagándola el pagador dentro de la cifra que ve. - Con
charge, el monto fijado es lo que paga el pagador, y no se le puede añadir nada. La Comisión se descuenta entonces de lo que se acredita, junto con la del cobro.
En una salida el orden es el otro: la Comisión por cambiar de moneda se descuenta del monto antes de aplicar la conversión, y el destinatario recibe el resultado.
De todo esto queda una consecuencia que vale más que el mecanismo: la tasa efectiva de una operación no coincide con la tasa de referencia del mercado, y es peor. Dividir lo que recibió el destinatario entre lo que salió de la Billetera no da la Tasa de Cambio de la operación: da esa tasa ya cargada con todo lo que se descontó por el camino. Es el número correcto para comparar entre proveedores y el número equivocado para auditar una Comisión.
Quién absorbe la Comisión del cobro se decide al crear la Solicitud de Pago
El campo customer_paid_fee es el que lo decide, y lo que hace en la práctica se ve mejor desde el Saldo: sin él, la Billetera recibe el Monto declarado menos la Comisión; con él, la Billetera recibe el Monto declarado entero y quien paga de más es el pagador. Las condiciones para poder usarlo —y lo que pasa si se manda sin tenerlo habilitado— están en Solicitudes de Pago.
Cuando la Comisión corre a cargo del pagador, se le emite un comprobante aparte por ella. Eso está en Pagos Recibidos, junto con los casos en que ese segundo comprobante no se manda.
Una Comisión no aparece como su propio Movimiento
Es lo que más desconcierta al cuadrar una Billetera por primera vez, así que conviene decirlo directamente: en la lista de Movimientos de Saldo no aparece una fila de Comisión. Lo que aparece es una fila por operación, y lo que la Comisión hizo está dentro de ese número o no está en la lista en absoluto.
- Un cobro en una moneda local deja una fila de entrada cuyo importe ya es el neto: lo que quedó después de la conversión y después de la Comisión. El bruto no aparece por ningún lado de la lista.
- Un Retiro o un Envío completado deja una fila de salida por el monto entero que salió de la Billetera, con la Comisión y el impuesto dentro.
- Un cobro en USD se comporta distinto y merece leerse dos veces: la fila de entrada trae el importe completo que llegó, y la Comisión se descuenta después, en un movimiento aparte que la lista del comercio no enseña. El Saldo baja por una operación que la lista no explica, y es correcto: es la Comisión de ese cobro.
En los tres casos el Movimiento dice cuánto se movió el Saldo, que es su trabajo, y no dice cuánto de eso fue Comisión. El desglose vive en el otro sitio: en el Pago Recibido o en el detalle de la salida, que guardan cada componente por separado y son lo que hay que mirar para responder «¿cuánto me cobraron por esto?». Buscar esa respuesta en la lista de Movimientos es buscarla donde no está.
En la API
La configuración de Comisiones de las salidas se consulta desde la API del panel, bajo /api/v1/clients, con el Permiso view_payouts o view_payins:
| Operación | Ruta |
|---|---|
| Comisiones de las salidas | GET /api/v1/clients/payouts/fee-configuration |
Trae la forma y el porcentaje de la Comisión del Retiro, el porcentaje adicional que cobra el Retiro Instantáneo y el impuesto sobre las salidas configurado para la cuenta. Es específica de la cuenta que consulta, y es la respuesta autorizada para esa parte.
No hay equivalente para el resto. Las Comisiones del cobro y la del cambio de moneda se consultan en el panel, que es donde están todas las de la cuenta juntas.
La API externa no tiene ninguna operación de Comisiones. Lo que sí tiene, y suele ser lo que se busca al llegar hasta aquí, es cotizar una conversión antes de decidir un precio, con POST /v1/conversions/quote y POST /v1/conversions/rate. Ninguna de las dos exige Permiso, como se ve en Autenticación y Claves API.
Relacionado
- Saldo y Movimientos — dónde acaba viéndose cada Comisión, y dónde no.
- Billeteras y monedas — cuándo hay conversión y cuándo no la hay.
- Solicitudes de Pago —
amount_typeycustomer_paid_fee, con sus condiciones. - Pagos Recibidos — el desglose de un cobro y los comprobantes del pagador.
- Glosario — la definición de cada término de esta página.
Updated 26 days ago
