> ## 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）快速入门：10 分钟完成

> 使用 Didit 在 10 分钟内完成企业端到端验证：涵盖公司登记查询、实际受益人、高管、AML 筛查和 Webhook。按国家和等级计费，单次检查起价 $2.00，无需签约。

本指南将带您在 10 分钟内完成一次完整的 KYB 验证。您将创建工作流、启动会话、将托管验证链接发送给企业联系人、等待 Webhook，并获取最终决策。

## 前提条件

* 已开通 KYB 功能的 Didit 应用。如尚未创建，请前往 [business.didit.me](https://business.didit.me) 创建。
* 来自 *开发者设置 → API 密钥* 的 API 密钥。
* 可从互联网访问的 Webhook endpoint（用于接收决策 Webhook）。

## 步骤

**1. 在控制台中创建 KYB 工作流**

前往 *工作流 → 创建工作流*。将工作流类型选择为 **企业验证**。

启用所需功能：

* **公司登记查询**（必选）
* **企业反洗钱**（建议启用）
* **关键人员**（大多数受监管行业必选）
* **证件**（可选，选择您需要的证件类型）

保存并复制 `workflow_id`，您将在下一步中使用它。

**2. 通过 API 创建企业验证（KYB）会话**

```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": "biz-acme-001"
  }'
```

响应包含 `session_id`、`session_number` 和 `url`，即您发送给企业联系人的托管验证链接。工作流的类型（KYB）会自动将该会话标记为企业会话。

**3. 将链接发送给您的企业联系人**

通过您自己的电子邮件或聊天工具，将 `url` 发送给企业管理员。对方打开链接后，将填写登记信息、添加关键人员和 UBO，并上传证件。

您可以通过品牌、徽标和域名自定义托管体验，详见 [白标](https://docs.didit.me/zh/console/white-label.md)。

**4. 接收状态 Webhook**

当企业完成流程且 KYB 处理达到终态时，Didit 会向您的 Webhook endpoint POST 一个 `status.updated` 事件。企业会话事件在 `data` 中包含 `session_kind: "business"`，请据此筛选，将事件路由到您的 KYB 处理程序。

在信任事件之前，请验证 `X-Signature-V2` HMAC 签名（详见 [Webhook](https://docs.didit.me/zh/integration/webhooks.md)），然后触发后续逻辑。将 Webhook 目标的 `secret_shared_key`（注册 Webhook 时返回）保存为 `.env` 中的 `DIDIT_WEBHOOK_SECRET`。

示例 payload：

```json theme={null}
{
  "event_id": "7f3c2c1e-6a1d-4c36-9d8e-0d3b5f4e2a10",
  "webhook_type": "status.updated",
  "session_id": "a1b2c3d4-5678-4abc-9def-1234567890ab",
  "business_session_id": "a1b2c3d4-5678-4abc-9def-1234567890ab",
  "session_kind": "business",
  "vendor_data": "biz-acme-001",
  "status": "Approved",
  "created_at": 1776515400,
  "timestamp": 1776515401,
  "decision": { "...": "full KYB decision" }
}
```

**5. 获取决策（可选）**

> [!NOTE]
>
> `status.updated` Webhook payload 已包含完整决策。只有在您未订阅 Webhook，或希望稍后按需获取决策时，才需要调用此 endpoint。

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

决策包括登记数据、关键人员（UBO、股东、董事和代表）、AML 命中结果、证件以及各功能的结果。完整 payload 参考请见 [响应结构](https://docs.didit.me/zh/business-verification/response-schema.md)。

**6. 根据决策采取行动**

根据 `status` 进行处理：

* `"Approved"`：为该企业办理入驻。
* `"Declined"`：拒绝，并记录决策中的 `warnings[]` 标签。
* `"In Review"`：等待审核员做出决定。决定确定后，您将收到另一条 Webhook。

## Node.js 示例

```typescript theme={null}
import fetch from 'node-fetch';

const API_KEY = process.env.DIDIT_API_KEY!;
const WORKFLOW_ID = process.env.DIDIT_KYB_WORKFLOW_ID!;
const BASE_URL = 'https://verification.didit.me';

async function startKybVerification(vendorData: string) {
  const res = await fetch(`${BASE_URL}/v3/session/`, {
    method: 'POST',
    headers: {
      'x-api-key': API_KEY,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ workflow_id: WORKFLOW_ID, vendor_data: vendorData }),
  });
  if (!res.ok) throw new Error(`Session create failed: ${res.status}`);
  return res.json();
}

async function getDecision(sessionId: string) {
  const res = await fetch(`${BASE_URL}/v3/session/${sessionId}/decision/`, {
    headers: { 'x-api-key': API_KEY },
  });
  return res.json();
}

// Kick off the flow
const { session_id, url } = await startKybVerification('biz-acme-001');
console.log('Deliver this URL to your contact:', url);

// ... later, after the webhook confirms completion:
const decision = await getDecision(session_id);
console.log('KYB status:', decision.status);
```

## 自动执行的操作

* 覆盖 190+ 个司法辖区的公司登记查询。
* 从登记数据中提取 UBO 和高管信息。
* 企业层面的 AML 筛查（制裁、PEP、负面新闻）。
* 对每个已识别主体进行个人层面的 AML 筛查。
* 证件 OCR 识别与交叉核对。
* 以 `vendor_data` 为键创建并汇总 [企业档案](https://docs.didit.me/zh/business-verification/business-profiles.md)。

## 后续步骤

> [card] [集成指南](https://docs.didit.me/zh/business-verification/integration-guide.md)
>
> 端到端架构、轮询与 Webhook 对比、重试逻辑。

> [card] [KYB Webhook](https://docs.didit.me/zh/business-verification/webhooks.md)
>
> 每个 KYB 事件及其 payload 结构。

> [card] [状态](https://docs.didit.me/zh/business-verification/statuses.md)
>
> 会话、功能和登记状态参考。

> [card] [响应结构](https://docs.didit.me/zh/business-verification/response-schema.md)
>
> 完整的 KYB 决策 payload。

> [card] [企业实体](https://docs.didit.me/zh/entities/businesses/overview.md)
>
> 档案如何跨会话汇总。


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