跳转到主要内容
无需代码构建 KYC 验证工作流(完整教程) 完整文字稿,Didit Academy 第 3 讲,共 10 讲,时长 18:54。在 YouTube 上观看。每个段落都链接到视频中的对应时刻。
定价已于 2026 年 11 月 1 日调整:使用企业邮箱注册的组织,原来每月 500 次免费检查改为每月 $10 的额度。视频展示的是此前的定价。

什么是工作流

00:03 在本视频中,我们将从零开始搭建一个完整的验证流程,全程无需编写一行代码。工作流本质上就是验证的“配方”,它规定了要运行哪些检查以及按什么顺序运行。通常这类工作由工程师负责。但在 Didit 中,您可以直接以可视化的方式自行搭建。编辑时您可以实时看到价格变化,准备好后随时可以正式上线。 00:28 如果您想自己动手搭建,可以访问 didit.me,免费注册,几分钟内就能完成第一个工作流。好,我们先从每个验证流程的起点开始,也就是

工作流列表与工作流 ID

00:39 配置标签页下方的工作流列表。这个账户中现有的所有工作流都列在这里,您可以看到每个工作流的类型。这里有 KYC 和 KYB,也有简单和图谱两种结构,并且可以看到每个工作流包含的所有检查项和功能。您还能看到价格差额,也就是说,这里显示的是:一个用户只完成一项检查、未走完流程的价格,与一个用户完成整个流程的价格之间的差距。每个工作流都有一个对应的链接。 01:09 我们可以手动新增一个会话,可以复制工作流 ID,也可以复制、重命名、归档,所有常规操作都可以完成。这里就是您的工作流 ID。同一个工作流的多个版本会共用同一个 ID,因此,如果您更新了工作流,无需修改代码或应用中的任何内容。最简单的理解方式是:工作流就是验证的配方,即运行哪些检查、按什么顺序运行,以及遵循哪些规则。两种不同的

简单工作流与图谱工作流

01:40 结构,就像我刚才提到的,一种是简单,一种是图谱。简单流程只包含一项或几项检查,没有任何分支,也没有条件逻辑。配置快捷,适用于大多数场景。您只需选择模块即可完成。以这个示例工作流为例,您可以在左侧选择模块,系统会按顺序依次排列它们。接下来是

带分支的图谱工作流

02:05 图谱工作流。如果点进来,可以看到末尾有一些分支,这样就能更精细地控制用户在验证流程中的走向。比如在这个工作流中,有多个不同的分支点。我们还可以加入 Webhook 调用。总的来说,需要时我们还能增加一些复杂度。 02:30 另外要说明的是,KYB 工作流的外观完全相同,只是检查项不同。好的。如果要添加检查项,可以在这里添加。我们可以拖入一个用户操作,也可以设置一些后台检查。后台检查是用户在前端看不到的检查。所以,

从模板创建新工作流

02:51 您只需点击新建工作流。这里有几个选项:KYC、KYB。我们选择 KYC。另外还有简单和高级两种版本,就像我之前展示的那样,两种我都会介绍。如果点击简单,这里有大量面向各行业的模板,并且可以看到每个模板的费用。有年龄门槛模板,也有邮箱验证模板。 03:19 还有生物识别认证、保险、医疗等各种模板。再比如,如果我们选择企业验证(KYB),并使用高级版本,也就是图谱版,会看到大量不同的模板,或者说配方。例如,我们可以直接设置高风险国家 KYB,就这么简单。您甚至不需要在这里拖放任何内容,它已经搭建好了。所以每个

为每个节点选择检查项

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

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

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

活体检测模式及各自费用

05:15 我的意思是,如果我们进入活体检测模块,您可以看到有几种不同的活体检测模式。被动式模式使用自拍照来检测活体。闪光式模式则通过动态光图案来确认活体,以识别真实用户的人脸。3D 动作式模式会通过某种动作来确认光照,例如眨眼或转动头部。现在您可以看到,被动式活体检测每月有 500 次免费额度,之后每次检测收费 10 美分;闪光式和 3D 动作式每次检测收费 15 美分。另外,免费账户不包含任何免费检测次数。接下来,在规则标签页中,

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

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

高级设置与质量阈值

06:56 高级标签页,这里有几个不同的选项:人脸隐私模式、活体检测最大尝试次数(即用户在单次验证会话中可以重新尝试活体检测的次数),以及人脸质量阈值。如果您不确定这些设置的作用,可以将鼠标悬停在这里的信息按钮上。我们可以看到,人脸质量衡量的是图像的清晰度、分辨率和锐度。 07:20 图像质量低可能是由模糊、像素化或光照条件差造成的。因此,我们可以根据人脸质量分数在这里设置阈值。我们还有一个亮度阈值,可以设置可接受的亮度范围。如果亮度低于该范围,我们当然可以将其转入审核或拒绝。最后,如果这些选项都不符合我们想要的

