> ## 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.

# 验证链接：托管 KYC 链接与二维码

> 在 Didit 控制台或 API 中创建安全的验证链接和二维码，无需前端开发，几分钟即可启动托管式身份验证。

验证链接是一个唯一的安全 URL，可将终端用户引导至完全由 Didit 托管的验证流程。您可以在 Business Console 中设计验证步骤和逻辑，Didit 负责用户界面、数据采集和安全保障。这样，您通常无需编写代码，几分钟内即可启动一套可靠的验证流程。

此方法属于 **Orchestrated Workflows** 集成路径，让您在保持极简操作的同时，充分利用工作流引擎的能力。

***

## 工作原理

**1. 配置您的工作流**

在 [Didit Business Console](https://business.didit.me) 中，使用无代码编辑器设计一个工作流，包含您所需的确切检查顺序（例如：证件扫描 → 活体检测 → AML 筛查）。每个工作流都有唯一的 `workflow_id`。

**2. 生成验证链接**

为用户创建唯一会话。您可以直接在 Business Console 中以**无代码**方式完成，也可以通过一次 API 调用，以**低代码**方式调用 [创建会话](https://docs.didit.me/zh/sessions-api/create-session.md) endpoint 完成。

**3. 分享链接**

通过任意渠道将生成的 URL 发送给用户，例如电子邮件、短信、应用内消息，或将其嵌入 iframe。

**4. 获取实时结果**

随着用户推进验证流程，以及最终验证结果准备就绪时，Didit 会向您配置的 [Webhook URL](https://docs.didit.me/zh/integration/webhooks.md) 发送自动更新。

***

## 生成验证链接

### 方法 1: 通过 Business Console 无代码生成

此方法适合快速上手、人工处理流程或没有开发资源的团队。

1. 前往 [Didit Business Console](https://business.didit.me) 中的 **验证** 部分。
2. 点击 **+ Create Verification**。
3. 选择要用于此会话的 `workflow_id`。
4. （可选）输入 `vendor_data`（例如您系统中的用户 ID），以将该验证与您的用户关联。
5. 系统会立即生成**唯一 URL 和二维码**。
6. 复制链接，让用户扫描二维码，或直接将链接发送至用户的电子邮箱。

### 方法 2: 通过 API 低代码生成

此方法可实现完全自动化，是将验证链接集成到应用逻辑中的标准方式。

向 `/v3/session/` endpoint 发送一个 `POST` 请求，并附上您的 API 密钥和 `workflow_id`：

```bash theme={null}
curl --request POST \
     --url https://verification.didit.me/v3/session/ \
     --header 'x-api-key: YOUR_API_KEY' \
     --header 'Content-Type: application/json' \
     --data '{
       "workflow_id": "550e8400-e29b-41d4-a716-446655440000",
       "vendor_data": "your_internal_user_id_123",
       "callback": "https://yourapp.com/didit/webhook/handler"
     }'
```

API 将返回一个 JSON 对象，其中包含 `session_id` 和唯一的验证 `url`：

```json theme={null}
{
  "session_id": "11111111-2222-3333-4444-555555555555",
  "session_number": 1234,
  "vendor_data": "your_internal_user_id_123",
  "status": "Not Started",
  "workflow_id": "550e8400-e29b-41d4-a716-446655440000",
  "callback": "https://yourapp.com/didit/webhook/handler",
  "url": "https://verify.didit.me/session/abcdef123456"
}
```

> [!NOTE]
>
> 完整的 API 详情请参阅 [创建会话 API 参考](https://docs.didit.me/zh/sessions-api/create-session.md)。

***

## 何时使用验证链接

> [card] 快速上线
>
> 数小时内即可启动完整、安全且合规的验证流程，而非数周。

> [card] 无需前端开发
>
> 将整个用户界面（证件采集、活体检测和用户引导）交由 Didit 预构建的 UI 处理。

> [card] 多渠道投递
>
> 通过电子邮件、短信、客服聊天或任何其他沟通渠道发送验证请求。

> [card] 线下入驻
>
> 在线下场景中使用二维码，让用户在自己的设备上完成验证。

***

## 后续步骤

* **配置您的第一个工作流**：前往 [Business Console](https://business.didit.me) 设计您的验证流程。
* **设置您的 Webhook**：在 [处理 Webhook](https://docs.didit.me/zh/integration/webhooks.md) 指南中了解如何接收实时状态更新。
* **探索 Unilinks**：如需一种可复用且无需后端的替代方案，请参阅 [Unilinks](https://docs.didit.me/zh/console/uni-links.md)。


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