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

Cada transação recebe uma pontuação, um número inteiro que resume o seu risco. A pontuação determina o estado da transação (APPROVED, IN_REVIEW, DECLINED) e a decisão de criar um alerta, abrir um caso ou exigir correção pelo utilizador.

A fórmula

score = Σ(score_delta of every matched rule)

Pontuação base: 0.
Cada regra correspondente contribui com o seu score_delta configurado (normalmente 25–35).
Uma transação sem regras correspondentes tem pontuação 0.

Limiares e estados

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

Definição	Valor predefinido	Significado
`preferred_review_score_threshold`	75	As pontuações iguais ou superiores a este valor passam para `IN_REVIEW`
`preferred_decline_score_threshold`	500	As pontuações iguais ou superiores a este valor passam para `DECLINED`. O valor predefinido e máximo (`500`) significa «nunca recusar por pontuação», por isso deve baixá-lo para começar a recusar com base na pontuação.

Atribuição de estado:

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

As ações das regras individuais podem substituir isto. Por exemplo, uma regra com action: change_status → DECLINED recusa a transação independentemente da pontuação.

Contributos das regras: exemplo prático

Suponha que estas regras são acionadas numa única transação:

Regra	`score_delta`
Transação de saída de valor elevado (>$10,000)	30
Contraparte de jurisdição de risco elevado	35
Padrão de fracionamento detetado	35

Pontuação total = 30 + 35 + 35 = 100. Com um limiar de revisão de 60 e um limiar de recusa de 85, esta transação fica DECLINED. Com os limiares predefinidos (75 para revisão, 500 para recusa), fica IN_REVIEW, porque o valor predefinido nunca recusa por pontuação.

Substituições por ação

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

Ação da regra	Efeito
`change_status → DECLINED`	Transação recusada independentemente da pontuação
`change_status → IN_REVIEW`	Transação enviada para revisão independentemente da pontuação
`change_status → AWAITING_USER`	A transação aguarda a correção pelo utilizador: o fluxo definido na ação da regra. As regras da biblioteca recorrem à opção escolhida nas definições e, depois, ao seu fluxo de Autenticação biométrica (é necessário ter uma face armazenada) e, por fim, ao seu fluxo predefinido.
`add_score(n)`	Contribui apenas para a pontuação; não força nenhum estado
`add_tags([...])`	Associa etiquetas para filtrar na consola; sem efeito na 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").

Porque é que as pontuações são melhores do que as regras rígidas

Um limiar simples (por exemplo, «recusar todas as transações acima de $100k») aciona tanto transações legítimas de valor elevado como 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 provoca uma recusa; vários sinais têm de coincidir.
Sensibilidade ajustável: aumente ou diminua os limiares sem alterar as definições das regras.
Ordenação por gravidade: uma transação com pontuação 65 vai para revisão (merece atenção); uma transação com pontuação 90 é recusada (grave).

Configurar os limiares

Em Transações → Definições:

Limiar de revisão: aumente se a sua fila de revisão estiver sobrecarregada; diminua para detetar mais casos limítrofes.
Limiar de recusa: aumente para reduzir as recusas por falsos positivos; diminua para tender para um bloqueio mais agressivo. Defina-o com o valor máximo (500) para encaminhar as pontuações elevadas para revisão, em vez de recusar automaticamente.

As alterações aplicam-se apenas às transações novas; as transações históricas mantêm o estado que tinham no momento da avaliação.

Modo de teste para regras

As regras podem ser executadas no modo TEST:

A regra avalia as transações, mas não contribui para a pontuação nem para o estado.
São criados registos TransactionRuleRun 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 é anulável e legado. As novas avaliações de regras não o definem. Use score como principal sinal de risco.

Inspecionar pontuações

Através da API

Cada 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"
    }
  ]
}

Na consola

Na página de detalhe da transação, o separador Pontuação mostra a discriminação da contribuição de cada regra correspondente e o mapeamento do estado final. Passe o cursor sobre o distintivo da pontuação para ver os valores dos limiares usados na avaliação.

Próximos passos

Regras

Anatomia e avaliação das regras.

Alertas

O que acontece quando uma regra é acionada.

Definições

Configure os limiares.

Primeiros passos

Funcionalidades

Referência

Consola

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

A fórmula

Limiares e estados

Contributos das regras: exemplo prático

Substituições por ação

Porque é que as pontuações são melhores do que as regras rígidas

Configurar os limiares

Modo de teste para regras

Severidade e campos legados

Inspecionar pontuações

Através da API

Na consola

Próximos passos

Regras

Alertas

Definições

​A fórmula

​Limiares e estados

​Contributos das regras: exemplo prático

​Substituições por ação

​Porque é que as pontuações são melhores do que as regras rígidas

​Configurar os limiares

​Modo de teste para regras

​Severidade e campos legados

​Inspecionar pontuações

​Através da API

​Na consola

​Próximos passos

Regras

Alertas

Definições

A fórmula

Limiares e estados

Contributos das regras: exemplo prático

Substituições por ação

Porque é que as pontuações são melhores do que as regras rígidas

Configurar os limiares

Modo de teste para regras

Severidade e campos legados

Inspecionar pontuações

Através da API

Na consola

Próximos passos