> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Tracer

> Consulte os campos do Tracer usados na validação de transações em tempo real: payloads de requisição, regras, limites de gastos e respostas de decisão retornadas aos chamadores.

Esta página cobre os campos específicos do Tracer, o motor de validação de transações em tempo real da Lerian. Esses campos aparecem em requisições de validação, regras, limites de gastos e respostas de decisão.

## 1. Requisições de validação

***

| Campo | Descrição | Usado em |
| - | - | - |
| requestId | ID único gerado pelo cliente para idempotência e correlação de auditoria | Tracer |
| transactionType | Tipo de transação: CARD, WIRE, PIX ou CRYPTO | Tracer |
| subType | Subtipo da transação para contexto adicional (por exemplo, débito, crédito) | Tracer |
| amount | Valor da transação como string decimal, por exemplo `"100.00"` (deve ser positivo) | Tracer |
| asset | Código de ativo de 1 a 100 letras maiúsculas usado pela transação, por exemplo `BRL` ou `USD` | Tracer |
| transactionTimestamp | Quando a transação ocorreu (formato RFC 3339 com fuso horário) | Tracer |

## 2. Respostas de validação

***

| Campo | Descrição | Usado em |
| - | - | - |
| validationId | Identificador único gerado pelo servidor para o registro de validação | Tracer |
| decision | Decisão da validação: ALLOW, DENY ou REVIEW | Tracer |
| reason | Motivo da decisão, em texto legível | Tracer |
| matchedRuleIds | IDs das regras que corresponderam. Em um `REVIEW` com o motivo `rule_evaluation_error`, as regras REVIEW correspondentes e depois as regras que falharam | Tracer |
| evaluatedRuleIds | IDs das regras avaliadas sem erro | Tracer |
| processingTimeMs | Tempo de processamento em milissegundos | Tracer |
| totalRulesLoaded | Número total de regras carregadas para avaliação | Tracer |
| truncated | Indica se o Tracer ignorou as regras ativas além do teto `MAX_RULES_PER_REQUEST` | Tracer |

## 3. Regras

***

| Campo | Descrição | Usado em |
| - | - | - |
| ruleId | Identificador único da regra | Tracer |
| name | Nome da regra em texto legível (único dentro do seu contexto, máximo de 255 caracteres) | Tracer |
| description | Explicação do propósito e da lógica da regra (máximo de 1000 caracteres) | Tracer |
| expression | Expressão CEL que deve ser avaliada como booleano (máximo de 5000 caracteres) | Tracer |
| action | Ação tomada quando a expressão é avaliada como verdadeira: ALLOW, DENY ou REVIEW | Tracer |
| scopes | Array de escopos que determinam a quais transações essa regra se aplica | Tracer |
| status | Status do ciclo de vida da regra: DRAFT, ACTIVE, INACTIVE ou DELETED | Tracer |

## 4. Limites de gastos

***

| Campo | Descrição | Usado em |
| - | - | - |
| limitId | Identificador único do limite | Tracer |
| name | Nome do limite em texto legível (único globalmente, máximo de 255 caracteres) | Tracer |
| description | Explicação do propósito e uso do limite (máximo de 1000 caracteres) | Tracer |
| limitType | Tipo de limite: DAILY, WEEKLY, MONTHLY, CUSTOM ou PER\_TRANSACTION (imutável após a criação) | Tracer |
| maxAmount | Valor decimal máximo como string, por exemplo `"1000.00"` | Tracer |
| asset | Código de ativo de 1 a 100 letras maiúsculas do limite (imutável após a criação) | Tracer |
| scopes | Array de escopos que determinam a quais transações esse limite se aplica | Tracer |
| status | Status do ciclo de vida do limite: DRAFT, ACTIVE, INACTIVE ou DELETED | Tracer |
| activeTimeStart | Início da janela ativa diária no formato `HH:mm` | Tracer |
| activeTimeEnd | Fim da janela ativa diária no formato `HH:mm` | Tracer |
| customStartDate | Data-hora de início para limites CUSTOM | Tracer |
| customEndDate | Data-hora de término para limites CUSTOM | Tracer |
| resetTime | Início de cada período DAILY, WEEKLY ou MONTHLY no formato `HH:mm`, UTC (imutável após a criação) | Tracer |

## 5. Uso do limite

***

| Campo | Descrição | Usado em |
| - | - | - |
| limitAmount | Valor total do limite como string decimal | Tracer |
| exceeded | Indica se o limite foi excedido durante a validação | Tracer |
| period | Tipo de período do limite: DAILY, WEEKLY, MONTHLY, CUSTOM ou PER\_TRANSACTION | Tracer |
| scope | Descrição do escopo em texto legível (por exemplo, "account:uuid", "segment:uuid") | Tracer |
| attemptedAmount | Valor da transação sendo validada, como string decimal | Tracer |

## 6. Escopos e direcionamento

***

| Campo | Descrição | Usado em |
| - | - | - |
| accountId | Identificador de conta para direcionamento de escopo | Tracer |
| segmentId | Identificador de segmento para direcionamento de escopo | Tracer |
| portfolioId | Identificador de portfólio para direcionamento de escopo | Tracer |
| merchantId | Identificador de estabelecimento para direcionamento de escopo | Tracer |
| transactionType | Filtro de tipo de transação: CARD, WIRE, PIX ou CRYPTO | Tracer |
| category | Código de Categoria do Estabelecimento (MCC de 4 dígitos conforme ISO 18245) | Tracer |
| country | País do estabelecimento (ISO 3166-1 alpha-2, 2 letras maiúsculas) | Tracer |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.