> ## 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 视频文字稿：介绍如何可视化搭建身份验证（KYC）工作流，涵盖检查项、分支逻辑、风险规则、测试及发布到生产环境。

[无需代码构建 KYC 验证工作流（完整教程）](https://www.youtube.com/embed/7-nJ3JE20i4)

**无需代码构建 KYC 验证工作流（完整教程）** 完整文字稿，Didit Academy 第 3 讲，共 10 讲，时长 18:54。[在 YouTube 上观看](https://www.youtube.com/watch?v=7-nJ3JE20i4)。每个段落都链接到视频中的对应时刻。

> [!NOTE]
>
> 定价已于 2026 年 11 月 1 日调整：使用企业邮箱注册的组织，原来每月 500 次免费检查改为每月 \$10 的额度。视频展示的是此前的定价。

## 什么是工作流

[00:03](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=3s) 在本视频中，我们将从零开始搭建一个完整的验证流程，全程无需编写一行代码。工作流本质上就是验证的“配方”，它规定了要运行哪些检查以及按什么顺序运行。通常这类工作由工程师负责。但在 Didit 中，您可以直接以可视化的方式自行搭建。编辑时您可以实时看到价格变化，准备好后随时可以正式上线。

[00:28](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=28s) 如果您想自己动手搭建，可以访问 didit.me，免费注册，几分钟内就能完成第一个工作流。好，我们先从每个验证流程的起点开始，也就是

## 工作流列表与工作流 ID

[00:39](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=39s) 配置标签页下方的工作流列表。这个账户中现有的所有工作流都列在这里，您可以看到每个工作流的类型。这里有 KYC 和 KYB，也有简单和图谱两种结构，并且可以看到每个工作流包含的所有检查项和功能。您还能看到价格差额，也就是说，这里显示的是：一个用户只完成一项检查、未走完流程的价格，与一个用户完成整个流程的价格之间的差距。每个工作流都有一个对应的链接。

[01:09](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=69s) 我们可以手动新增一个会话，可以复制工作流 ID，也可以复制、重命名、归档，所有常规操作都可以完成。这里就是您的工作流 ID。同一个工作流的多个版本会共用同一个 ID，因此，如果您更新了工作流，无需修改代码或应用中的任何内容。最简单的理解方式是：工作流就是验证的配方，即运行哪些检查、按什么顺序运行，以及遵循哪些规则。两种不同的

## 简单工作流与图谱工作流

[01:40](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=100s) 结构，就像我刚才提到的，一种是简单，一种是图谱。简单流程只包含一项或几项检查，没有任何分支，也没有条件逻辑。配置快捷，适用于大多数场景。您只需选择模块即可完成。以这个示例工作流为例，您可以在左侧选择模块，系统会按顺序依次排列它们。接下来是

## 带分支的图谱工作流

[02:05](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=125s) 图谱工作流。如果点进来，可以看到末尾有一些分支，这样就能更精细地控制用户在验证流程中的走向。比如在这个工作流中，有多个不同的分支点。我们还可以加入 Webhook 调用。总的来说，需要时我们还能增加一些复杂度。

[02:30](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=150s) 另外要说明的是，KYB 工作流的外观完全相同，只是检查项不同。好的。如果要添加检查项，可以在这里添加。我们可以拖入一个用户操作，也可以设置一些后台检查。后台检查是用户在前端看不到的检查。所以，

## 从模板创建新工作流

[02:51](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=171s) 您只需点击新建工作流。这里有几个选项：KYC、KYB。我们选择 KYC。另外还有简单和高级两种版本，就像我之前展示的那样，两种我都会介绍。如果点击简单，这里有大量面向各行业的模板，并且可以看到每个模板的费用。有年龄门槛模板，也有邮箱验证模板。

[03:19](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=199s) 还有生物识别认证、保险、医疗等各种模板。再比如，如果我们选择企业验证（KYB），并使用高级版本，也就是图谱版，会看到大量不同的模板，或者说配方。例如，我们可以直接设置高风险国家 KYB，就这么简单。您甚至不需要在这里拖放任何内容，它已经搭建好了。所以每个

## 为每个节点选择检查项

[03:48](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=228s) 节点都有一个下拉菜单，您可以直接选择想要的检查项。可以像这里一样更改，也可以加入公司登记核验，任何您需要的都可以。身份证件验证、活体检测、人脸比对、AML 筛查、地址证明。Didit 为 KYB 和 KYC 提供的所有检查项，都可以在这些节点中找到。因此，如果我想在这里添加一项检查，比如 AML 筛查，就可以把它加进来。我们稍后会讲解规则和这些标签页，但您可以看到，我已经把它加入了这个工作流。所以，如果您进入一个 KYC 图谱工作流，大多数此类工作流都会以身份证件验证开始，这是最常见的

## 深入了解身份证件验证节点

[04:33](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=273s) 检查。您可以在这里看到，这是身份证件验证节点。每月有 500 次免费检查，活体检测和人脸比对同样每月 500 次。这个身份证件验证不只是读取证件上的文字，它还能证明证件是真实的：检查防伪特征、识别篡改痕迹、分析字体和版式，然后提取每个字段，包括姓名、出生日期、证件号码、有效期等，全部通过 OCR 完成，支持任何语言，覆盖所有 14,000 多种受支持的证件类型。因此，这绝不只是文字识别，它先做真伪检测，然后才是数据提取。好，我们来配置其中一个模块。

## 活体检测模式及各自费用

[05:15](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=315s) 我的意思是，如果我们进入活体检测模块，您可以看到有几种不同的活体检测模式。被动式模式使用自拍照来检测活体。闪光式模式则通过动态光图案来确认活体，以识别真实用户的人脸。3D 动作式模式会通过某种动作来确认光照，例如眨眼或转动头部。现在您可以看到，被动式活体检测每月有 500 次免费额度，之后每次检测收费 10 美分；闪光式和 3D 动作式每次检测收费 15 美分。另外，免费账户不包含任何免费检测次数。接下来，在规则标签页中，

## 规则：阈值、重复人脸与多张人脸

[05:56](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=356s) 这里决定该模块是必需还是可选。如果我们进入规则标签页，可以看到有几个不同的选项。这些选项用于配置检测的灵敏度，因此我们可以设置容差级别。如果某人的活体分数低于 70，系统会将其转入审核中，当然，我们可以根据需要修改这个值。拒绝的设置也是一样。我们还可以设置重复人脸的规则：当用户的人脸与之前已通过的会话中的人脸匹配时，我们该如何处理？可以选择通过、审核或拒绝。然后，我们还可以按种族自定义相似度阈值，即根据用户的种族设置重复检测的灵敏度。最后，我们可以定义在活体图像中检测到多张人脸时要执行的操作。系统始终使用最大的人脸进行活体评分。因此，我们可以在这里设置当检测到多张人脸时要执行的操作。如果我们进入

## 高级设置与质量阈值

[06:56](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=416s) 高级标签页，这里有几个不同的选项：人脸隐私模式、活体检测最大尝试次数（即用户在单次验证会话中可以重新尝试活体检测的次数），以及人脸质量阈值。如果您不确定这些设置的作用，可以将鼠标悬停在这里的信息按钮上。我们可以看到，人脸质量衡量的是图像的清晰度、分辨率和锐度。

[07:20](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=440s) 图像质量低可能是由模糊、像素化或光照条件差造成的。因此，我们可以根据人脸质量分数在这里设置阈值。我们还有一个亮度阈值，可以设置可接受的亮度范围。如果亮度低于该范围，我们当然可以将其转入审核或拒绝。最后，如果这些选项都不符合我们想要的

## 返回数据与 GDPR

[07:47](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=467s) 设置，我们还可以设置自定义规则。在返回数据标签页中，我们可以选择要从验证结果中排除的数据点，例如出于 GDPR 等合规要求。现在，对于每个模块，我们都可以看到检测的价格，然后在顶部

## 工作流定价如何计算

[08:00](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=480s) 这里可以看到总价。让我为您详细讲解一下，因为每个节点都有自己的价格，每个工作流的总费用可能会略有不同。您只需为实际运行的步骤付费，每个步骤单独计费。因此，如果申请人在检测中途停止，那么只会对他已经完成的前几项检测收费。所以您会在底部看到 20 美分到 43 美分的价格范围。这就是这个范围：如果申请人只完成第一步就退出，那么您只需支付 20 美分；如果他完整地完成了整个验证工作流，费用是 43 美分。正如您在中间看到的，这些是该工作流中包含的所有模块。我们可以看到每月有多少免费额度。一旦免费额度用完，也就是 500 次检测用完之后，您就会开始为这些检测付费。所以，您可以添加的最强大的模块之一，实际上根本不是摄像头检测，而是

## 基于政府登记库的数据库核验

[09:05](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=545s) 数据库核验。那我们来添加一下。这是一项背景检查，我们来看看它的具体作用，因为这项数据库核验会连接全球各地的官方政府登记库和数据库。它会将用户数据与这些官方来源进行交叉比对，然后用登记库中保存的额外字段来丰富数据。您可以像这里看到的那样，按国家选择要运行的登记库和数据源。每项服务都列出了自己的价格。例如，您可以在这里看到加拿大下面有不同的服务，不同登记库的定价显然也各不相同。如果您想查看某个具体国家，比如德国，我们可以看到德国可用的检查项，并根据需要进行选择。

[09:59](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=599s) 而且，这项数据库核验不仅可以在仪表板中运行，您还可以通过 Didit API 直接从自己的后端调用它。和其他所有模块一样，它也有规则、高级和返回数据选项，因此您可以在这里设置规则。如果我们点击这里的部分匹配，就能看到完全匹配是什么样子。例如，姓名和证件号码都能在登记库中匹配，就是完全匹配；而部分匹配可能只是证件号码匹配。然后，我们可以决定这种部分匹配在您的工作流中意味着什么：是转入审核、拒绝，还是通过？所以，这个工作流里就有一些分支。我们

## AML 分支与条件逻辑

[10:36](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=636s) 可以根据 AML 风险评分设置分支。AML 即反洗钱。您可以看到底部已经为这个 AML 风险评分配置了分支。例如,如果风险评分超过 70,我们可以直接拒绝,点击进入这里即可查看条件逻辑。对吧?这完全可以按您的需要设置。我们有分支一、分支二,以及其他所有情况,即会话将被判定为已通过。比如,如果有人属于这里的这一组,他们会被导向分支二。我们可以要求他们提供更多信息,对吧?例如,可以要求其提供地址证明。这样一来,如果某人风险稍高,我们就可以要求其提供更多信息,以帮助我们判断此人应当通过还是拒绝。另外,我们这里还有其他节点,其中一个是 status 节点。它已经添加在这里了,但您可以在工作流末尾添加这些节点,以确定最终结果。接下来,另一个

## Webhook 节点

[11:40](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=700s) 工作流中还可以包含 Webhook 节点。流程还可以在验证过程中调用您自己的系统,这正是该节点的用途。它可以调用一个 endpoint 并取回数据。流程会等待该 Webhook 返回响应。您可以看到这里有一个 POST Webhook。它带有一个可以修改的 JSON payload。此外,我们还可以发送不同的 payload。这些键值对会将您的会话字段映射到发出的请求中。返回的字段会成为下一个分支用于判断的变量。因此,您可以在一个流程中同时结合 Didit 检查与您自己的风险数据。最后,底部还可以添加请求头,这里是另外一些键值对。我们有基本认证。这些都是您在 Webhook 调用中会期望看到的常见设置。Didit 会校验

## 图结构校验与错误

[12:28](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=748s) 在您构建的整个过程中,Didit 都在持续校验图结构。因此,如果某个节点配置有误或某条路径断开,它会准确指出问题所在。对吧?点击底部,我们会看到流程有两个错误,分支一的规则不完整。它会告诉您工作流内需要修复什么。在这些错误修复之前,我们无法发布此工作流。因此,如果我是新建一个工作流,其中存在错误,我就无法发布它。除单个节点之外,

## 工作流设置: 重试、过期与回调 URL

[12:58](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=778s) 在工作流中,顶部的设置标签页里有这些设置。它们作用于整个工作流,而不是单个检查。这里有工作流名称,当然还有回调 URL,即 Didit 在流程结束后将用户重定向到的地址。如果您希望用户能在桌面端继续,可以允许桌面端访问。还可以修改重试次数,也就是用户在单次验证会话中可以重新尝试证件拍摄的次数。如果之前的尝试失败,我们还有会话过期时间,即未完成的会话在自动过期前保持有效的时长。该设置适用于新创建的会话。还有重试窗口,即允许重试的天数。因此,从

## 为流程配置白标

[13:43](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=823s) 在此工作流中,点击上方的按钮即可进入 Customizations 标签页。白标功能直接内置于流程本身。您可以进入此标签页,开始调整验证流程的外观,包括颜色、品牌标识、电子邮件、域名等等。在这里的预览中,您可以看到它在移动端和桌面端的显示效果。

[14:13](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=853s) 您还可以用不同语言进行测试。如果我们切换为法语,您会看到每项检查现在都以法语显示。如果要开启品牌设置,可以在这里打开。您可以将其切换为我们在 Customizations 标签页中设置的内容,也可以将其关闭。我们还可以看看选择不同路径时会向用户发送什么内容。当然,用户不会看到选择路径模块,这只是为了帮助我们预览下一步会发生什么,对吧?因此,如果用户被拒绝,我们会看到"验证被拒绝"、"验证审核中"或"已通过验证"。我们确实提供复制链接功能

## 可分享链接,以及何时不应使用

[14:58](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=898s) 就在顶部这里。因此,如果我们复制该链接,打开一个新标签页,访问其中的链接,就能看到用户会看到的内容。有时您只想把流程发给某人,而无需编写任何代码。复制链接功能正好可以做到这一点。它会复制此工作流一个可直接分享的托管 URL。这适合快速测试或手动发送,但不是推荐的集成方式。在生产环境中,您应当通过 SDK 或 API 为每位用户创建会话并携带供应商数据,这样才能通过 Webhook 和 SDK 实时获取结果。因此,复制链接适合测试和活动,而正式会话才是您上线生产环境时应当使用的方式。所以

## 版本历史与回滚

[15:41](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=941s) 这里顶部是版本历史。我们可以看到不同的版本，可以恢复或查看之前的版本。如果我们要编辑这个工作流，这些编辑会以草稿的形式显示在已发布的历史版本上方。最棒的是，每个新发布的版本都会保留同一个工作流 ID。因此，你的后端始终调用这同一个 ID，它会被静默转发到你最新创建的工作流，因为历史记录会被追踪。你可以放心迭代，并在必要时随时回滚到之前的版本。比如，这里这个工作流是全新的，你可以看到它处于草稿模式。如果我们对工作流做任何更改，它都会处于草稿状态，我们需要发布它。所以，我们可以

## 发布工作流

[16:24](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=984s) 点击发布。这个工作流只有在发布后才会上线。发布时会校验图谱，确保没有错误。然后，我们就可以复制链接，这个工作流就上线并可以使用了。我们来看一下

## 集成 SDK、API 密钥与设置提示词

[16:37](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=997s) 看看集成。集成方式有多种。我们可以选择目标 SDK，无论是 React Native、iOS 还是 React Next.js，然后选择工作流，这个例子里我们选的是高风险国家审核。我们可以选择 API 密钥。不同的工作流或集成可以使用不同的 API 密钥，随你需要。你也可以选择一个 Webhook。如果你希望在做出决策时收到通知，可以在这里填入。现在，最简单的集成方式是复制一段提示词，然后直接粘贴到 Claude Code 或 Codex 中。

[17:12](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=1032s) 这段提示词会完成该工作流的集成。即使你的应用还没有集成 Didit，这段提示词也会提供让该工作流在你的应用中运行起来所需的一切。其实你甚至不需要这样做。你可以直接

## 使用 MCP 服务器构建工作流

[17:27](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=1047s) 安装一个 Didit MCP 服务器。只需用自然语言描述流程，它就会为你创建工作流，并自动将其集成到你的应用中。告诉它要做什么，它就会去执行。现在，我们会在另一个视频中介绍如何设置 MCP。MCP 本质上是 Model Context Protocol（模型上下文协议），它让你能够在 Claude Code、Cursor、Codex 等工具中，使用自然语言基于 Didit 进行构建。那么，我们快速进入定制环节。

[17:57](https://www.youtube.com/watch?v=7-nJ3JE20i4\&t=1077s) 我们可以添加公开名称和隐私政策 URL。我们有品牌设置，可以更改颜色。你还可以从网站自动提取徽标和颜色，这非常实用，也很容易操作。我们可以在这里上传徽标。你可以看到我已经设置好了这些颜色。为了测试颜色效果，如果我们打开这个开关，就能看到我们的白标品牌已在验证流程中生效。我这里先把它关掉。你可以设置个性化邮件，需要填写这些详细信息。然后，在继续进行验证时，你可以获取 DNS 信息，并将其与你的域名关联。如果你想使用子域名，同样操作即可。这样，整个工作流就能使用你自己的品牌和域名进行完全托管。因此，这真正为用户提供了无缝的验证流程。


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