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

# AML 筛查警告与警报代码

> 了解 Didit 的 AML 警告代码（POSSIBLE_MATCH_FOUND 和 COULD_NOT_PERFORM_AML_SCREENING），配置阈值及缺失 KYC 数据时的重新运行行为。

## 概述

AML 筛查会在 `aml_screenings[]` 中每个条目的 `warnings[]` 数组上输出一小组警告标签。以下两个标签是 Didit 生成的**仅有**的 AML 警告，命中项上显示的所有其他内容都编码在该命中项自身的字段中（`risk_view`、`match_score`、`risk_score`、`sanction_matches[]` 等），而不是作为警告体现。工作流会话与独立 AML API 输出 `POSSIBLE_MATCH_FOUND` 的方式完全相同。

AML 记录上返回的状态（`Approved`、`In Review`、`Declined`）由综合 `score` 及您的阈值推导得出；警告会对相同的条件进行标记，以便您可以通过编程方式对其做出响应。有关阈值如何映射到状态的信息，请参阅[AML 风险评分](https://docs.didit.me/zh/core-technology/aml-screening/aml-risk-score.md)。

## 生成的警告

| 风险 | 原因 | `log_type` | 影响状态 | 建议补救措施 |
| - | - | - | - | - |
| `POSSIBLE_MATCH_FOUND` | 综合 `score` 非零且高于 `aml_score_approve_threshold`（默认值为 `80`），即至少有一个可能匹配的命中项达到您的风险区间。（当分数恰好等于该阈值时，独立 AML API 也会输出该警告。） | `warning`；当分数同时超过 `aml_score_review_threshold`（默认值为 `100`）时升级为 `error`。 | 当分数高于通过阈值时为 `In Review`；当分数高于审核阈值时为 `Declined`。 | 审核 `hits[]` 中的每个命中项。使用 AML 命中状态 endpoint 将命中项标记为 `Confirmed Match`、`False Positive` 或 `Inconclusive`。命中项更新会触发 `data.updated` Webhook，但不会重新计算 AML 状态。请通过 AML 状态 endpoint 或控制台审核设置最终状态。 |
| `COULD_NOT_PERFORM_AML_SCREENING` | KYC 记录缺少 `full_name`、`date_of_birth` 或 `issuing_state` 中的一个或多个。不会进行计费筛查调用。 | `warning` | 强制设为 `In Review`。 | 补全 KYC 记录中缺失的字段。一旦三项全部提供，AML 将自动重新运行，过时的警告日志将被移除，无需手动重新触发。 |

警告存储时带有 `feature: "AML"`，并遵循标准[警告对象](https://docs.didit.me/zh/reference/data-models.md#警告对象)结构。

## 可配置项

每个工作流节点的 AML 控制项（也可作为独立 AML API 的选项传入）：

* **`aml_score_approve_threshold`**：默认值为 `80`。高于该值的非零分数会生成 `POSSIBLE_MATCH_FOUND` 并将 AML 检查流转至 `In Review`。在会话工作流中，等于或低于该值的分数**不会**生成该警告，无论命中数量有多少。
* **`aml_score_review_threshold`**：默认值为 `100`。高于该值的分数将自动拒绝 AML 检查（在默认值为 `100` 时，除非您调低该阈值，否则绝不会触发）。
* **`aml_match_score_threshold`**：默认值为 `93`。按命中项分类：`match_score` 低于该值的命中项初始状态为 `False Positive` 并不计入综合分数；等于或高于该值的命中项初始状态为 `Unreviewed`。
* **匹配分数权重**：`aml_name_weight` / `aml_dob_weight` / `aml_country_weight`，默认值分别为 `60` / `25` / `15`（总和必须为 100）。请参阅[AML 匹配分数](https://docs.didit.me/zh/core-technology/aml-screening/aml-match-score.md)。
* **持续监控**：启用后，随着数据集的变化，AML 将对目标主体重新进行筛查，并重新发送报告以及 `status.updated`（状态变更）或 `data.updated`（命中项变更）Webhook。

> [!NOTE]
>
> 当触发 `COULD_NOT_PERFORM_AML_SCREENING` 时，AML 检查将保持在 `In Review` 状态，直到提供缺失的身份字段。一旦 Didit 获得了姓名、出生日期和签发州，AML 将自动重新运行且警告会清除，无需手动重新触发。

## 示例

### `POSSIBLE_MATCH_FOUND` (分数高于通过阈值)

```json theme={null}
{
  "warnings": [
    {
      "feature": "AML",
      "risk": "POSSIBLE_MATCH_FOUND",
      "additional_data": null,
      "log_type": "warning",
      "short_description": "Possible match found in AML screening",
      "long_description": "The Anti-Money Laundering (AML) screening process identified potential matches with watchlists or high-risk databases, requiring further review.",
      "node_id": "aml-1"
    }
  ]
}
```

### `COULD_NOT_PERFORM_AML_SCREENING` (缺少 KYC 字段)

```json theme={null}
{
  "warnings": [
    {
      "feature": "AML",
      "risk": "COULD_NOT_PERFORM_AML_SCREENING",
      "additional_data": null,
      "log_type": "warning",
      "short_description": "Could not retrieve data from KYC for performing AML Screening",
      "long_description": "The system encountered issues accessing or processing Know Your Customer (KYC) data necessary for conducting the Anti-Money Laundering (AML) screening. please fill the KYC full name, birth date, issuing state and document number to automatically proceed with AML screening.",
      "node_id": "aml-1"
    }
  ]
}
```

## 相关内容

* [AML 报告](https://docs.didit.me/zh/core-technology/aml-screening/report-aml-screening.md)：完整响应结构、命中字段、状态语义
* [AML 风险评分](https://docs.didit.me/zh/core-technology/aml-screening/aml-risk-score.md)：综合评分的计算方式
* [AML 匹配分数](https://docs.didit.me/zh/core-technology/aml-screening/aml-match-score.md)：单次命中置信度
* [持续 AML 监控](https://docs.didit.me/zh/core-technology/aml-screening/continuous-monitoring-aml-screening.md)：监控生命周期
* [数据模型 - AML 筛查](https://docs.didit.me/zh/reference/data-models.md#aml-筛查)：规范模式，包括[警告对象](https://docs.didit.me/zh/reference/data-models.md#警告对象)

### 警告类型


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