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

# Zapier 身份验证自动化

> 通过 Didit Zapier 应用自动化身份验证流程，可在 6,000+ 应用中触发验证并监听结果。按次付费定价。

通过 Zapier 将 Didit 连接到 **6,000+ 应用**，无需编写代码。自动创建验证会话，响应状态变化，并将结果同步到您的 CRM、数据库或通信工具。

> [card] [在 Zapier 上打开 Didit](https://zapier.com/apps/didit/integrations)
>
> 在 Zapier 应用市场中浏览触发器、操作和现成的模板。

[Didit Zapier 集成](https://www.youtube.com/embed/D7X4kNHxX0A?rel=0\&playsinline=1)

***

## 您将获得什么

> [card] 创建会话
>
> 通过表单提交、CRM 事件或任何与 Zapier 连接的应用触发验证会话。

> [card] 实时 Webhook
>
> 以 Zapier 触发器的形式即时接收状态更新（Approved、Declined、In Review 等）。

> [card] 获取结果
>
> 按需获取完整的会话详情，包括身份数据、活体检测分数和 AML 命中记录。

***

## 前提条件

| 要求 | 获取途径 |
| - | - |
| **Didit 账户** | 在 [business.didit.me](https://business.didit.me) 注册，免费的 KYC 套餐即可用于测试。 |
| **API 密钥** | 控制台 → **API 和 Webhook** → 复制生产环境密钥。Zapier 应用的每项操作都使用此密钥进行身份验证。 |
| **工作流 ID** | 控制台 → **工作流** → 选择要启动的工作流（或[创建一个](https://docs.didit.me/zh/console/workflows.md)）。 |
| **Zapier 账户** | 免费或付费版均可，详见 [zapier.com](https://zapier.com)。免费套餐每月可处理 100 个任务，足以用于小型试点。 |

***

## 工作原理

**1. 将 Didit 连接到 Zapier**

在 Zapier 的应用目录中搜索 **Didit**（或直接打开[应用市场页面](https://zapier.com/apps/didit/integrations)），然后使用控制台 → **API 和 Webhook** 中的 **API 密钥** 连接您的账户。

> [!TIP]
>
> 您的 API 密钥用于对 Zapier 中所有 Didit 操作进行身份验证。您只需连接一次，所有 Zap 共享同一连接。在控制台中轮换密钥后，Zapier 连接会失效，直到您重新连接。

**2. 设置触发器**

选择用于启动 Zap 的事件，可以是 **Didit 触发器**，也可以是其他任何应用：

| 触发来源 | 示例 |
| - | - |
| **Didit Webhook** | 会话状态变为 "Approved" |
| **Google Forms** | 新表单提交 → 创建验证会话 |
| **HubSpot** | 新建联系人 → 触发 KYC |
| **Stripe** | 新客户 → 在发放款项前验证身份 |
| **Typeform** | 入驻表单提交完成 → 开始验证 |

**3. 添加 Didit 操作**

使用以下可用的 Didit 操作之一（名称与 [Zapier 应用市场页面](https://zapier.com/apps/didit/integrations)一致）：

**Create Verification Session**：封装 `POST /v3/session/`

* 提供要执行的验证流程的 **工作流 ID**。
* 可选设置 **回调 URL**，用于验证完成后的跳转。
* 传入 **供应商数据**（例如用户邮箱或您的内部 ID），以便将会话关联回您的记录。
* 该操作会返回新的 `session_id`、面向用户的 `url` 以及初始 `status`。请使用 `url` 将用户引导至验证流程。

**Retrieve Verification Session**：封装 `GET /v3/session/{sessionId}/decision/`

* 传入 `session_id` 以获取完整的验证结果。
* 可访问身份证件数据、活体检测分数、AML 结果、最终 `status` 以及上传媒体的 URL。

**4. 根据结果执行后续操作**

根据验证结果添加后续操作：

| 状态 | 建议操作 |
| - | - |
| `"Approved"` | 更新 CRM，授予平台访问权限，发送欢迎邮件 |
| `"Declined"` | 在数据库中标记，通知合规团队，发送拒绝邮件 |
| `"In Review"` | 为合规团队创建任务，发送 Slack 通知 |
| `"Abandoned"` | 发送包含新验证链接的提醒邮件 |

![在 Zapier 操作步骤中创建 Didit 身份验证会话](https://mintcdn.com/didit-0f962782/DSfxHq_ggIpqiQSG/images/zapier-create-session.png?fit=max\&auto=format\&n=DSfxHq_ggIpqiQSG\&q=85\&s=f847a30aa1e0b600543ae4dec6229cdd)

通过 Zapier 操作创建 Didit 验证会话。

***

## 热门 Zap 模板

> [card] Google Forms → Didit → Gmail
>
> 用户填写入驻表单 → 创建验证会话 → 结果通过邮件发送给用户和管理员。

> [card] HubSpot → Didit → HubSpot
>
> 新建联系人 → 触发 KYC → 将验证状态和身份证件数据更新到联系人属性中。

> [card] Stripe → Didit → Slack
>
> 新客户 → 验证身份 → 在 Slack 中通知您的团队结果。

> [card] Webhook → Didit → Airtable
>
> 自定义触发器 → 验证用户 → 将会话结果记录到 Airtable 中，用于合规留档。

***

## 可用的触发器与操作

以下名称与 [应用市场](https://zapier.com/apps/didit/integrations)上当前的 Didit Zapier 应用一致。如果您在 Zapier 中看到的标签略有不同，请以 Zapier 界面为准，底层行为是相同的。

### 触发器（启动 Zap）

| 触发器 | 对应事件 | 说明 |
| - | - | - |
| **Session Status Updated** | [`status.updated` Webhook](https://docs.didit.me/zh/integration/webhooks) | 每当验证会话状态发生变化时触发（`Approved`、`Declined`、`In Review`、`Resubmitted`、`Abandoned`、`Kyc Expired` 等）。 |

### 操作（执行任务）

| 操作 | 对应 endpoint | 说明 |
| - | - | - |
| **Create Verification Session** | `POST /v3/session/` | 使用您的工作流启动新会话，可选设置回调 URL 和 `vendor_data`。返回可分享给用户的会话 URL。 |
| **Retrieve Verification Session** | `GET /v3/session/{sessionId}/decision/` | 根据给定的 `session_id` 获取完整的决策 payload，包括身份证件数据、活体检测结果、AML 命中记录以及最终状态。 |

***

## 注意事项

> [!WARNING]
>
> Didit Zapier 应用有意将范围限定在**价值最高的自动化场景**：发起会话和响应状态更新。以下功能目前未通过 Zapier 开放，需要直接调用 API：
>
> * 在 Zap 步骤中上传证件图像、视频或地址证明（POA）文件。
> * 通过 [`PATCH /v3/session/{sessionId}/update-status/`](https://docs.didit.me/zh/sessions-api/update-status) 进行决策覆盖。
> * KYB 专用端点（公司登记、关键人员）。
> * 会话级状态变更以外的 Webhook 事件类型（例如 `transaction.status.updated`、`user.status.updated`）。
>
> 如果你需要在无代码工具中使用上述任一功能，可以通过 Zapier 的 **Webhooks by Zapier** 步骤，使用你的 API 密钥调用 [Sessions API](https://docs.didit.me/zh/sessions-api/create-session.md)。

***

## 使用技巧与最佳实践

> [accordion] 使用供应商数据关联会话
>
> 创建会话时，请始终在 **供应商数据** 字段中传入唯一标识符（邮箱、用户 ID 或 UUID）。这样你就能将验证结果与系统中的正确用户对应起来。

> [accordion] 处理所有状态结果
>
> 使用 Zapier 的 Paths 功能构建 Zap 路径，对不同状态进行区别处理。已通过、已拒绝、审核中、已重新提交、已放弃和已过期，每种状态都应有对应的处理方式。

> [accordion] 使用过滤器减少干扰
>
> 添加 Zapier Filters，使后续操作仅针对特定状态触发。例如，仅当状态为 `"Approved"` 时才发送欢迎邮件。

> [accordion] 正式上线前先测试
>
> 在处理真实用户之前，请结合 Zapier 的测试功能与 Didit 控制台中的 **Try Webhook** 按钮（位于 **API & Webhooks** 下），对 Zap 进行端到端验证。

***

## 后续步骤

> [card] [快速入门指南](https://docs.didit.me/zh/getting-started/quick-start.md)
>
> 设置你的 Didit 账户，创建工作流，并获取你的 API 密钥。

> [card] [Webhooks](https://docs.didit.me/zh/integration/webhooks.md)
>
> 了解 Webhook payload 和签名验证，用于服务端集成。


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