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

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

> Como a Didit pontua transações: regras, limiares e status (APPROVED, IN_REVIEW, DECLINED). 1,000 por mês inclusos, depois $0.001 cada.

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](https://docs.didit.me/pt-br/transaction-monitoring/response-schema.md#execuções-de-regras) para ver todos os campos):

```json theme={null}
{
  "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

> [card] [Regras](https://docs.didit.me/pt-br/transaction-monitoring/rules.md)
>
> Estrutura e avaliação das regras.

> [card] [Alertas](https://docs.didit.me/pt-br/transaction-monitoring/alerts.md)
>
> O que acontece quando uma regra é acionada.

> [card] [Configurações](https://docs.didit.me/pt-br/transaction-monitoring/settings.md)
>
> Configure os limiares.


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