AML 筛查警告与警报代码

概述

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 风险评分。

生成的警告

风险	原因	`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"，并遵循标准警告对象结构。

可配置项

每个工作流节点的 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 匹配分数。
持续监控：启用后，随着数据集的变化，AML 将对目标主体重新进行筛查，并重新发送报告以及 status.updated（状态变更）或 data.updated（命中项变更）Webhook。

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

示例

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

{
  "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 字段)

{
  "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 筛查警告与警报代码

概述

生成的警告

可配置项

示例

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

`COULD_NOT_PERFORM_AML_SCREENING` (缺少 KYC 字段)

相关内容

警告类型

​概述

​生成的警告

​可配置项

​示例

​POSSIBLE_MATCH_FOUND (分数高于通过阈值)

​COULD_NOT_PERFORM_AML_SCREENING (缺少 KYC 字段)

​相关内容

​警告类型

概述

生成的警告

可配置项

示例

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

`COULD_NOT_PERFORM_AML_SCREENING` (缺少 KYC 字段)

相关内容

警告类型