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 ISO 4217 de três 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 e acionaram a decisão | Tracer |
| evaluatedRuleIds | IDs de todas as regras avaliadas | Tracer |
| processingTimeMs | Tempo de processamento em milissegundos | Tracer |
| totalRulesLoaded | Número total de regras carregadas para avaliação | Tracer |
| truncated | Indica se a resposta foi truncada devido a limites de tamanho | 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 |
| activatedAt | Quando a regra foi ativada pela última vez (null se nunca foi ativada) | Tracer |
| deactivatedAt | Quando a regra foi desativada pela última vez (null se nunca foi desativada) | 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 ISO 4217 de três 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 |
5. Uso do limite
| Campo | Descrição | Usado em |
|---|---|---|
| limitAmount | Valor total do limite como string decimal | Tracer |
| currentUsage | Uso projetado após aplicar a transação, 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 |