返回数据与 GDPR

07:47 设置,我们还可以设置自定义规则。在返回数据标签页中,我们可以选择要从验证结果中排除的数据点,例如出于 GDPR 等合规要求。现在,对于每个模块,我们都可以看到检测的价格,然后在顶部

工作流定价如何计算

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

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

09:05 数据库核验。那我们来添加一下。这是一项背景检查,我们来看看它的具体作用,因为这项数据库核验会连接全球各地的官方政府登记库和数据库。它会将用户数据与这些官方来源进行交叉比对,然后用登记库中保存的额外字段来丰富数据。您可以像这里看到的那样,按国家选择要运行的登记库和数据源。每项服务都列出了自己的价格。例如,您可以在这里看到加拿大下面有不同的服务,不同登记库的定价显然也各不相同。如果您想查看某个具体国家,比如德国,我们可以看到德国可用的检查项,并根据需要进行选择。 09:59 而且,这项数据库核验不仅可以在仪表板中运行,您还可以通过 Didit API 直接从自己的后端调用它。和其他所有模块一样,它也有规则、高级和返回数据选项,因此您可以在这里设置规则。如果我们点击这里的部分匹配,就能看到完全匹配是什么样子。例如,姓名和证件号码都能在登记库中匹配,就是完全匹配;而部分匹配可能只是证件号码匹配。然后,我们可以决定这种部分匹配在您的工作流中意味着什么:是转入审核、拒绝,还是通过?所以,这个工作流里就有一些分支。我们

AML 分支与条件逻辑

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

Webhook 节点

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

图结构校验与错误

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

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

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

为流程配置白标

13:43 在此工作流中,点击上方的按钮即可进入 Customizations 标签页。白标功能直接内置于流程本身。您可以进入此标签页,开始调整验证流程的外观,包括颜色、品牌标识、电子邮件、域名等等。在这里的预览中,您可以看到它在移动端和桌面端的显示效果。 14:13 您还可以用不同语言进行测试。如果我们切换为法语,您会看到每项检查现在都以法语显示。如果要开启品牌设置,可以在这里打开。您可以将其切换为我们在 Customizations 标签页中设置的内容,也可以将其关闭。我们还可以看看选择不同路径时会向用户发送什么内容。当然,用户不会看到选择路径模块,这只是为了帮助我们预览下一步会发生什么,对吧?因此,如果用户被拒绝,我们会看到”验证被拒绝”、“验证审核中”或”已通过验证”。我们确实提供复制链接功能

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

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

版本历史与回滚

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

发布工作流

16:24 点击发布。这个工作流只有在发布后才会上线。发布时会校验图谱,确保没有错误。然后,我们就可以复制链接,这个工作流就上线并可以使用了。我们来看一下

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

16:37 看看集成。集成方式有多种。我们可以选择目标 SDK,无论是 React Native、iOS 还是 React Next.js,然后选择工作流,这个例子里我们选的是高风险国家审核。我们可以选择 API 密钥。不同的工作流或集成可以使用不同的 API 密钥,随你需要。你也可以选择一个 Webhook。如果你希望在做出决策时收到通知,可以在这里填入。现在,最简单的集成方式是复制一段提示词,然后直接粘贴到 Claude Code 或 Codex 中。 17:12 这段提示词会完成该工作流的集成。即使你的应用还没有集成 Didit,这段提示词也会提供让该工作流在你的应用中运行起来所需的一切。其实你甚至不需要这样做。你可以直接

使用 MCP 服务器构建工作流

17:27 安装一个 Didit MCP 服务器。只需用自然语言描述流程,它就会为你创建工作流,并自动将其集成到你的应用中。告诉它要做什么,它就会去执行。现在,我们会在另一个视频中介绍如何设置 MCP。MCP 本质上是 Model Context Protocol(模型上下文协议),它让你能够在 Claude Code、Cursor、Codex 等工具中,使用自然语言基于 Didit 进行构建。那么,我们快速进入定制环节。 17:57 我们可以添加公开名称和隐私政策 URL。我们有品牌设置,可以更改颜色。你还可以从网站自动提取徽标和颜色,这非常实用,也很容易操作。我们可以在这里上传徽标。你可以看到我已经设置好了这些颜色。为了测试颜色效果,如果我们打开这个开关,就能看到我们的白标品牌已在验证流程中生效。我这里先把它关掉。你可以设置个性化邮件,需要填写这些详细信息。然后,在继续进行验证时,你可以获取 DNS 信息,并将其与你的域名关联。如果你想使用子域名,同样操作即可。这样,整个工作流就能使用你自己的品牌和域名进行完全托管。因此,这真正为用户提供了无缝的验证流程。
最后修改于 2026年11月7日