O que é o Tracer?

O Tracer é a plataforma da Lerian para validação de transações em tempo real e controles de gastos. Ele ajuda instituições financeiras a aplicar políticas de gastos, detectar transações não autorizadas e manter registros de compliance prontos para auditoria. O Tracer faz isso em tempo real, antes de a transação ser executada. A cada transação, o Tracer avalia suas regras de negócio e limites de gastos, e então retorna uma decisão instantânea: allow, deny ou flag for review. No Midaz v4, o Tracer é source-available sob ELv2 no repositório e no release do Midaz. Ele continua sendo um runtime e um deploy separados do serviço de Ledger.

​

O Tracer em um core banking completo

---

O Tracer é uma das peças de um core banking Lerian, sua camada de controle em tempo real. Um ledger registra o que aconteceu. O Tracer decide o que pode acontecer primeiro. Nesse fluxo, antes de sua aplicação registrar uma transação no Midaz, ela chama o Tracer para conferir o movimento contra suas regras e limites de gastos. Sua aplicação envia ao ledger apenas se a decisão for ALLOW, então movimentos não autorizados ou acima do limite nunca chegam ao ledger. O Tracer permanece separado do ledger: ele nunca inicia uma chamada ao Midaz e nunca lê saldos. Ele avalia o contexto que recebe, registra o histórico de validações e gerencia o estado da reserva. Por padrão, sua aplicação orquestra os dois, enviando ao ledger apenas em caso de ALLOW. O Midaz também pode chamar o Tracer diretamente por meio de um elo de reserva opcional por ledger (reservation seam), que vem desligado por padrão. Nesse elo, o caminho de transação do Ledger HTTP v2 retém capacidade do limite antes de confirmar uma transação, e depois confirma ou libera a retenção. A API HTTP pública do Tracer permanece /v1. O elo não é uma API pública Tracer v2. Apenas o caminho de transação do Ledger HTTP v2 aciona o elo. O Ledger HTTP v1 nunca o faz. Nos dois fluxos, as chamadas seguem em direção ao Tracer. O Tracer não chama de volta o Midaz. Para onde isso se encaixa no quadro geral, veja Construindo um core banking completo.

​

Por que usar o Tracer?

---

Instituições financeiras precisam controlar como o dinheiro se move: aplicar tetos de gastos, bloquear transações não autorizadas e produzir trilhas de auditoria para reguladores. Fazer isso manualmente ou por processos em lote gera atrasos, erros e lacunas de compliance. O Tracer resolve isso avaliando cada transação em tempo real contra suas políticas. Ele oferece duas capacidades:

• Regras de validação: regras de negócio que avaliam o contexto da transação e retornam decisões instantâneas, sem exigir deploys de código. Você define regras usando expressões, não código, o que as torna acessíveis a analistas e times de compliance.
• Limites de gastos dinâmicos: limites configuráveis por transação, por conta, por portfólio, por segmento ou por comerciante, com rastreamento de uso em tempo real e reinício automático de período.

​

Resolvendo desafios de controle e compliance

O Tracer ajuda instituições a avaliar políticas de gastos, identificar transações não autorizadas e atender exigências de auditoria.

​

Principais capacidades

---

• Validação em tempo real com tempos de resposta abaixo de 80ms (p99)
• Motor de regras baseado em expressões usando para regras type-safe e acessíveis a analistas
• Design agnóstico de produto, com suporte a vários tipos de transação:
  • Transações de cartão (débito, crédito, pré-pago)
  • Transferências (domésticas, internacionais, ACH)
  • Pix (instantâneo, agendado)
  • Criptomoeda (bitcoin, ethereum, stablecoin)
• Limites de gastos dinâmicos:
  • Por transação, conta, portfólio, segmento ou comerciante
  • Períodos diário, semanal, mensal, personalizado ou por transação
• Rastreamento de uso do limite em tempo real, com reinício automático de período
• Trilha de auditoria completa com retenção de mais de 7 anos para compliance com SOX/GLBA
• Padrão configurável para ausência de correspondência (DEFAULT_DECISION_WHEN_NO_MATCH): quando nenhuma regra corresponde a uma transação, o Tracer retorna o padrão configurado (ALLOW para fail-open, DENY para fail-closed). Falhas de infraestrutura aparecem como erros HTTP. O sistema que chama decide o comportamento de fallback.

​

Como funciona

---

O Tracer tem quatro contextos principais:

1. Validation Context - orquestra requisições de validação, coordena a avaliação de regras e limites, e registra a trilha de auditoria.
2. Rules Context - gerencia definições de regra, compila expressões e avalia regras contra o contexto da transação.
3. Limits Context - gerencia configurações de limite de gastos, rastreia contadores de uso e aplica os tetos.
4. Audit Context - mantém o log de eventos imutável e verifica sua cadeia de hash para compliance com SOX/GLBA.

Quando seu sistema envia uma transação para validação: O Tracer avalia todas as regras ativas, e se qualquer regra DENY corresponder, ele retorna uma decisão DENY. O Tracer confere limites contra o uso atual e retorna a decisão com um registro de auditoria completo. Seu sistema deve agir sobre essa decisão (por exemplo, bloqueando a transação, mostrando um erro ao usuário, ou colocando-a em fila para revisão).

​

Quem faz o quê

O Tracer se posiciona entre vários times. Cada time é dono de uma parte diferente do ciclo: Uma requisição típica flui assim: sistema de autorização → Tracer (avalia regras + confere limites → decisão) → log de auditoria → resposta de volta ao sistema de autorização. Os times de risco e produto configuram as definições de regra e limite com antecedência. O compliance lê o log de auditoria depois. O Tracer nunca volta a acessar sua stack. Não há webhooks nem callbacks.

​

Quando usar o Tracer

---

O Tracer se encaixa naturalmente em qualquer fluxo em que você precise controlar como o dinheiro se move pela sua instituição.

• Governança de gastos: avalia transações contra políticas de gastos internas ou de nível de cliente
• Validação de transação: avalia regras de negócio personalizadas e retorna decisões antes da execução da transação
• Compliance regulatório: produz logs prontos para auditoria e garante rastreabilidade
• Proteção ao cliente: detecta gastos excessivos e retorna decisões sobre as quais seu sistema pode agir

​

Escopo e princípios de design

---

O Tracer é um motor de validação de transações, não um sistema completo de gestão de fraude. É um componente especializado, otimizado para decisões de baixa latência (< 100ms), que valida payloads pré-enriquecidos contra regras e limites configuráveis.

​

No que o Tracer foca

• Validação baseada em regras: lógica determinística, baseada em expressões, usando CEL
• Limites de gastos: aplicação em tempo real com reinício automático de período
• Trilha de auditoria: registros imutáveis para compliance (SOX/GLBA)
• Decisões de baixa latência: respostas de API síncronas abaixo de 80ms (p99)

​

O que o Tracer não inclui

​

Integração

---

Seu sistema de autorização envia requisições de validação com o contexto completo da transação, e o Tracer responde com uma decisão, tipicamente em menos de 35ms. Com este Payload-Complete Pattern, todo o contexto que o Tracer precisa chega em uma única requisição. Não há chamadas externas durante a validação, e a latência permanece previsível. Como todos os produtos Lerian, o Tracer vem com integração nativa ao Access Manager. Quando habilitado, o Access Manager cuida da autenticação e autorização das APIs do Tracer. Este é um recurso opcional, disponível sob o modelo Enterprise.

​

Próximos passos

---