企业验证（KYB）快速入门：10 分钟完成

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

前提条件

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

步骤

在控制台中创建 KYB 工作流

前往 工作流 → 创建工作流。将工作流类型选择为 企业验证。启用所需功能：

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

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

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

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）会自动将该会话标记为企业会话。

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

通过您自己的电子邮件或聊天工具，将 url 发送给企业管理员。对方打开链接后，将填写登记信息、添加关键人员和 UBO，并上传证件。您可以通过品牌、徽标和域名自定义托管体验，详见白标。

接收状态 Webhook

当企业完成流程且 KYB 处理达到终态时，Didit 会向您的 Webhook endpoint POST 一个 status.updated 事件。企业会话事件在 data 中包含 session_kind: "business"，请据此筛选，将事件路由到您的 KYB 处理程序。在信任事件之前，请验证 X-Signature-V2 HMAC 签名（详见 Webhook），然后触发后续逻辑。将 Webhook 目标的 secret_shared_key（注册 Webhook 时返回）保存为 .env 中的 DIDIT_WEBHOOK_SECRET。示例 payload：

{
  "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" }
}

获取决策（可选）

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

curl https://verification.didit.me/v3/session/bs_01H.../decision/ \
  -H "x-api-key: YOUR_API_KEY"

决策包括登记数据、关键人员（UBO、股东、董事和代表）、AML 命中结果、证件以及各功能的结果。完整 payload 参考请见响应结构。

根据决策采取行动

根据 status 进行处理：

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

Node.js 示例

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 为键创建并汇总企业档案。

后续步骤

集成指南

端到端架构、轮询与 Webhook 对比、重试逻辑。

KYB Webhook

每个 KYB 事件及其 payload 结构。

状态

会话、功能和登记状态参考。

响应结构

完整的 KYB 决策 payload。

企业实体

档案如何跨会话汇总。

​前提条件

​步骤

​Node.js 示例

​自动执行的操作

​后续步骤

集成指南

KYB Webhook

状态

响应结构

企业实体

前提条件

步骤

Node.js 示例

自动执行的操作

后续步骤