Tracer en un core banking completo
Tracer es una de las piezas de un core banking de Lerian, su capa de control en tiempo real. Un ledger registra lo que pasó. Tracer decide primero qué está permitido que pase. En ese flujo, cuando tu aplicación crea una transacción en Midaz con Tracer habilitado, el ledger le pide a Tracer que verifique el movimiento contra tus reglas y límites de gasto antes de confirmarla. En el modo
enforce, los movimientos no autorizados o que superan el límite nunca llegan a los saldos.
Tracer se mantiene separado del ledger. Nunca inicia una llamada a Midaz ni lee saldos. Evalúa el contexto que recibe, registra el historial de validaciones y gestiona el estado de las reservas. Tu aplicación también puede llamar a Tracer antes de enviar cualquier cosa al ledger: POST /v1/validations verifica una transacción contra tus reglas y tus límites de gasto, y POST /v1/validations/rules-only verifica solo tus reglas. Ninguna de las dos llamadas consume un límite.
Midaz llama a Tracer a través de un seam de reserva por ledger, que está desactivado por defecto. Solo este seam consume un límite de gasto. En ese seam, la ruta de transacciones de Ledger HTTP v2 le pide a Tracer que evalúe tus reglas y retenga capacidad del límite antes de confirmar una transacción. Luego confirma o libera la retención. La API HTTP pública de Tracer sigue siendo /v1. El seam no es una API pública de Tracer v2.
Solo la ruta de transacciones de Ledger HTTP v2 invoca el seam. Ledger HTTP v1 nunca lo hace. En ambos flujos, las llamadas van hacia Tracer. Tracer no llama de vuelta a Midaz.
Para ver dónde encaja esto en el panorama general, consulta Construir un core banking completo.
¿Por qué usar Tracer?
Las instituciones financieras necesitan controlar cómo se mueve el dinero: aplicar límites de gasto, bloquear transacciones no autorizadas y generar registros de auditoría para los reguladores. Hacerlo de forma manual o mediante procesos por lotes genera demoras, errores y brechas de cumplimiento. Tracer resuelve esto evaluando cada transacción en tiempo real contra tus políticas. Ofrece dos capacidades:
- Reglas de validación: reglas de negocio que evalúan el contexto de la transacción y devuelven decisiones instantáneas, sin necesidad de despliegues de código. Defines las reglas como expresiones, así que analistas y equipos de cumplimiento pueden usarlas sin escribir código.
- Límites de gasto dinámicos: límites configurables por transacción, cuenta, portafolio, segmento o comercio, con seguimiento de uso en tiempo real y reinicios automáticos de periodo.
Resolver los desafíos de control y cumplimiento
Tracer ayuda a las instituciones a evaluar políticas de gasto, identificar transacciones no autorizadas y cumplir con los requisitos de auditoría.Funcionalidades clave
- Validación en tiempo real con tiempos de respuesta menores a 80ms (p99)
- Motor de reglas basado en expresiones que usa para reglas con tipado seguro y accesibles para analistas
- Diseño agnóstico de producto, que acepta cualquier esquema de pago, por ejemplo:
- Transacciones con tarjeta (débito, crédito, prepago)
- Transferencias bancarias (nacionales, internacionales, ACH)
- Pix (instantáneo, programado)
- Criptomonedas (bitcoin, ethereum, stablecoin)
- Límites de gasto dinámicos:
- Por transacción, cuenta, portafolio, segmento o comercio
- Periodos diarios, semanales, mensuales, personalizados o por transacción
- Seguimiento del uso de límites en tiempo real con reinicios automáticos de periodo
- Registro de auditoría encadenado por hash
- Valor predeterminado configurable para cuando no hay coincidencia (
DEFAULT_DECISION_WHEN_NO_MATCH): cuando ninguna regla coincide con una solicitud de validación, Tracer devuelve el valor predeterminado configurado (ALLOW para fail-open, DENY para fail-closed). EnPOST /v1/validations, un ALLOW que viene del valor predeterminado se verifica luego contra tus límites. Las fallas de infraestructura se manifiestan como errores HTTP. El sistema que hace la llamada decide el comportamiento de respaldo.
Cómo funciona
Tracer tiene cuatro contextos principales:
- Contexto de validación: orquesta las solicitudes de validación, coordina la evaluación de reglas y límites, y lleva el registro de auditoría.
- Contexto de reglas: gestiona las definiciones de reglas, compila expresiones y evalúa las reglas contra el contexto de la transacción.
- Contexto de límites: gestiona las configuraciones de límites de gasto, hace seguimiento de los contadores de uso y aplica los umbrales.
- Contexto de auditoría: mantiene el registro inmutable de eventos y verifica su cadena de hash.
Quién hace qué
Tracer se ubica entre varios equipos. Cada equipo es responsable de una parte distinta del ciclo:
Una solicitud típica fluye así: sistema de autorización → Tracer (evalúa reglas + verifica límites → decisión) → registro de validación → respuesta de vuelta al sistema de autorización. Una transacción que el ledger de Midaz crea con Tracer habilitado fluye así: ledger de Midaz → Tracer (evalúa reglas + reserva límites → decisión) → registro de validación → respuesta de vuelta al ledger. Una solicitud solo por reglas no verifica ningún límite. Los equipos de riesgo y producto configuran las definiciones de reglas y límites de antemano. Cumplimiento lee el registro de auditoría después. Tracer nunca vuelve a tu stack. No hay webhooks ni callbacks.
Los valores monetarios (
amount de la transacción, maxAmount del límite de gasto y los contadores de uso) usan cadenas decimales, por ejemplo "1500.00" o "50000.00".Cuándo usar Tracer
Tracer encaja en cualquier workflow donde necesites controlar cómo se mueve el dinero en tu institución.
- Gobernanza del gasto: evalúa transacciones contra políticas de gasto internas o en el nivel de cliente
- Validación de transacciones: evalúa reglas de negocio personalizadas y devuelve decisiones antes de la ejecución de la transacción
- Cumplimiento regulatorio: genera registros listos para auditoría y garantiza la trazabilidad
- Protección del cliente: detecta el sobregasto y devuelve decisiones sobre las que tu sistema puede actuar
Alcance y principios de diseño
Tracer es un motor de validación de transacciones, y la gestión completa de fraude queda fuera de su alcance. Es un componente especializado, optimizado para decisiones de baja latencia (< 100ms), que valida payloads previamente enriquecidos contra reglas y límites configurables.
En qué se enfoca Tracer
- Validación basada en reglas: lógica determinista basada en expresiones que usa CEL
- Límites de gasto: aplicación en tiempo real con reinicio automático de periodo
- Registro de auditoría: registros inmutables
- Decisiones de baja latencia: respuestas síncronas de la API en menos de 80ms (p99)
Qué no incluye Tracer
Integración
Tu sistema de autorización envía solicitudes de validación con el contexto completo de la transacción, y Tracer responde con una decisión, normalmente en menos de 35ms. Con este Payload-Complete Pattern, todo el contexto que Tracer necesita llega en una sola solicitud. No hay llamadas externas durante la validación, y la latencia se mantiene predecible.
En Lerian Cloud, Tracer limita cada solicitud a tu tenant a partir de tu token. Consulta Access Manager para el flujo de autenticación.
tracer-viewer-group: lectura de reglas, límites, validaciones, del registro de auditoría, del dashboard y del catálogo de eventos.tracer-contributor-group: lectura, creación y cambio de reglas y límites.tracer-validator-group: validación de transacciones y lectura de validaciones y del dashboard.tracer-audit-viewer-group: lectura del registro de auditoría y del dashboard.tracer-editor-group: todas las acciones de los otros grupos, y eliminación de reglas y límites.
admin-group) tiene el mismo acceso que tracer-editor-group.
Próximos pasos
Explora la API de Tracer
Explora los endpoints para reglas de validación, límites de gasto y registros de auditoría.
Primeros pasos
Configura Tracer y define tu primera regla de autorización.