Antes de empezar
- Habilita el Fees Engine en la configuración del módulo de Midaz.
- Necesitas un Ledger existente y al menos una Cuenta que pueda recibir montos de comisión.
- Si el paquete debe aplicarse solo a una ruta o segmento específico, crea esos registros primero.
Crear el Fee Package
1
Ve a la página Fee Packages y haz clic en el botón New Package.
2
Se abrirá el formulario New Fee Package con varias secciones para configurar.
1
Completa la sección Basic Information
2
Configura la sección Amount Range
Las Transacciones fuera de este rango no tendrán comisiones aplicadas desde este paquete.
3
Haz clic en el botón Next.
4
Selecciona una de las opciones en la sección Add Fee:
Flat Fee- Monto fijo sin importar el valor de la transacción.Percentage- Porcentaje del monto de la transacción.Max Between Types- El valor más alto entre el fijo y el porcentual.
5
Agrega la información de la comisión.
6
(Opcional) Puedes agregar otra regla de comisión si es necesario. Para hacerlo, selecciona un nuevo tipo de comisión y completa la información.
7
Haz clic en el botón Next.
8
(Opcional) Configura la sección Account Waivers:
- Agrega los alias de cuenta que deben quedar exentos de comisiones en este paquete
- Haz clic en Add para agregar cada cuenta exenta
9
Haz clic en el botón Next.
10
Revisa la información y confirma que todo sea correcto.
11
Haz clic en el botón Create Package.
Guía de campos
Basic Information
Reglas de comisión
Cada comisión dentro de un paquete tiene una Priority (1 = se aplica primero). La comisión con prioridad1 debe usar Original Amount como Reference Amount.
Flat Fee
Un monto fijo aplicado a la Transacción sin importar su valor.Cuando habilitas Deductible from transaction?, el formulario fuerza Reference Amount a
Original Amount y deshabilita la opción After Fees Amount.Percentage Fee
Un porcentaje del monto de la Transacción.Max Between Types
Calcula un monto fijo y un porcentaje, y luego aplica el resultado más alto. El formulario requiere ambos cálculos.El formulario Max Between Types siempre requiere exactamente dos cálculos: uno de tipo
Flat Fee y otro de tipo Percentage Fee. La Console calcula ambos y aplica el más alto.Account Waivers
Notas importantes
Orden de prioridad de comisiones
Cuando un paquete contiene varias comisiones, la Console las aplica en orden de prioridad (el número más bajo primero). Esto es relevante cuando usasAfter Fees Amount como referencia, ya que las comisiones anteriores afectan la base de cálculo de las comisiones posteriores.
Ejemplo:
- Comisión A (Priority 1): 1% sobre el monto original
- Comisión B (Priority 2): 0.5% sobre el monto después de comisiones
- Comisión A = $1.00 (1% de $100)
- Comisión B = $0.495 (0.5% de $99)
Consideraciones sobre el rango de montos
- Los rangos no deben superponerse entre paquetes para la misma ruta de transacción
- Usa
0.01como mínimo para paquetes que deben aplicarse a todas las transacciones - Usa un máximo alto (por ejemplo,
999999999.99) para no tener límite superior - El rango incluye las Transacciones que están exactamente en los valores mínimo o máximo
Comportamiento de las cuentas exentas
- Las cuentas exentas omiten todas las comisiones del paquete, no solo comisiones específicas
- Usa alias de cuenta (no IDs) al agregar cuentas exentas
- Las exenciones se aplican cuando la cuenta exenta es el origen de la transacción
Qué hacer después
Después de crear el Fee Package, ejecuta un cálculo de prueba en Ejecutar una Fee Estimation antes de usarlo con Transacciones reales.