> ## 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 文件 API：采集、OCR 识别并交叉核验企业证件，包括登记证书、公司章程和财务报表。注册表核验与注册信息查询分开计费。

企业验证包含结构化的证件收集，用于验证登记册中未提供的企业信息。

## 定价

企业证件收集每个**工作流步骤收取 \$0.20**，与该步骤中上传的证件数量无关。在同一步骤中重新上传证件不会产生额外费用；单独的证件收集步骤有其自己的费用。

## 证件分组

证件分为四个结构化分组，每个分组对应企业验证所需的一类证据，另外还有一个兜底分组，用于存放 Didit 无法分类的证件：

| 分组（`document_group`） | 说明 | 已识别的证件子类型 |
| - | - | - |
| **法律存续**（`LEGAL_PRESENCE`） | 证明企业依法存续的证件 | `CERTIFICATE_OF_INCORPORATION`、`CERTIFICATE_OF_GOOD_STANDING`、`CERTIFICATE_OF_INCUMBENCY`、`REGISTRY_EXCERPT`、`BUSINESS_LICENSE`、`TAX_REGISTRATION` |
| **公司详情**（`COMPANY_DETAILS`） | 描述企业当前详细信息的证件 | `CONFIRMATION_STATEMENT`、`ANNUAL_RETURN`、`STATEMENT_OF_INFORMATION` |
| **所有权结构**（`OWNERSHIP_STRUCTURE`） | 证明股权链条的证件 | `SHAREHOLDER_REGISTRY`、`MEMORANDUM_OF_ASSOCIATION`、`ARTICLES_OF_ASSOCIATION` |
| **代表授权**（`REPRESENTATIVES_AUTHORIZATION`） | 证明有权代表企业行事的证件 | `DIRECTOR_REGISTRY`、`POWER_OF_ATTORNEY`、`TRUST_AGREEMENT` |
| **其他**（`OTHER`） | Didit 无法可靠分类的任何证件 | `UNKNOWN` |

每个分组通过以下计数器跟踪各自的进度：`total`、`approved`、`pending`、`declined`、`in_review`、`other` 和 `missing`。业务会话的整体证件状态汇总所有分组的结果。

## 证件类型

| 类别 | 示例 |
| - | - |
| **设立类证件** | 注册证书、公司章程、组织大纲 |
| **所有权类证件** | 股东名册、股票证书、UBO 声明 |
| **地址类证件** | 注册地址的水电费账单、银行对账单或租赁协议 |
| **财务类证件** | 年度账目、审计报告、财务报表 |
| **税务类证件** | 税务登记证明、纳税合规证明 |
| **监管类证件** | 牌照、许可证、监管批准 |
| **自定义证件** | 您的合规流程要求的任何其他证件 |

## 证件工作流程

**1. 自动请求**

根据您的工作流配置，Didit 会自动识别企业验证所需的证件，并向企业展示需要上传的证件类型。

**2. 上传**

证件可通过托管验证流程、Business Console 上传，或通过 [上传证件](https://docs.didit.me/zh/sessions-api/kyb-upload-documents.md) 接口从您自己的前端上传。支持的格式为 PDF、JPG、JPEG、PNG、TIFF 和 WebP，或它们的 ZIP 压缩包。PDF 最大 50 MB，照片在压缩前最大 6 MB。对于有密码保护的 PDF，通过 API 上传时请在 `document_passwords` 中提交密码。

**3. OCR 提取**

Didit 使用 OCR 从已上传的证件中提取结构化数据：

* 证书中的企业名称和注册号
* 水电费账单中的地址信息
* 报表中的财务数据
* 股东名册中的姓名和职务

**4. 交叉比对**

提取的数据将与以下内容进行交叉比对：

* 企业查询获得的登记数据
* 创建会话时提供的信息
* 其他已上传证件中的数据

如存在不一致之处，将标记出来，供分析师审核。

**5. 审核**

分析师在控制台中审核已上传的证件，核实其真实性，并逐一批准或拒绝每份证件。

## 分析师证件请求

在审核过程中，分析师可以请求补充证件：

1. 在控制台中进入企业会话
2. 点击 **请求证件**，并指定证件类型和说明
3. 系统会通知企业，企业可上传所请求的证件
4. 在上传之前，该证件会以 **已请求** 状态显示在会话中

这样，分析师无需拒绝整个企业会话，即可补充收集更多证据。

## 证件状态

每份证件以及汇总的 `document_verifications[]` 检查均使用标准 KYB 功能状态集：

| 状态 | 说明 |
| - | - |
| `"Not Finished"` | 证件仍在处理中（正在上传、OCR 运行中或交叉核验待处理）。 |
| `"Approved"` | 证件已审核并通过。 |
| `"Declined"` | 证件已审核并被拒绝。 |
| `"In Review"` | 证件需要分析师人工处理。 |
| `"Resub Requested"` | 分析师要求重新提交，企业必须重新上传该证件，会话才能继续推进。 |

## 交叉核验结果

处理证件时，Didit 会将 OCR 提取的数据与关键人员流程中提交的**用户提供的数据**（以及公司登记审核期间确认的任何数据）以及其他已上传的证件进行交叉比对。交叉核验会生成结构化结果：

| 类别 | 说明 |
| - | - |
| **关键字段** | 证件数据与用户提供的数据不一致的字段，需要分析师审核。每个字段显示证件中的值、用户提供的值以及置信度分数。 |
| **非关键字段** | 存在轻微差异或格式差别的字段，可能无需操作（例如企业名称中的简称差异）。 |
| **人员重叠** | 对证件中提及的人员与用户提交的人员进行分析，突出显示缺失或额外的人员。 |

交叉核验结果会与证件预览一同显示在 [Business Console](https://docs.didit.me/zh/business-verification/console.md) 中，使分析师能够清楚看到哪些内容一致、哪些需要关注。

## 通过 API 获取证件

证件关联到企业验证（KYB）会话。通过会话决策获取证件：

```bash theme={null}
curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"
```

响应中包含 `document_verifications[]` 数组，每个条目都包含 `status`、`node_id`、`items[]`（每项包含已签名的 `file_url`、`document_group`、`document_subtype` 和 OCR 提取结果）、`groups` 和 `required_groups`。完整结构请参阅 [响应结构](https://docs.didit.me/zh/business-verification/response-schema.md#document_verifications)。

## 后续步骤

> [card] [响应结构](https://docs.didit.me/zh/business-verification/response-schema.md)
>
> 证件在响应 payload 中的位置。

> [card] [Business Console](https://docs.didit.me/zh/business-verification/console.md)
>
> 作为分析师审核证件。


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