> ## 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 的关键人员模型、多角色标签和 AML 筛查验证董事、高管及授权代表。每次检查低至 $2.00。

高管、董事和代表在 Didit 的 KYB 模型中**并非独立概念**，他们都包含在 [关键人员](https://docs.didit.me/zh/business-verification/key-people.md) 中，与 UBO 和股东并列，每人标注一个或多个角色。同一人可以同时是董事**并且**股东，或者同时是代表**并且**授权签署人。该关键人员记录包含完整的角色列表，而不只是一个角色。

## 完整角色分类

每位关键人员可以担任以下一个或多个角色：

### 治理 / 代表

| 角色 | 说明 |
| - | - |
| `director` | 董事会成员，承担治理职责 |
| `non_executive_director` | 非执行董事，不承担日常管理职责 |
| `chairman` | 董事会主席 |
| `secretary` | 公司秘书，负责行政和合规事务 |
| `representative` | 公司的法定代表人或指定代表 |
| `authorized_signatory` | 获授权代表公司签署文件的人员 |
| `trustee` | 持有公司权益的信托结构的受托人 |
| `company_officer` | 通用高管角色 |
| `founder` | 公司创始成员 |
| `legal_advisor` | 公司聘请的法律顾问 |
| `other` | 不属于标准分类的任何角色 |

### 所有权 / 受益人

| 角色 | 说明 |
| - | - |
| `ubo` | 最终实际受益人，即最终拥有或控制公司的个人 |
| `shareholder` | 登记股东（个人或法人） |
| `beneficiary` | 信托或类似结构的受益人 |
| `settlor` | 信托设立人 |
| `protector` | 信托保护人 |
| `investor` | 投资者角色（不属于正式股权结构） |

同一人可以同时属于这两类角色。例如，一位既是董事又是 UBO 的创始人，在同一条关键人员记录上就持有三个角色。

## 多角色记录

每条关键人员记录都包含一个角色列表。如适用，每个角色都附带各自的所有权或表决权百分比。以下是董事兼股东在响应中的呈现方式：

```json theme={null}
{
  "uuid": "...",
  "name": "Jane Doe",
  "first_name": "John",
  "last_name": "Doe",
  "entity_type": "person",
  "roles": [
    { "role": "director", "ownership_percent": null, "voting_percent": null },
    { "role": "shareholder", "ownership_percent": 15.0, "voting_percent": 15.0 }
  ],
  "kyc_status": "Approved",
  "kyc_session_url": "https://verify.didit.me/..."
}
```

## KYC 关联

每位关键人员都可以关联到一个用户验证（KYC）会话。当角色的工作流设置要求 KYC 时，关联会自动完成：系统会创建子 KYC 会话，若启用了该选项，则向该人员发送验证链接，并将状态回写到该关键人员记录。

完整的路由逻辑请参阅 [所有权 → 角色设置如何驱动验证](https://docs.didit.me/zh/business-verification/ownership.md#角色设置如何驱动验证)。关于每个关键人员记录上显示的面向 B2C 场景的 KYC 状态值（`Approved`、`Declined`、`Pending`），请参阅[响应模式](https://docs.didit.me/zh/business-verification/response-schema.md#company-块)。

## AML 筛查

每位已识别的关键人员都会在企业验证流程中自动与全球 AML 观察名单进行比对。PEP 匹配结果对治理类角色尤其相关，受监管企业的董事和签署人经常出现在 PEP 名单上。请参阅[企业 AML 筛查](https://docs.didit.me/zh/business-verification/aml.md)。

## 需要验证标志

每位关键人员都带有 `requires_verification` 标志，用于说明工作流是否要求该人员进行 KYC：

| 值 | 含义 |
| - | - |
| `true` | 该人员必须完成 KYC，会话才能通过审批。 |
| `false` | 该人员已完成身份识别和 AML 筛查，但无需单独进行 KYC。 |

在 *Workflows → \[KYB workflow] → Key People → per-role settings* 中配置哪些角色需要验证。常见的默认设置如下：

* 超过工作流阈值的董事和 UBO → `requires_verification: true`。
* 授权签署人和秘书 → 可选。
* 非执行董事 → 可选。

## 跳过关键人员

如果某人无法完成验证（已故、无法联系或属于历史记录），可以将其标记为 `is_skipped: true`。标记可以由终端用户在托管流程中完成（前提是该角色的设置允许跳过），也可以由分析人员在控制台中完成。被跳过的关键人员不计入验证门槛，但仍会出现在响应中，以供审计。

## 跨来源交叉比对

每位关键人员的数据可以来自三个来源，控制台会将三者并排显示：

* **注册记录**：官方登记机构披露的内容。
* **用户提交**：企业管理员在关键人员流程中确认或补充的内容。
* **上传文件**：通过 OCR 从公司章程、股东名册或授权委托书中提取的姓名。

不一致之处会以警告的形式显示在会话决策中。

## 对企业实体的影响

通过 KYC 将关键人员关联到用户实体，会在[企业实体](https://docs.didit.me/zh/entities/businesses/overview.md)上建立持久关系。之后，您可以：

* 查看每位人员以治理或所有权角色任职的所有企业。
* 将用户的状态变更（已标记、已封禁）同步到其担任关键人员的企业。
* 对每位关联人员进行持续 AML 监控，且不依赖于任何特定的 KYB 会话。

## 后续步骤

> [card] [关键人员](https://docs.didit.me/zh/business-verification/key-people.md)
>
> 完整的关键人员流程。

> [card] [所有权](https://docs.didit.me/zh/business-verification/ownership.md)
>
> UBO 识别与股权链。

> [card] [AML](https://docs.didit.me/zh/business-verification/aml.md)
>
> 企业与个人 AML 筛查。


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