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

# 交易风险评分：公式与阈值

> Didit 如何为每笔交易评分：规则贡献、阈值与状态映射（APPROVED、IN_REVIEW、DECLINED）。每月包含 1,000 次，之后每次 $0.001。

每笔交易都会获得一个**分数**，这是一个概括其风险的整数。分数决定交易的状态（`APPROVED`、`IN_REVIEW`、`DECLINED`），以及是否创建警报、开立案件，或要求用户整改。

## 公式

```
score = Σ(score_delta of every matched rule)
```

* 基础分数：0。
* 每条匹配的规则都会计入其配置的 `score_delta`（通常为 25–35）。
* 没有匹配任何规则的交易，分数为 0。

## 阈值与状态

分数阈值在各应用的 *Transactions → Settings* 中配置。

| 设置项 | 默认值 | 含义 |
| - | - | - |
| `preferred_review_score_threshold` | 75 | 分数 ≥ 该值的交易进入 `IN_REVIEW` |
| `preferred_decline_score_threshold` | 500 | 分数 ≥ 该值的交易进入 `DECLINED`。默认值也是最大值（`500`），意味着“从不按分数拒绝”，因此需要调低该值，才能开始按分数拒绝。 |

状态分配：

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

单条规则的操作可以覆盖此逻辑。例如，设置了 `action: change_status → DECLINED` 的规则，无论分数多少，都会拒绝该交易。

## 规则贡献示例

假设单笔交易触发了以下规则：

| 规则 | `score_delta` |
| - | - |
| 大额转出（>\$10,000） | 30 |
| 高风险司法管辖区交易对手 | 35 |
| 检测到拆分交易模式 | 35 |

总分数 = 30 + 35 + 35 = **100**。

若审核阈值为 60，拒绝阈值为 85，则该交易的状态为 `DECLINED`。
使用默认阈值（审核 75，拒绝 500）时，该交易为 `IN_REVIEW`，因为默认设置从不按分数拒绝。

## 操作覆盖

规则还可以直接设置状态，跳过分数阈值：

| 规则操作 | 效果 |
| - | - |
| `change_status → DECLINED` | 无论分数如何，交易均被拒绝 |
| `change_status → IN_REVIEW` | 无论分数如何，交易进入审核 |
| `change_status → AWAITING_USER` | 交易等待用户整改。使用规则操作中设置的工作流；规则库中的规则会依次回退到您在设置中选择的工作流、您的生物识别认证工作流（需要已存储的人脸），然后是您的默认工作流 |
| `add_score(n)` | 仅计入分数，不强制设置状态 |
| `add_tags([...])` | 添加用于控制台筛选的标签，不影响分数 |
| `add_to_list(...)` | 将标识符添加到黑名单 |

一条规则可以包含多个操作，例如：`add_score(35)` + `add_tags(["structuring"])` + `add_note("Auto-tagged by structuring preset")`。

## 为什么分数优于硬性规则

单纯的阈值（例如“拒绝所有超过 \$100k 的交易”）既会触发合法的大额交易，也会触发真正存在风险的交易。将多条中等 `score_delta` 规则与审核/拒绝阈值结合使用，可以带来以下好处：

* **分层评分**：没有任何单条规则会直接导致拒绝，必须多个信号同时指向同一结论。
* **可调灵敏度**：无需修改规则定义，即可调高或调低阈值。
* **风险严重程度排序**：分数为 65 的交易进入审核（值得查看）；分数为 90 的交易进入拒绝状态（风险严重）。

## 配置阈值

在 *Transactions → Settings* 中：

* **审核阈值**：审核队列积压时调高；需要捕获更多边缘情况时调低。
* **拒绝阈值**：调高可减少误报导致的拒绝；调低则更倾向于积极拦截。将其设为最大值（`500`），可将高分交易转入审核，而不是自动拒绝。

修改仅适用于**新**交易，历史交易保留其评估时的状态。

## 规则测试模式

规则可以在 `TEST` 模式下运行：

* 规则会对交易进行评估，但不计入分数或状态。
* 会创建 `is_test = true` 的 `TransactionRuleRun` 记录。
* 可在不冒生产环境拒绝风险的情况下，验证规则的选择性。

对规则的选择性满意后，切换为 `ACTIVE`。

## 严重程度与旧版字段

Transaction 和 TransactionAlert 上的 `severity` 字段可为空，属于旧版字段。新的规则评估不会设置该字段。请将 `score` 作为主要风险信号。

## 查看分数

### 通过 API

每个交易响应都包含 `score` 和 `rule_runs[]` 数组，数组中每条匹配的规则对应一个条目（所有字段请参阅[响应结构](https://docs.didit.me/zh/transaction-monitoring/response-schema.md#规则运行记录)）：

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

### 在控制台中

在交易详情页面的 **分数** 标签页中，可以查看每条匹配规则的分数贡献明细以及最终的状态映射。将鼠标悬停在分数徽章上，可查看评估时使用的阈值。

## 后续步骤

> [card] [规则](https://docs.didit.me/zh/transaction-monitoring/rules.md)
>
> 规则的结构与评估。

> [card] [警报](https://docs.didit.me/zh/transaction-monitoring/alerts.md)
>
> 规则触发时会发生什么。

> [card] [设置](https://docs.didit.me/zh/transaction-monitoring/settings.md)
>
> 配置阈值。


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