工作流是一个人要完成的一系列检查,以及每个结果对应的处理方式。这里介绍如何搭建、发布工作流,以及如何避免让它行为异常的常见错误。
工作流是按应用存在的,所以先确认你在正确的应用中。 标准流程用简单模式搭建,需要分支逻辑就用高级模式,然后要发布,草稿是不生效的。 会话会保留它开始时使用的版本,所以修改只影响新会话。
工作流定义了一个人要经过哪些检查,例如证件文件、活体检测、人脸比对、AML 等,以及每个结果对应的处理方式。 每一次验证会话都是针对某个工作流运行的。
#在哪里搭建
打开身份验证 → 工作流 → 新建工作流。选择个人 KYC 或企业 KYB、简单或高级模式以及模板,再点击创建草稿。确认应用和 Live 或 Sandbox 环境;行菜单可将工作流复制到另一个应用。

#两种搭建方式
- 简单模式
选择一个模板,KYC、自适应年龄验证、生物识别再认证或地址验证,然后开关你需要的检查项(活体检测、人脸比对、AML、NFC、手机、邮箱等)。 这是搭建标准流程最快的方式。
- 高级模式
使用可视化图形构建器添加条件分支:按国家、证件类型、年龄或某项检查的结果对用户分流,把不同结果导向不同路径。 当你需要"按顺序运行这些检查"之外的逻辑时使用它。
- 发布
已发布的版本为只读。通过编辑工作流创建新草稿并发布。版本历史可恢复旧版本。进行中的会话继续使用开始时的版本。
#银行与位置核验
应用已启用相关功能时,可在工作流中添加银行核验或位置核验。银行设置包括连接、身份匹配、风险信号、结果和采集数据;支持的国家及金融数据取决于提供商和已启用的能力。位置设置控制精度、数据时效、允许区域,以及拒绝授权、位置不可用或规则不匹配时的处理方式。在会话的银行或位置区域查看返回的证据。看到设置选项并不代表所有提供商或客户端均支持该检查。
#顺序比看起来更重要
因为一个被配置为拒绝的步骤会中止整个工作流,步骤的顺序既决定了用户的体验,也决定了你要付出的费用。 把一个便宜的风险检查放在昂贵检查组合的前面,可以在你为昂贵部分付费之前先过滤掉流量。
完整内容参见决策规则与阈值,这是本文之后应该读的下一篇文章,因为工作流的步骤只是它行为的一半。
#可添加的每个模块
| 类别 | 模块 |
|---|---|
| 证件 | 身份证件验证、NFC、Document AI、地址证明 |
| 生物识别 | 被动活体检测、主动活体检测、人脸比对 1:1、人脸检索、生物识别认证、年龄估算 |
| 联系方式 | 手机验证、邮箱验证 |
| 数据 | 数据库验证、问卷 |
| 风险 | AML 筛查、持续 AML 监控、设备与 IP 分析 |
每启用一个模块,都会增加一次完成会话的费用,而你的每月套餐额度会支付这些费用(在免费套餐上,它不能支付手机验证)。 在批量开启多个模块之前,请先参见哪些属于计费检查。
#查找你的工作流 ID
每个工作流都有唯一的 ID,会显示在控制台的工作流页面上。 如果你要通过 API 创建会话,就会用到它,参见集成方式。
#控制检查失败时的处理方式
默认情况下,检查失败会拒绝该会话,用户最终会被告知验证未通过,你可以在会话详情中看到具体是哪项检查失败以及原因。 在高级模式中,你可以自行为每种结果设置路由:发送到已拒绝,或发送到审核中让团队成员做最终判断。
关于每种结果具体是什么样子,参见每种会话状态的含义;如果你想让用户只重做失败的那一步,参见让用户重新进行验证。
#让工作流行为异常的常见原因
按实际发生的先后顺序:
- 你编辑的是另一个工作流,或者是另一个应用下的副本。 核对工作流 ID 是否与你的会话实际使用的一致。
- 草稿从未被发布过。 已保存的草稿不是正式版本。
- 你用的是一个旧会话在测试。 会话会保留创建时的配置。请创建一个新会话。
- 允许了某种证件类型,但没有选择任何子类型,这会匹配不到任何内容,而不是匹配所有内容。参见支持的证件与国家。
- 前面的某个步骤拒绝并中止了流程,导致你正在测试的步骤根本没有运行。
- 复制的工作流没有完全带过所有内容。 复制工作流后,请检查你关心的步骤和规则,而不要假设复制是完整无误的。
问卷检查的国家代码列表覆盖了绝大多数国家。 如果你需要的代码没有出现,请联系支持团队,而不要假设它不受支持。
#在真实用户看到之前先测试
通过应用名称下的切换器进入 Sandbox,创建并使用测试 API 密钥。所有检查都被模拟,不收费,你可以指定结果。
#下一步
- 设置每种结果对应的处理方式:决策规则与阈值
- 让流程匹配你的品牌:自定义品牌和验证体验
- 无代码启动会话,或通过 API 自动化:集成方式
- 完整技术参考:工作流
还没解决?和真人聊聊。
请附上你的组织 ID 以及你要咨询的会话 ID。
