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

# UBO API：实际受益人与股权结构提取

> Didit 可从公司登记处提取最终实际受益人（UBO），附股权链、持股比例及 AML 筛查。按国家和等级计费，每次检查起价 $2.00。

识别谁最终拥有和控制一家公司，是 KYB 的核心。在可用时，Didit 会从登记机构获取股权结构，允许企业管理员在托管流程中确认并补充该结构，然后对每位关键人员执行基于角色的验证。

## 实际受益人（UBO）

**最终实际受益人（UBO）**是最终拥有或控制一个法人实体的自然人。UBO 会出现在会话决策的 `key_people_checks[].registry.beneficial_owners[]`（源自公司登记）和 `key_people_checks[].submitted.parties[]`（由用户提交）中，其他角色（如股东或董事）也在同一列表中。

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

托管流程会收集一组默认字段，以及工作流中配置的任何自定义字段。默认字段如下：

| 字段 | 自然人 | 公司 |
| - | :-: | :-: |
| `name` 或 `first_name` + `last_name` | ✅ 必填 | ✅ 必填（`company_name`） |
| `email` | ✅ 必填 | ✅ 必填 |
| `nationality` / 国家/地区 | ✅ 必填 | ✅ 必填 |
| `role`（每个相关方一个或多个） | ✅ 必填 | ✅ 必填 |
| `ownership_percent` / `voting_percent`（按角色） | 可选 | 可选 |
| `date_of_birth` | 可选 | — |
| `phone_number` | 可选 | — |
| `position`（自由文本职位） | 可选 | — |
| `registration_number` | — | 可选 |
| `entity_type` | `person` | `company` |

`entity_type` 会根据相关方是自然人还是公司实体自动设置。

### 自定义字段

工作流可以要求为每位自然人或每家公司提供额外字段，数量不限。这些字段在 Business Console 的 KYB 工作流中配置，并保存在决策响应中每个相关方的 `custom_fields` 对象里。自定义字段适用于财富来源声明、税务居民身份、内部客户 ID 或特定行业的披露信息等场景。

## 公司股东与嵌套所有权

当股东本身是公司（而非自然人）时，Didit 会记录：

* 公司名称和注册号。
* 该公司股东持有的所有权比例。
* 注册成立国家/地区。

这样您就能沿着多个层级追溯股权链，直至最终的自然人。

### 企业实际受益人的嵌套 KYB

当工作流为企业实际受益人启用嵌套 KYB 时，每个企业相关方都会触发一个 KYB 子会话。该公司会按照您在顶层所运行的同一流程完成验证，其结果再反馈给父会话。此功能默认关闭，需要在每个工作流中单独开启。

## 持股阈值

大多数司法辖区将拥有或控制 25% 或以上权益的人员认定为 UBO。该阈值可按工作流配置：

| 司法辖区 | 典型 UBO 阈值 |
| - | - |
| 欧盟（AMLD） | 25% 所有权或控制权 |
| 英国 | 25% 股份或表决权 |
| 美国（CTA） | 25% 所有权或实质性控制 |
| 新加坡 | 25% 股份或表决权 |

在 *Workflows → \[KYB workflow] → Risk → UBO threshold* 中设置。当没有任何 UBO 达到阈值时（这在上市公司股权高度分散的情况下很常见），您的工作流还可以对其进行标记或转入人工审核。

## 投票权与经济权利

所有权披露区分两种控制权：

| 权利 | 含义 |
| - | - |
| **经济（所有权）比例** | 公司经济价值及分红权的占比 |
| **表决权比例** | 股东决议表决权的占比 |

两者通常相等，但当公司发行双重股权股票或优先股时可能出现差异。Didit 会同时记录两者。规则和阈值可以检查其中任一项，大多数司法辖区要求在*任一*比例达到或超过 25% 时披露 UBO。

## 通过股权链计算的实际持股

当所有权经由某家公司股东传递时，下游自然人的实际持股比例通过沿链条逐层相乘计算。

### 示例：三层股权链

