Pontuação de risco de transações: fórmula e limiares

Toda transação recebe uma pontuação — um número inteiro que resume seu risco. A pontuação determina o status da transação (APPROVED, IN_REVIEW, DECLINED) e a decisão de criar um alerta, abrir um caso ou exigir remediação pelo usuário.

A fórmula

score = Σ(score_delta of every matched rule)

Pontuação base: 0.
Cada regra correspondente contribui com o score_delta configurado (normalmente entre 25 e 35).
Uma transação sem nenhuma regra correspondente tem pontuação 0.

Limiares e status

Os limiares de pontuação são configurados por aplicação em Transações → Configurações.

Configuração	Padrão	Significado
`preferred_review_score_threshold`	75	Pontuações ≥ esse valor vão para `IN_REVIEW`
`preferred_decline_score_threshold`	500	Pontuações ≥ esse valor vão para `DECLINED`. O valor padrão e máximo (`500`) significa “nunca recusar pela pontuação”; portanto, reduza-o para começar a recusar com base na pontuação.

Atribuição de status:

if decline_threshold < 500 and score >= decline_threshold: status = DECLINED
else if score >= review_threshold: status = IN_REVIEW
else: status = APPROVED

As ações de regras individuais podem substituir essa atribuição — por exemplo, uma regra com action: change_status → DECLINED recusará a transação independentemente da pontuação.

Contribuições das regras — exemplo prático

Suponha que estas regras sejam acionadas em uma única transação:

Regra	`score_delta`
Saída de alto valor (>$10,000)	30
Contraparte em jurisdição de alto risco	35
Padrão de fracionamento detectado	35

Pontuação total = 30 + 35 + 35 = 100. Com um limiar de revisão de 60 e um limiar de recusa de 85, essa transação fica DECLINED. Com os limiares padrão (75 para revisão, 500 para recusa), ela fica IN_REVIEW, porque a configuração padrão nunca recusa com base na pontuação.

Sobrescritas de ação

As regras também podem definir o status diretamente, ignorando os limiares de pontuação:

Ação da regra	Efeito
`change_status → DECLINED`	A transação é recusada independentemente da pontuação
`change_status → IN_REVIEW`	A transação vai para revisão independentemente da pontuação
`change_status → AWAITING_USER`	A transação aguarda a correção pelo usuário, com o fluxo de verificação (workflow) definido na ação da regra; as regras da biblioteca recorrem à opção escolhida nas suas configurações, depois ao seu fluxo de Autenticação biométrica (exige rosto armazenado) e, por fim, ao seu fluxo padrão
`add_score(n)`	Apenas contribui para a pontuação; não força nenhum status
`add_tags([...])`	Adiciona tags para filtragem no console; não afeta a pontuação
`add_to_list(...)`	Adiciona um identificador a uma lista de bloqueio

Uma única regra pode ter várias ações — por exemplo, add_score(35) + add_tags(["structuring"]) + add_note("Auto-tagged by structuring preset").

Por que pontuações são melhores que regras rígidas

Um limiar isolado (por exemplo, “recusar toda transação acima de $100k”) é acionado tanto por transações legítimas de alto valor quanto por transações que representam riscos reais. Combinar várias regras com score_delta moderado e um limiar de revisão/recusa oferece:

Pontuação em camadas — nenhuma regra isolada causa uma recusa; vários sinais precisam concordar.
Sensibilidade ajustável — aumente ou reduza os limiares sem alterar as definições das regras.
Escala de gravidade — uma transação com pontuação 65 vai para revisão (vale uma análise); uma com pontuação 90 é recusada (grave).

Configurando os limiares

Em Transações → Configurações:

Limiar de revisão: aumente se sua fila de revisão estiver sobrecarregada; reduza para capturar mais casos limítrofes.
Limiar de recusa: aumente para reduzir recusas por falso positivo; reduza para adotar um bloqueio mais agressivo. Defina-o no valor máximo (500) para encaminhar pontuações altas para revisão em vez de recusá-las automaticamente.

As alterações se aplicam somente a transações novas — as transações históricas mantêm o status atribuído no momento da avaliação.

Modo de teste para regras

As regras podem ser executadas no modo TEST:

A regra é avaliada nas transações, mas não contribui para a pontuação nem para o status.
Os registros TransactionRuleRun são criados com is_test = true.
Permite validar a seletividade de uma regra sem arriscar recusas em produção.

Mude para ACTIVE quando estiver satisfeito com a seletividade.

Severidade e campos legados

O campo severity em Transaction e TransactionAlert é aceita valor nulo e legado. As novas avaliações de regras não o preenchem. Use score como o principal sinal de risco.

Inspecionando pontuações

Pela API

Toda resposta de transação inclui score e um array rule_runs[] com uma entrada por regra correspondente (consulte o esquema de resposta para ver todos os campos):

{
  "txn_id": "tx-0002",
  "status": "IN_REVIEW",
  "score": 65,
  "rule_runs": [
    {
      "rule_title": "High-value outbound",
      "matched": true,
      "score_delta": 30,
      "severity": null,
      "status_target": null,
      "action_summary": "score +30"
    },
    {
      "rule_title": "High-risk jurisdiction counterparty",
      "matched": true,
      "score_delta": 35,
      "severity": "HIGH",
      "status_target": "IN_REVIEW",
      "action_summary": "score +35; add_tag:high_risk_country"
    }
  ]
}

No console

Na página de detalhes da transação, a aba Pontuação mostra o detalhamento da contribuição de cada regra correspondente e o mapeamento final do status. Passe o cursor sobre o indicador da pontuação para ver os valores de limiar usados no momento da avaliação.

Próximos passos

Regras

Estrutura e avaliação das regras.

Alertas

O que acontece quando uma regra é acionada.

Configurações

Configure os limiares.

Primeiros passos

Recursos

Referência

Console

Pontuação de risco de transações: fórmula e limiares

A fórmula

Limiares e status

Contribuições das regras — exemplo prático

Sobrescritas de ação

Por que pontuações são melhores que regras rígidas

Configurando os limiares

Modo de teste para regras

Severidade e campos legados

Inspecionando pontuações

Pela API

No console

Próximos passos

Regras

Alertas

Configurações

​A fórmula

​Limiares e status

​Contribuições das regras — exemplo prático

​Sobrescritas de ação

​Por que pontuações são melhores que regras rígidas

​Configurando os limiares

​Modo de teste para regras

​Severidade e campos legados

​Inspecionando pontuações

​Pela API

​No console

​Próximos passos

Regras

Alertas

Configurações

A fórmula

Limiares e status

Contribuições das regras — exemplo prático

Sobrescritas de ação

Por que pontuações são melhores que regras rígidas

Configurando os limiares

Modo de teste para regras

Severidade e campos legados

Inspecionando pontuações

Pela API

No console

Próximos passos