Antes de empezar
- El Fees Engine debe estar habilitado en la configuración del Midaz Module.
- Necesitas un Ledger existente y al menos una Cuenta que pueda recibir montos de tarifa.
- Si el paquete debe aplicar solo a una route o segmento específico, crea esos registros primero.
Crear el Paquete de Tarifas
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 recibirán tarifas de 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 independientemente del valor de la transacción.Percentage- Porcentaje del monto de la transacción.Max Between Types- El valor mayor entre la tarifa fija y la porcentual.
5
Agrega la información de la tarifa.
6
(Opcional) Puedes agregar otra regla de tarifa si lo necesitas. Para hacerlo, selecciona un nuevo tipo de tarifa 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 las cuentas que deben quedar exentas de las tarifas de 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 esté correcto.
11
Haz clic en el botón Create Package.
Guía de campos
Basic Information
Fee Rules
Cada tarifa dentro de un paquete tiene una Priority (1 = se aplica primero). La tarifa con prioridad1 debe usar Original Amount como Reference Amount.
Flat Fee
Un monto fijo aplicado a la Transacción independientemente de su valor.Cuando Deductible from transaction? está activado, Reference Amount se fuerza a
Original Amount (la opción After Fees Amount queda deshabilitada en el formulario).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 mayor. Ambos cálculos son obligatorios.El formulario de Max Between Types siempre requiere exactamente dos cálculos: uno de tipo
Flat Fee y otro de tipo Percentage Fee. El Console calcula ambos y aplica el mayor.Account Waivers
Notas importantes
Orden de prioridad de tarifas
Cuando un paquete contiene varias tarifas, se aplican en orden de prioridad (primero el número más bajo). Esto importa al usarAfter Fees Amount como referencia, ya que las tarifas anteriores afectan la base de cálculo de las posteriores.
Ejemplo:
- Tarifa A (Priority 1): 1% sobre el monto original
- Tarifa B (Priority 2): 0.5% sobre el monto después de tarifas
- Tarifa A = $1.00 (1% de $100)
- Tarifa B = $0.495 (0.5% de $99)
Consideraciones sobre el rango de monto
- Los rangos no deben superponerse entre paquetes para la misma transaction route.
- Usa
0.01como mínimo para paquetes que deban aplicar a todas las transacciones. - Usa un máximo alto (por ejemplo,
999999999.99) para no tener límite superior. - Las transacciones exactamente en los valores mínimo o máximo se incluyen en el rango.
Comportamiento de las cuentas exentas
- Las cuentas exentas omiten todas las tarifas del paquete, no solo tarifas específicas.
- Usa alias de cuenta (no IDs) al agregar cuentas exentas.
- Las exenciones aplican cuando la cuenta exenta es la origen de la transacción.
Qué hacer a continuación
Después de crear el Paquete de Tarifas, ejecuta un cálculo de prueba en Ejecución de una Estimación de Tarifas antes de usarlo con Transacciones reales.