> ## 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 关键人员 API：实际受益人与董事验证

> Didit 在一个 KYB 流程中验证实际受益人、股东、董事和高管，提供基于角色的核验与关联 KYC 会话。每次检查 $2.00 起，无需签约。

**关键人员**是 Didit 用于描述与您所核验企业相关的每一位自然人和法人实体的统一模型，包括 UBO、股东（个人及企业股东）、董事、代表及其他管理人员角色。单个关键人员流程即可涵盖以上全部内容，并支持基于角色的验证分派，以及注册信息中的相关方与用户提交的相关方之间的完整并列比对。

> [!NOTE]
>
> 如需了解关键人员在企业视图中如何跨会话汇总管理人员和 UBO，请参阅 [企业 → 关键人员](https://docs.didit.me/zh/entities/businesses/key-people.md)。

## 运作方式

**1. 注册信息预填（可选）**

如果工作流启用了注册信息预填，关键人员页面会预先填入从注册核查中提取的可用 UBO、股东和管理人员。
终端用户可以在提交前编辑、添加或删除相关方，即使股权结构信息仍待收集也可以。
在收集股权结构报告期间，已收到的管理人员信息仍然可用。
提交前，延迟返回的结果会填充未被修改的字段，并补充缺失人员，但不会覆盖用户的编辑，也不会恢复已删除的相关方。
编辑器打开时内容保持不变；额外的预填内容会在申请人关闭编辑器后应用。
如果未启用注册信息预填，申请人需自行输入相关方，延迟返回的结果不会填充此表单。
提交后到达的注册信息仍会作为注册证据的一部分保留，但不会更改已提交的相关方列表，也不会自动创建额外的子验证会话。

**2. 从托管流程提交**

终端用户通过托管验证流程提交最终的关键人员列表。默认情况下您无需自行调用此步骤，它会在您通过[创建会话](https://docs.didit.me/zh/sessions-api/create-session.md)获取的 URL 对应的 KYB 流程中完成。
如需保留您自己的前端，请改用[相关方草稿](https://docs.didit.me/zh/sessions-api/kyb-create-party-draft.md)和[提交相关方](https://docs.didit.me/zh/sessions-api/kyb-submit-parties.md) endpoint。

**3. 基于角色的验证路由**

对于每个已提交的相关方，Didit 会检查该角色已配置的验证设置：

* 应用工作流的股权结构阈值：低于所配置百分比的 UBO 和股东无需进行个人验证。
* 若该角色允许跳过，则遵循终端用户设置的"跳过验证"标记。
* 为需要 KYC 的个人相关方生成子用户验证（KYC）会话。
* 当工作流启用了嵌套 KYB 时，为企业类 UBO 生成子 KYB 会话。

**4. 状态流转**

当任何必需的子会话仍在进行中时，关键人员功能状态为 `Awaiting User`。所有子会话完成后，状态会根据结果汇总为 `Approved`、`Declined` 或 `In Review`。

## 收集的角色

关键人员可以拥有以下一个或多个角色，同一人可同时担任多个角色（例如董事**并且**股东）。完整分类如下：

| 类别 | 角色 |
| - | - |
| **股权结构** | `ubo`, `shareholder`, `beneficiary`, `settlor`, `protector`, `investor` |
| **治理 / 代表** | `director`, `non_executive_director`, `chairman`, `secretary`, `representative`, `authorized_signatory`, `trustee`, `company_officer`, `founder`, `legal_advisor`, `other` |

每个角色都可以在工作流中单独配置：启用或禁用、对 KYC 为必填或可选、映射到特定的 KYC 工作流，以及是否可选择跳过。验证分派的详细信息请参阅[股权结构](https://docs.didit.me/zh/business-verification/ownership.md)。

## 每位关键人员收集的数据

托管流程会询问一组默认字段，以及工作流中配置的其他自定义字段。完整列表请参阅[股权结构 → 收集的字段](https://docs.didit.me/zh/business-verification/ownership.md#为每位关键人员收集的数据)。

## 注册信息确认

在关键人员步骤之前，终端用户会查看从注册核查中提取的公司数据，并可选择编辑任意字段。随后托管流程会存储：

* Didit 从注册核查中标准化的**注册信息详情**（`registry_data`）。
* **用户确认的数据**（`user_provided_data`），并附有标记用户确认时间的时间戳。
* 顶层公司字段上的合并后的规范化视图：存在用户确认数据时以其为准，否则回退到注册信息。

完整模型请参阅[公司数据 → 注册信息与用户提供的数据](https://docs.didit.me/zh/business-verification/company-data.md#登记数据与用户提供数据)。

## 决策响应中的结构

提交后，所收集的关键人员会出现在 KYB 决策的 `key_people_checks[]` 下，分为两类：**注册信息**（服务商披露的内容）和**已提交**（企业管理员通过流程确认的内容），另有 `ubo_kyc_summary` 汇总 UBO KYC 进度。完整内容请参阅 [key\_people\_checks 参考](https://docs.didit.me/zh/business-verification/response-schema.md#key_people_checks)。

## 重新提交行为

* **关键人员**和**注册核查**不能直接重新提交。如需重新验证某位特定人员，请重新提交其个人子 KYC 会话。
* 重新提交子 KYC 会话后，父级关键人员功能状态会自动返回 `Awaiting User`。
* 重新提交的子会话完成后，父级会根据所有子状态重新汇总。
* 已删除的子会话，或在该人员开始前已过期的子会话，无法重新提交：请[为该相关方重新生成](https://docs.didit.me/zh/sessions-api/regenerate-kyb-party.md)，以在同一相关方上签发新链接。

## 关键人员验证链接的有效期

关键人员的子 KYC 会话遵循为其角色配置的 KYC 工作流中的会话过期时间，而不是 KYB 工作流的过期时间。如果将某个角色映射到允许四周有效期的 KYC 工作流，即使企业会话设置为更早过期，该人员的链接仍可使用四周。

该值是每个工作流的设置，范围为 1 小时至 4 周（`session_expiration_time`，单位为秒），位于 *Workflows → \[KYC workflow] → Settings*。

过期会改变您对该当事方可执行的操作。在该人员开始验证之前已过期的链接（例如会话已被删除的链接），可以使用 [重新生成关键人员 KYC 会话](https://docs.didit.me/zh/sessions-api/regenerate-kyb-party.md) 重新签发。即使该人员已开始或已完成验证，已删除的会话也符合条件。导入的会话不会因过期而符合条件，必须已被删除。未被删除且该人员已开始验证的会话，不会因过期而符合条件。

## 配置选项

所有关键人员行为都在 Business Console 中按工作流进行配置：

| 设置 | 控制内容 |
| - | - |
| **登记数据预填充** | 使用登记数据预先填充关键人员表单 |
| **额外字段：个人** | 为每个个人当事方收集的自定义字段 |
| **额外字段：企业** | 为每个企业当事方收集的自定义字段 |
| **UBO所有权阈值** | 将某人归类为 UBO 所需的最低所有权百分比 |
| **股东所有权阈值** | 将某人归类为股东所需的最低所有权百分比 |
| **每个角色的设置** | 每个角色的设置：启用/禁用、是否需要 KYC、使用的 KYC 工作流、是否可跳过 |
| **企业 UBO 嵌套 KYB** | 启用后，企业类 UBO 将触发其自身的子 KYB 会话 |
| **复用已验证个人** | 参见下方的[跨 KYB 检查复用已验证个人](#跨-kyb-检查复用已验证个人) |
| **通过电子邮件通知当事方** | 自动向每位关键人员发送包含其验证链接的电子邮件 |

请在控制台中前往 *Workflows → \[KYB workflow] → Key People* 进行配置。

## 跨 KYB 检查复用已验证个人

当工作流中的 **复用已验证个人** 设置已启用（默认启用）时，关键人员在新的 KYB 检查中出现时无需重新完成 KYC。Didit 会查找之前 KYB 检查中已有的已通过 KYC，并将其关联到新的当事方，而不是创建新的子 KYC 会话。

> [!NOTE]
>
> 这与[可复用 KYC](https://docs.didit.me/zh/core-technology/reusable-kyc/overview.md) 是不同的机制。后者允许*终端用户*通过共享或导入 token，自愿将一个已完成的会话带到不同的 Didit 集成应用中。本页中的 KYB 重用设置是自动的、由工作流配置的，并且仅限于同一应用内的关键人员：无需共享 token，也无需终端用户执行任何操作。

**匹配。** 系统会将所提交人员的姓名（不区分大小写，并去除首尾空白）与应用中其他 KYB 检查的关键人员进行比较，以查找候选匹配项。不存在其他匹配信号：不要求，也不检查证件号码、电子邮件或电话号码是否匹配。拼写不同、包含中间名或音译的姓名将无法匹配；极少数情况下，两个不同但同名的人可能被匹配。查看关键人员结果时请考虑这一点。

**范围。** 匹配会查找*同一应用*下的所有其他 KYB 检查，而不仅限于当前 KYB 检查，也不包括您组织中的其他应用。在公司 A 中被验证为 UBO 的人员，之后出现在公司 B 中担任董事时，只要两次检查都在同一应用下运行，即可被匹配。

**符合条件的状态。** 只有当事方最近一次**已通过**的 KYC 才符合重用条件。该姓名对应的**已拒绝** KYC 会完全阻止重用：该当事方会被标记，并要求进行新的 KYC，而不会退回使用已拒绝的记录。仍处于**审核中**的 KYC 永远不会被视为候选项。

**保留期限。** 匹配只考虑大约最近一年内创建且未被删除的 KYC 会话。如果唯一匹配的会话超出该时间范围，或已被个人或组织删除，检查将找不到符合条件的匹配项，并会静默地请求新的 KYC。它绝不会导致关键人员提交失败或被阻止。

**计费。** 重用的 KYC 不会再次计费。将已通过的会话关联到新的当事方不产生额外费用；您只需为原始 KYC 支付一次费用。

```txt Example theme={null}
Company A: Jane Doe submitted as UBO, KYC approved.
Company B (same application): Jane Doe submitted as a director.
"Reuse verified individuals" is enabled, so Company B's Key People
check links Jane's existing approved KYC instead of requesting a
new one - free, and instantly Approved for that party.
```

## 后续步骤

> [card] [股权结构](https://docs.didit.me/zh/business-verification/ownership.md)
>
> 收集的字段、自定义数据，以及登记数据与提交数据的核对。

> [card] [高管与代表](https://docs.didit.me/zh/business-verification/officers.md)
>
> 关键人员模型中的治理角色。

> [card] [响应模式](https://docs.didit.me/zh/business-verification/response-schema.md#key_people_checks)
>
> `key_people_checks[]` 字段逐项参考。


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