让用户再次尝试核验
给用户第二次机会有两种方式 - 请求重新提交仅失败的步骤,或者发起一个全新的会话。选择哪一种,取决于会话当前的状态。
如果会话处于审核中或已拒绝 - 使用重新提交:同一个会话,用户只需重做 失败的那一步。如果会话已过期或已放弃 - 使用新建会话。对真实用户来说, 重新提交几乎总是更好的选择。
让用户获得另一次机会有两种方式:对失败的步骤请求重新提交,或者从头创建一个新会话。选择哪一种取决于会话当前的状态。
#方式一:请求重新提交(会话处于审核中或已拒绝)
重新提交会保留同一个会话和历史记录,只要求用户重做失败的具体步骤 - 而不是整个核验流程。

- 「更多选项」就是重新打开会话、让用户再次尝试的入口。
- 新的尝试会与第一次一起出现在「事件」中,方便你进行比较。
- 打开会话
在商业控制台中,进入核验记录并打开该会话。
- 请求重新提交
打开操作菜单,选择请求重新提交。选择用户需要重做的步骤 - 任何未获批准的步骤都可以选。
- 通知用户(可选)
如果你留有该用户的邮箱,可以自动向其发送一个直达重新提交页面的链接,你还可以设置该邮件使用的语言。
- 等待重新评估
在等待期间,会话状态会变为已重新提交。用户完成所要求的步骤后,系统会自动重新评估,并将会话状态更新为已通过、已拒绝或审核中。
同一个会话可以被多次请求重新提交 - 每一轮都会保留在会话历史中,供你留存记录。开发者也可以通过更新会话状态 API 触发同样的操作。
#方式二:创建新会话(会话已过期或已放弃)
如果一个会话在用户打开之前就已过期,或者用户中途放弃了它,重新提交就不适用了 - 请创建一个全新的会话,并发送一个新链接,可以通过控制台的核验链接流程,也可以通过创建会话 API。新会话会拥有自己独立的会话 ID,并从未开始状态起步。
请传入与第一次相同的 vendor_data。正是它将两次尝试归并到同一个统一用户之下,让你即使面对两个独立的会话,也能保持对这个人的单一视图。
#应该选用哪一种?
| 重新提交 | 新建会话 | |
|---|---|---|
| 会话 ID | 保持不变 | 全新生成 |
| 历史记录 | 汇总在同一个地方 | 相互独立,仅通过 vendor_data 关联 |
| 用户需要重做的内容 | 仅限失败的步骤 | 全部内容 |
| 适用状态 | 审核中、已拒绝 | 任何状态均可,但主要用于已过期或已放弃 |
| 费用 | 仅计重新运行并完成的步骤 | 整个工作流的每个步骤都会重新计费 |
对于可以修复的问题 - 例如照片模糊、上传错了证件的哪一面 - 重新提交几乎总是更好的选择:对真实用户来说摩擦更小,费用更低,还能保留单一的审计记录。
#一次重试会让你花费多少
计费按已完成的功能计算,因此:
- 一次只重做证件步骤的重新提交,只会为该步骤计费。
- 一个全新的会话会重新运行整个工作流,并为每个再次完成的功能计费。
- 用户从未到达的步骤完全不计费。
这就是在可修复的失败面前,选择重新提交而非新建会话的实际理由。详见哪些属于计费检查。
#控制用户可以获得几次尝试机会
如果你不希望核验失败后,用户能在同一流程内再次尝试,这属于工作流配置的问题 - 每个步骤针对各类警告设置的处理动作,决定了用户会被邀请重试、被转入审核,还是直接被拒绝。详见判定规则与阈值。
彻底取消重试选项时请务必谨慎。有些采集失败是设备的问题,而不是用户本人的问题 - 例如摄像头掉帧,或手机无法稳定读取 NFC 芯片。取消重试会让这些情况变成对 合法用户的永久性拒绝。
