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

# KYB 状态参考：会话、功能与 AML 状态

> Didit 的 KYB 会话、功能、注册表查询和 AML 筛查的精确状态字符串及功能名称。每次检查 $2.00 起，按国家/地区和等级定价。

企业验证在多个层级跟踪状态：**会话**、各项**功能**、**公司登记查询**和 **AML 结果**。本页是每个状态的参考说明。

API 返回的状态值是精确且区分大小写的标签，例如 `"In Progress"` 和 `"Not Finished"`，与 Webhook 中传递的字符串一致。
请按这些字符串进行匹配，不要依赖大写名称。

## 会话状态

企业验证（KYB）会话的整体状态，也是你最常需要判断的字段。

| 状态 | 含义 |
| - | - |
| `"Not Started"` | 会话已创建，但企业尚未打开托管验证页面。 |
| `"In Progress"` | 托管流程正在进行，包括公司登记查询、证件上传或 AML 筛查。 |
| `"Awaiting User"` | 正在等待终端用户执行操作，通常是提交关键人员名单，或回应重新提交请求。终端用户完成待办操作后会自动转为其他状态。 |
| `"Approved"` | 所有必需功能均已通过，企业已完成验证。 |
| `"Declined"` | 关键检查未通过（例如公司已解散、实体受制裁或被列入黑名单），或工作流规则拒绝了该会话。 |
| `"In Review"` | 一项或多项功能需要人工分析师审核。 |
| `"Resubmitted"` | 此前被拒绝或被要求重新提交的会话，已使用更新后的数据重新提交。 |
| `"Abandoned"` | 企业未完成流程（超时）。 |
| `"Expired"` | 会话在企业完成流程前已过期。 |

> [!NOTE]
>
> `"Awaiting User"` 是临时状态，你无需手动将会话移出该状态。终端用户一旦完成待办操作，例如提交关键人员名单或重新上传被要求的文件，Didit 会重新评估会话，并根据结果自动将其转为 `"In Review"`、`"Approved"` 或 `"Declined"`。

## 功能状态

每项 KYB 功能都有自己的状态，并汇总为会话状态。

| 状态 | 含义 |
| - | - |
| `"Not Finished"` | 功能尚未开始，或仍在运行中。 |
| `"Approved"` | 功能已通过。 |
| `"Declined"` | 功能因关键问题而失败。 |
| `"In Review"` | 功能需要分析师关注。 |
| `"Resub Requested"` | 企业必须针对该功能重新提交材料，例如重新上传证件。 |
| `"Awaiting User"` | 功能正在等待终端用户操作。在用户必须提交相关方信息期间，适用于关键人员功能。提交后会自动转为其他状态。 |

### KYB 功能名称

以下是 KYB 会话的 `features` 字段值，也会出现在 Webhook 中：

* `KYB_REGISTRY`：公司登记查询。
* `AML`：公司层面的 AML 筛查。
* `KYB_DOCUMENTS`：证件收集与 OCR。
* `KYB_KEY_PEOPLE`：关键人员，包括 UBO、股东、董事、代表及其他高管。

## 注册机构状态（来自服务商）

公司在权威登记来源中的官方状态。它反映辖区内登记机构报告的实体法律或监管地位，因此具体取值因来源而异。该状态出现在 KYB 决策的 `company.registry_status` 字段中。

| 状态 | 含义 |
| - | - |
| `ACTIVE` | 公司处于活跃状态且状况良好。 |
| `DISSOLVED` | 公司已解散。 |
| `DEREGISTERED` | 公司已注销登记。 |
| `STRUCK_OFF` | 公司已从登记册中除名。 |
| `CLOSED` | 公司已关闭。 |
| `INACTIVE` | 公司处于不活跃状态（未开展业务）。 |
| `AUTHORISED` | 已获授权，通常适用于受监管实体。 |
| `APPOINTED_REPRESENTATIVE` | 另一家获授权公司的指定代表。 |
| `UNAUTHORISED` | 此前获得授权，现已不再获授权。 |
| `NO_LONGER_AUTHORISED` | 授权已被撤销。 |
| `SEE_FULL_DETAILS` | 该状态需要人工查看详细信息。 |

> [!NOTE]
>
> 由于 `registry_status` 反映的是登记机构的原始值，如果你需要一个跨辖区一致的指标来驱动产品逻辑，请使用下方的 `verification_status`。

## 公司验证状态

这是面向企业的标准化状态，针对每个公司结果提供。它将不同国家和来源的登记状态统一为一个一致的指标，可直接在你的产品中解读。该状态出现在 KYB 决策的 `company.verification_status` 字段中。

| 状态 | 含义 |
| - | - |
| `verified` | 公司看起来处于正常且有效的状态。 |
| `failed` | 公司看起来处于不活跃或已解散状态，或发现了问题。 |
| `unknown` | 信息不足，或状态不明确。 |

## 公司数据获取状态

表明从外部或官方登记机构获取某家公司记录的数据进度。用它来判断某家公司的已获取信息有多完整。该状态出现在 KYB 决策的 `company.fetch_status` 字段中。

| 状态 | 含义 |
| - | - |
| `pending` | 此时仅获取到部分或基础的公司信息。 |
| `resolved` | 已从官方来源成功获取完整的公司数据。 |

## AML 验证状态

按每次筛查（公司或个人）返回。

| 状态 | 含义 |
| - | - |
| `"Approved"` | 没有超过阈值的命中。 |
| `"Declined"` | 高严重性命中（确认的制裁或 PEP 匹配）。 |
| `"In Review"` | 发现需要分析师审核的命中。 |
| `"Not Finished"` | 筛查尚未完成。 |

## 决策如何自我说明

KYB 决策不会携带单一的原因代码字符串。
每个功能数组（`registry_checks[]`、`document_verifications[]`、`key_people_checks[]`、`aml_screenings[]`）都包含 `warnings[]`，其中带有 `KYB_*` 和 AML 标签，`decision_trace` 则记录决策的得出过程。
请查看 [KYB 警告](https://docs.didit.me/zh/business-verification/warnings.md) 中的标签，并将其与会话状态一同记录。

当审核员对照平台自身的汇总结果手动设置状态时，决策会携带 `status_override`，以及 `overridden_at` 时间和平台原本会设置的 `automatic_status`。
请参阅[响应结构](https://docs.didit.me/zh/business-verification/response-schema.md)。

## 后续步骤

> [card] [响应结构](https://docs.didit.me/zh/business-verification/response-schema.md)
>
> 查看每个状态在 payload 中的位置。

> [card] [风险评估](https://docs.didit.me/zh/business-verification/risk-assessment.md)
>
> 影响 KYB 结果的因素。

> [card] [Webhook](https://docs.didit.me/zh/business-verification/webhooks.md)
>
> 状态变更时触发的事件。


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