企业验证（KYB）API：公司登记与实际受益人

Didit 的企业验证（KYB）可以在将企业和法律实体入驻您的平台之前对其进行核验。系统会自动查询公司登记信息，识别实际受益人和高管，对所有相关方进行 AML 观察名单筛查，并收集辅助证明文件，这些步骤都在一个工作流中完成。每家通过核验的企业都会作为一份企业档案进行跟踪，汇总各次会话的结果。本 Didit Academy 课程将完整演示一次企业验证流程：KYB 控制台、登记信息核查、股东与 UBO、AML 筛查，以及企业代表端看到的内容。初次接触 Didit KYB？请先阅读快速入门，了解 10 分钟的端到端操作流程，然后阅读集成指南，了解生产环境的实践模式。关于底层的企业实体模型（涵盖与用户的关联、黑名单以及导入和导出），请参阅企业。

工作原理

创建企业会话

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

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 工作流会自动创建企业会话，并启用企业专属功能。

企业登记信息查询

Didit 会以 Lite、股东或 UBO 层级查询官方公司登记机构，各层级的费用按国家/地区计算，参见登记查询定价。Lite 层级可获取以下信息：

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

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

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

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

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

同一人可以拥有多个角色标签（例如，既是董事，又是股东）。每个角色均在工作流中单独配置，包括哪些角色需要 KYC、使用哪个 KYC 工作流，以及终端用户能否跳过验证。详情请参阅关键人员和股权结构。

AML 筛查

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

企业反洗钱：对企业实体进行制裁名单、负面新闻和监管执法名单筛查
个人反洗钱：对每位关键人员（UBO、股东、董事、代表等）单独进行筛查
采用与用户验证相同的双分数风险体系（匹配分数加风险评分）

文件收集

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

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

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

审核与决策

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

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

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

企业会话生命周期

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

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

每个会话都有唯一的 session_id、顺序编号 session_number，以及用于托管验证链接的 session_token。当会话创建时带有 vendor_data 标识符，Didit 会自动将其关联到对应的企业档案。

功能状态

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

功能	说明
公司登记核验	企业登记处查询与数据提取
企业反洗钱	针对制裁名单和观察名单，对企业主体进行 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`	关联的企业实体状态发生变化（`ACTIVE` / `FLAGGED` / `BLOCKED`）。
`business.data.updated`	关联企业实体的档案字段或汇总计数器发生变化。

Webhook 载荷中包含 session_kind: "business" 和 business_session_id，用于将其与用户验证事件区分开。有关签名验证和投递详情，请参阅 Webhook。

核心能力

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

企业会话与用户会话

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

后续步骤

企业档案

通过档案、标签和批量操作，跨会话跟踪企业。

企业数据

登记查询、企业状态和数据交叉比对。

股权结构

UBO 识别、企业股东和股权链。

高管与董事

董事识别、职务和 KYC 关联。

AML 筛查

企业层面和个人层面的 AML 检查。

证件

证件收集、请求和 OCR 核验。

​工作原理

​企业会话生命周期

​功能状态

​Webhook 事件

​核心能力

​企业会话与用户会话

​后续步骤

企业档案

企业数据

股权结构

高管与董事

AML 筛查

证件

工作原理

企业会话生命周期

功能状态

Webhook 事件

核心能力

企业会话与用户会话

后续步骤