```
Acme Corp (target)
  └─ 60% → Acme Holdings Ltd
              └─ 75% → Jane Doe (natural person)
  └─ 40% → John Smith (natural person)
```

计算得出的 UBO：

* **Jane Doe**：对 Acme Corp 的实际持股 = 60% × 75% = **45%**（UBO）。
* **John Smith**：对 Acme Corp 的实际持股 = **40%**（UBO）。

以 25% 为 UBO 阈值时，Jane 和 John 都会被披露。以 50% 为阈值时，没有任何人达到标准，Didit 会将此标记为透明度问题。

## 角色设置如何驱动验证

每个角色都在各 KYB 工作流中单独配置：是否启用、是否需要 KYC、该角色使用哪个 KYC 工作流，以及终端用户是否可以选择跳过。提交关键人员后：

1. Didit 会将提交的相关方角色与工作流的角色设置进行核对。
2. 对于标记为需要验证的角色，会启动一个子验证会话：
   * **自然人相关方** → 用户验证（KYC）子会话，使用该角色专属的 KYC 工作流，或默认工作流。
   * **企业 UBO**（启用嵌套 KYB 时）→ 企业验证（KYB）子会话。
3. 对于标记为可跳过的角色，终端用户会看到“跳过验证”选项并可以选择退出；被跳过的相关方会被记录，但不会阻塞父会话。
4. 持股低于工作流所设阈值的相关方，即使其角色原本需要验证，也不会触发单独验证。

请在 Business Console 中的 *Workflows → \[KYB workflow] → Key People* 处完成全部配置。

## 监控股东与实际受益人

> [!NOTE]
>
> 公司登记监控**即将推出**。在 2026 年 9 月 7 日检查的暂存环境零售目录中，没有任何国家/地区启用了监控。配置的费率为每家公司每年 USD 2.00，但价格并不代表该功能已可用。下述行为描述的是正式推出后的计划服务。

在**股东**或 **UBO** 层级完成验证的公司，可以纳入**持续公司登记监控**。登记机构会推送公司状态、高级管理人员、股权结构和注册地址的变更。每次发生变更时，Didit 会执行以下操作：

* 将企业会话从*已通过*改回*审核中*，并在会话中记录该变更；
* 发送 `data.updated` [Webhook](https://docs.didit.me/zh/business-verification/webhooks.md)，其中 `trigger: "kyb_registry_change"`；
* 保持该公司的登记记录为最新状态。

监控**仅在该国家/地区允许时可用**：登记服务提供方必须支持该司法辖区的监控。完整列表见[持续监控国家/地区表](https://docs.didit.me/zh/business-verification/supported-countries.md#持续登记监控)。在 Lite 层级完成验证的公司，或位于该列表之外的国家/地区的公司，不会被纳入监控，企业页面会说明原因。

可在*工作流 → KYB Registry Check → 高级 → Continuous registry monitoring*中按工作流启用。费用为**每家公司每年 \$2.00**，在纳入监控时和每年续费时计费。钱包余额不足以支付续费时，该公司的监控会停止，而不会在未付费的情况下继续运行。可随时在企业页面（*KYB Registry Check → Registry monitoring*）取消。

## 登记信息与用户提交信息比对

响应会在 `key_people_checks[]` 下并排展示两个来源的数据：

* `registry.officers[]` 和 `registry.beneficial_owners[]`：提供方披露的内容。
* `submitted.parties[]`：企业管理员通过流程明确提交的内容，其中 `source: "USER"`。

分析人员在控制台中直观比对这两类数据，以发现遗漏的实际受益人、未披露的额外相关方，或持股比例对不上的情况。系统没有提供自动比对接口。你可以在自己的系统中，按适用情况通过姓名、角色和股权比例进行匹配核对。

## AML 筛查

每位已识别的关键人员都会自动与全球 AML 观察名单进行筛查，既包括登记来源的人员，也包括用户提交的人员。关于公司层面与个人层面 AML 检查如何结合，请参阅[企业 AML 筛查](https://docs.didit.me/zh/business-verification/aml.md)。

## 后续步骤

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

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

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


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