> ## 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）可以在将企业和法律实体入驻您的平台之前对其进行核验。系统会自动查询公司登记信息，识别实际受益人和高管，对所有相关方进行 AML 观察名单筛查，并收集辅助证明文件，这些步骤都在一个工作流中完成。每家通过核验的企业都会作为一份[企业档案](https://docs.didit.me/zh/business-verification/business-profiles.md)进行跟踪，汇总各次会话的结果。

本 Didit Academy 课程将完整演示一次企业验证流程：KYB 控制台、登记信息核查、股东与 UBO、AML 筛查，以及企业代表端看到的内容。

[企业验证（KYB）全流程讲解 ｜ Didit Academy](https://www.youtube.com/embed/JEnW_sEe35Y?rel=0\&playsinline=1)

初次接触 Didit KYB？请先阅读[快速入门](https://docs.didit.me/zh/business-verification/quickstart.md)，了解 10 分钟的端到端操作流程，然后阅读[集成指南](https://docs.didit.me/zh/business-verification/integration-guide.md)，了解生产环境的实践模式。关于底层的企业实体模型（涵盖与用户的关联、黑名单以及导入和导出），请参阅[企业](https://docs.didit.me/zh/entities/businesses/overview.md)。

## 工作原理

**1. 创建企业会话**

通过使用 **KYB 工作流**创建会话来启动企业验证。当工作流类型为 KYB 时，Didit 会自动创建企业会话：

```bash theme={null}
curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "your-kyb-workflow-id",
    "vendor_data": "company-123"
  }'
```

会话类型由工作流决定，无需额外字段。KYB 工作流会自动创建企业会话，并启用企业专属功能。

**2. 企业登记信息查询**

Didit 会以 **Lite**、**股东**或 **UBO** 层级查询官方公司登记机构，各层级的费用按国家/地区计算，参见[登记查询定价](https://docs.didit.me/zh/getting-started/kyb-registry-pricing.md)。Lite 层级可获取以下信息：

| 数据 | 说明 |
| - | - |
| **公司名称** | 登记的法定名称 |
| **注册号** | 官方公司注册号 |
| **国家/地区** | 成立国家/地区 |
| **状态** | 存续中、已解散、已被除名等 |
| **公司类型** | Ltd、LLC、PLC、SA、GmbH 等 |
| **成立日期** | 公司登记的日期 |
| **注册地址** | 官方注册办公地址 |
| **税号** | 税务识别号（如有） |

登记数据会与所提供的信息进行交叉比对，以发现不一致之处。

**3. 关键人员：UBO、股东、董事与代表**

系统将以统一的**关键人员**模型识别与企业相关的每一位个人和企业实体：

* **UBO**：最终拥有或控制该公司的个人，包括持股比例和表决权比例
* **股东**（个人和企业）：每位股东均列明其持股比例
* **董事、代表、秘书、授权签字人及其他高管角色**：标注其具体角色标签
* **企业股权层级**：所有权链中的母公司，可选择嵌套 KYB

同一人可以拥有多个角色标签（例如，既是董事，**又是**股东）。每个角色均在工作流中单独配置，包括哪些角色需要 KYC、使用哪个 KYC 工作流，以及终端用户能否跳过验证。详情请参阅[关键人员](https://docs.didit.me/zh/business-verification/key-people.md)和[股权结构](https://docs.didit.me/zh/business-verification/ownership.md)。

**4. AML 筛查**

所有已识别的相关方都会自动与全球 AML 观察名单进行比对：

* **企业反洗钱**：对企业实体进行制裁名单、负面新闻和监管执法名单筛查
* **个人反洗钱**：对每位关键人员（UBO、股东、董事、代表等）单独进行筛查
* 采用与用户验证相同的[双分数风险体系](https://docs.didit.me/zh/core-technology/aml-screening/overview.md)（匹配分数加风险评分）

**5. 文件收集**

收集并核验辅助证明文件：

| 文件类型 | 示例 |
| - | - |
| **注册证书** | 公司成立证明 |
| **公司章程** | 内部规章、组织大纲 |
| **地址证明** | 注册地址的公用事业账单、银行对账单 |
| **股东名册** | 官方股东登记册 |
| **财务报表** | 年度账目、审计报告 |
| **税务证明** | 税务登记或合规证明 |
| **自定义文件** | 您的合规流程所要求的其他文件 |

审核期间，审核员可以向企业索取补充文件。

**6. 审核与决策**

企业会话会根据所有检查结果获得一个整体状态：

| 状态 | 含义 |
| - | - |
| **已通过** | 所有检查均已通过，企业已完成验证 |
| **审核中** | 一项或多项检查需要人工审核 |
| **已拒绝** | 某项关键检查未通过（例如公司已解散、实体受制裁） |

审核员可以在 Business Console 中查看所有已收集的数据、添加备注、请求补充文件，并作出最终决定。

## 企业会话生命周期

每次企业验证都在一个**企业会话**中进行，该会话通过以下状态跟踪进度：

| 状态 | 说明 |
| - | - |
| `"Not Started"` | 会话已创建，但验证尚未开始 |
| `"In Progress"` | 验证进行中，正在执行登记查询、AML 筛查或证件收集 |
| `"Approved"` | 所有检查均已通过，企业已通过验证 |
| `"Declined"` | 关键检查未通过（例如企业已注销、实体受制裁） |
| `"In Review"` | 一项或多项检查需要分析员人工审核 |
| `"Resubmitted"` | 此前被拒绝的会话已使用更新后的数据重新提交 |

每个会话都有唯一的 `session_id`、顺序编号 `session_number`，以及用于托管验证链接的 `session_token`。当会话创建时带有 `vendor_data` 标识符，Didit 会自动将其关联到对应的[企业档案](https://docs.didit.me/zh/business-verification/business-profiles.md)。

## 功能状态

企业验证会分别跟踪每个组成部分的状态：

| 功能 | 说明 |
| - | - |
| **公司登记核验** | 企业登记处查询与数据提取 |
| **企业反洗钱** | 针对制裁名单和观察名单，对企业主体进行 AML 筛查 |
| **证件** | 证件收集、OCR 识别与交叉比对 |
| **关键人员** | 实际受益人和高管识别、AML 筛查及 KYC |

每项功能可处于以下状态之一：`"Not Finished"`、`"Approved"`、`"Declined"`、`"In Review"` 或 `"Resub Requested"`。会话整体状态由各项功能状态汇总得出，只有当所有必需功能均通过时，会话才会显示为 `"Approved"`。

## Webhook 事件

企业会话会生成以下 Webhook 事件：

| 事件 | 触发条件 |
| - | - |
| `status.updated` | 会话状态发生变化。对于 KYB 会话，载荷中包含 `session_kind: "business"`。 |
| `data.updated` | 审核员在控制台中编辑了公司登记数据或关键人员信息，或登记处报告了变更。载荷中包含 `session_kind: "business"`。进度请以 `status.updated` 为准。 |
| `business.status.updated` | 关联的[企业实体](https://docs.didit.me/zh/entities/businesses/overview.md)状态发生变化（`ACTIVE` / `FLAGGED` / `BLOCKED`）。 |
| `business.data.updated` | 关联企业实体的档案字段或汇总计数器发生变化。 |

Webhook 载荷中包含 `session_kind: "business"` 和 `business_session_id`，用于将其与用户验证事件区分开。有关签名验证和投递详情，请参阅 [Webhook](https://docs.didit.me/zh/integration/webhooks.md)。

## 核心能力

| 能力 | 说明 |
| - | - |
| **自动公司登记查询** | 在支持的国家和地区查询官方企业登记处，支持 Lite、Shareholders 或 UBOs 等级，[按国家和地区计费](https://docs.didit.me/zh/getting-started/kyb-registry-pricing.md) |
| **UBO 识别** | 自动提取实际受益所有权结构及持股比例 |
| **高管筛查** | 识别并验证董事、秘书及其他高级职员 |
| **企业反洗钱** | 针对制裁名单和观察名单，筛查企业主体 |
| **个人反洗钱** | 逐一筛查所有已识别的 UBO 和高管 |
| **KYC 关联** | 将每位已识别人员关联至用户验证（KYC）会话，进行身份验证 |
| **证件收集** | 结构化证件请求，并跟踪上传情况 |
| **OCR 交叉核验** | 从已上传证件中提取数据，并与公司登记数据进行交叉比对 |
| **企业档案** | 为每家已验证企业自动创建档案，并汇总其会话信息 |
| **功能级状态** | 对公司登记、AML、证件和关键人员分别进行独立的状态跟踪 |
| **风险评估** | 为每项检查提供警告标签，并通过工作流操作，将企业状态、AML 结果和股权结构相关发现转化为最终结论 |
| **Webhook** | 通过 [Webhook](https://docs.didit.me/zh/integration/webhooks.md) 实时接收会话生命周期和数据更新事件 |

## 企业会话与用户会话

| 功能 | 用户会话 | 企业会话 |
| - | - | - |
| **目标** | 个人 | 公司或法律实体 |
| **会话类型** | `user`（默认） | `business` |
| **核心检查** | 身份证件、活体检测、人脸比对、AML | 登记查询、UBO、高管、企业反洗钱 |
| **附加检查** | 电话、邮箱、地址证明、NFC | 证件收集、个人反洗钱、KYC 关联 |
| **Webhook 载荷** | 标准会话事件 | 包含 `session_kind: "business"` 和 `business_session_id` |

## 后续步骤

> [card] [企业档案](https://docs.didit.me/zh/business-verification/business-profiles.md)
>
> 通过档案、标签和批量操作，跨会话跟踪企业。

> [card] [企业数据](https://docs.didit.me/zh/business-verification/company-data.md)
>
> 登记查询、企业状态和数据交叉比对。

> [card] [股权结构](https://docs.didit.me/zh/business-verification/ownership.md)
>
> UBO 识别、企业股东和股权链。

> [card] [高管与董事](https://docs.didit.me/zh/business-verification/officers.md)
>
> 董事识别、职务和 KYC 关联。

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

> [card] [证件](https://docs.didit.me/zh/business-verification/documents.md)
>
> 证件收集、请求和 OCR 核验。


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