Saltar al contenido principal
Las reglas de tarifas definen cómo Matcher calcula y aplica tarifas durante el proceso de conciliación. Use reglas de tarifas para modelar comisiones de transacciones, cargos por servicio y deducciones esperadas que afectan los resultados de conciliación.

Qué resuelven las reglas de tarifas


La conciliación falla cuando un lado de una transacción incluye tarifas o cargos que el otro lado no registra. Un gateway de pagos deduce una comisión de procesamiento antes de liquidar. Un banco cobra una comisión por transferencia bancaria. Un adquirente descuenta comisiones de los pagos. Sin reglas de tarifas, Matcher trata estas diferencias como discrepancias de monto y genera excepciones — incluso cuando la diferencia es esperada y documentada. Las reglas de tarifas le indican a Matcher qué tarifas anticipar, para que pueda conciliar correctamente a pesar de la diferencia de monto.

Cómo funcionan las reglas de tarifas


Las reglas de tarifas se asocian a un contexto de conciliación. Cuando Matcher se ejecuta, evalúa las reglas de tarifas aplicables y ajusta los montos esperados antes de comparar transacciones entre fuentes. Este ajuste ocurre antes de la evaluación de reglas de conciliación. Una transacción que de otro modo quedaría fuera de tolerancia puede conciliar correctamente una vez que se tiene en cuenta la tarifa conocida. Las reglas de tarifas reducen las excepciones falsas causadas por cargos predecibles y recurrentes. En lugar de resolver manualmente cientos de diferencias esperadas de tarifas cada día, su equipo se enfoca en discrepancias reales.

Estructura de una regla de tarifa


CampoDescripción
NombreEtiqueta descriptiva para la regla de tarifa. Use nombres que identifiquen el origen de la tarifa (ej., “Comisión de procesamiento del gateway”).
TipoLa categoría de tarifa: processing, service_charge, wire_fee, acquirer_fee o custom.
Método de cálculoCómo se calcula la tarifa: flat (monto fijo) o percentage (porcentaje del monto de la transacción).
Monto / TasaEl valor de la tarifa. Para tarifas fijas, el monto fijo. Para tarifas porcentuales, la tasa (ej., 2.5 para 2.5%).
Aplicado aQué lado del match ajustar: la transacción origen, la transacción destino, o ambas.
CondicionesFiltros opcionales que restringen cuándo se aplica la regla — por fuente, rango de monto, moneda o tipo de transacción.
ActivaSi la regla está actualmente en uso. Las reglas inactivas se conservan pero no se evalúan.

Creación de una regla de tarifa


Este ejemplo crea una regla de tarifa para un gateway de pagos que deduce una comisión de procesamiento del 2.5% de las liquidaciones antes de acreditar a la cuenta del comerciante.
curl -X POST "https://api.matcher.example.com/v1/config/contexts/{contextId}/fee-rules" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Comisión de procesamiento del gateway — 2.5%",
    "type": "processing",
    "calculationMethod": "percentage",
    "rate": 2.5,
    "appliedTo": "target",
    "conditions": {
      "sourceId": "src_gateway_001",
      "currencyCode": "BRL"
    },
    "active": true
  }'
Referencia API: Crear regla de tarifa

Gestión de reglas de tarifas


OperaciónDescripción
Listar reglas de tarifasObtener todas las reglas de tarifas de un contexto, con filtros opcionales.
Obtener una regla de tarifaConsultar la configuración completa de una regla de tarifa específica por ID.
Actualizar una regla de tarifaModificar tasa, condiciones o estado sin recrear la regla.
Eliminar una regla de tarifaEliminar una regla de tarifa permanentemente. Considere desactivar en su lugar para preservar el historial de auditoría.

Mejores prácticas


Identifique los tipos de tarifas que generan más excepciones hoy. Modélelos primero. Una sola regla de tarifa bien configurada que cubre un cargo común elimina más trabajo manual que cinco reglas que cubren casos extremos.
Nombres como “Comisión de procesamiento del gateway — 2.5%” son más útiles que “Regla de tarifa 1”. Al revisar excepciones o auditar conciliaciones, un nombre claro cuenta la historia sin necesidad de abrir la configuración.
Las tasas de tarifas cambian cuando se renegocian los contratos de pago. Una regla de tarifa con una tasa desactualizada genera excepciones en lugar de prevenirlas. Programe una revisión trimestral — o active una cada vez que se renueve un contrato con un proveedor de pagos.
Una regla de tarifa sin condiciones se aplica a todas las transacciones del contexto. Las reglas específicas con filtros de fuente, códigos de moneda o rangos de monto previenen ajustes no deseados. Las reglas amplias son más difíciles de auditar.
Antes de activar una nueva regla de tarifa en producción, ejecútela contra una muestra de transacciones recientes. Confirme que resuelve las excepciones esperadas sin crear nuevas. Desactive en lugar de eliminar las reglas de las que no está seguro — puede reactivar sin reconfigurar.

Próximos pasos


Reglas de conciliación

La puntuación de confianza tiene en cuenta los ajustes de tarifas al evaluar la calidad de la conciliación.

Enrutamiento de excepciones

Enrute las excepciones que las reglas de tarifas no cubren a los equipos correctos.

Referencia API de reglas de tarifas

Referencia completa de la API para los endpoints de reglas de tarifas.