> ## 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 cada transação: regras, limiares e estados (APPROVED, IN_REVIEW, DECLINED). 1,000 por mês incluídas, depois $0.001 cada.

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](https://docs.didit.me/pt/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"
    }
  ]
}
```

### 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

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

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

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


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