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
Define Minimum Amount y Maximum Amount en la misma sección.
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 Fee - 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.Account Waivers
Prioridad, rangos y cuentas exentas
Orden de prioridad de comisiones
Cuando un paquete contiene varias comisiones, Midaz las aplica en orden de prioridad (el número más bajo primero). Con After Fees Amount como referencia, las comisiones anteriores afectan la base de cálculo de las comisiones posteriores. Ejemplo:- Comisión A (Priority 1): 1% sobre el monto original, no deducible
- 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.505 (0.5% de $101)
Consideraciones sobre el rango de montos
- Midaz rechaza un paquete cuyo rango se superpone con el de otro paquete con la misma ruta de transacción y el mismo segmento
- 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
- Una cuenta exenta omite todas las comisiones del paquete, no solo comisiones específicas
- Usa alias de cuenta (no IDs) al agregar cuentas exentas
- Cuando todas las cuentas de origen están exentas, el paquete no cobra comisión. De lo contrario, la comisión se divide entre las cuentas que la exención no cubre: las de origen para una comisión sumada encima, las de destino para una comisión deducible.
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.