开发者指南：IDV API 的动态回退工作流 (ZH)

主动错误处理在您的 IDV API 集成中实施强大的错误处理和重试机制，以防止验证失败影响用户体验。

多层验证设计包含多种验证方法的工作流，以便在主要方法失败或结果不确定时，无缝切换到替代检查。

优化用户体验利用动态回退引导用户通过替代验证路径，最大程度地减少摩擦，确保成功入职或交易完成。

Didit 的编排工作流利用 Didit 的模块化和 AI 原生平台，通过无代码可视化构建器或简洁的 API 构建和管理复杂的动态回退工作流，确保最大的灵活性和可靠性。

IDV 中动态回退工作流的重要性

在在线身份验证领域，仅仅依靠一次 API 调用来确认用户身份，是潜在失败和糟糕用户体验的根源。文档图像质量差、网络延迟、API 速率限制，甚至临时服务中断等因素都可能扰乱验证过程。这时，动态回退工作流就变得不可或缺。精心设计的回退策略可确保当主要验证方法失败时，系统能够智能地转向替代方案，从而保持用户旅程的顺畅并维持高验证成功率。这不仅提高了客户满意度，还直接影响转化率和运营效率。

对于开发者而言，构建弹性系统意味着预见失败并制定备用方案 B、C 甚至 D。静态、僵化的验证流程常常导致用户在遇到错误时放弃操作。另一方面，动态回退提供了灵活性，允许企业适应实时条件和用户输入。这对于涉及敏感流程（如客户入职、受监管内容的年龄验证或需要强大身份保障的高价值交易）的应用尤为重要。

设计有效的回退逻辑

实施动态回退工作流需要仔细规划并深入了解您的验证需求。核心思想是定义一系列验证步骤和条件逻辑，根据每个步骤的结果决定流程。以下是实现方法：

1. 识别潜在的故障点

在设计回退之前，您需要知道可能出现的问题。IDV 中常见的故障点包括：

• 证件扫描问题：图像模糊、眩光、证件类型不正确或证件过期可能导致身份验证（OCR、MRZ、条形码）失败。
• 活体检测失败：用户因光线不足、深度伪造或不遵守指令而未能通过活体检测。
• 人脸比对不匹配：证件照片与实时自拍之间存在差异。
• 数据不匹配：从证件中提取的信息与数据库记录或用户提供的数据不匹配。
• 反洗钱筛查标记：用户出现在观察名单上，需要进一步手动审查。
• API 服务中断：身份验证提供商的临时不可用或错误。

2. 定义条件逻辑和替代路径

一旦识别出故障点，就规划替代路径。例如：

• 如果初始身份验证（OCR）因图像质量差而失败，提示用户重新拍照或切换到不同类型的证件。
• 如果被动和主动活体检测表明存在高欺诈风险，则触发手动审查或请求额外证明，如地址证明。
• 如果 1:1 人脸比对失败，则可以提供替代方案，例如电话和电子邮件验证结合特定的基于知识的身份验证问题。
• 对于年龄验证场景，如果年龄估计不确定，则提示进行实体身份证件扫描。
• 如果反洗钱筛查和监控检查返回潜在匹配项，则自动将用户路由到合规官员进行进一步调查，而无需中断用户流程。

Didit 的编排工作流可通过其无代码业务控制台访问，正是为此而设计，允许您无需编写一行代码即可可视化地构建复杂的决策树和条件步骤。这种模块化方法意味着您可以混合和匹配身份检查，并轻松定义成功或失败的阈值。

3. 优先考虑用户体验

回退不应让用户感到是惩罚。目标是保持用户参与并减少摩擦。当触发回退时，提供清晰、简洁的指示。例如，不要只显示一个通用错误，而是告诉用户：“您的证件照片模糊。请在光线充足的区域重试。”或“我们无法通过此方法确认您的身份。您想尝试使用其他证件进行验证或联系支持吗？”最大程度地减少步骤并确保所有验证路径的 UI/UX 一致至关重要。

技术实施策略

从技术角度来看，实施动态回退工作流涉及几个关键考虑因素：

1. API 编排和状态管理

您的后端系统需要协调对各种 IDV API 的调用并管理验证过程的状态。这包括跟踪已完成的步骤、已失败的步骤以及已启动的回退路径。Didit 的 API 优先方法和“会话”的使用简化了这一点。当您使用特定的工作流 ID 创建会话时，Didit 会处理整个面向用户的体验、状态管理和条件步骤。您只需查询会话状态即可了解结果。

GET /v3/workflows/
    - uuid: a1b2c3d4-5678-90ab-cdef-111111111111
      workflow_label: Standard KYC
      workflow_type: kyc
      features:
        - OCR
        - LIVENESS
        - FACE_MATCH
    - uuid: b2c3d4e5-6789-01bc-defg-222222222222
      workflow_label: Full Verification + AML
      workflow_type: kyc
      features:
        - OCR
        - LIVENESS
        - FACE_MATCH
        - AML

此 API 示例展示了如何定义和访问不同的工作流，每个工作流都具有 OCR、活体检测、人脸比对和反洗钱等独特功能。然后，您可以根据初始验证结果或用户人口统计数据动态选择适当的工作流。

2. 强大的 API 客户端和错误处理

您的 API 客户端应构建为能够优雅地处理各种 HTTP 状态码和错误响应。为瞬时错误实施带有指数退避的重试机制。区分瞬时错误（例如，网络问题）和永久错误（例如，无效输入）以避免不必要的重试。彻底记录所有 API 交互和错误响应，以便进行调试和审计。

3. 模块化和可组合的身份检查

采用模块化架构，其中每个身份检查（身份验证、活体检测、人脸比对、反洗钱筛查、地址证明、年龄估计、电话和电子邮件验证）都是一个独立的、即插即用的组件。这使您可以轻松地替换或添加新的验证方法，而无需重新架构整个系统。Didit 的平台就是基于这一原则构建的，通过简洁的 API 提供可组合的身份原语，从而轻松创建自定义工作流。

Didit 如何提供帮助

Didit 从一开始就旨在为开发者提供工具，以构建复杂和动态的身份验证工作流。我们的 AI 原生、开发者优先平台提供了一个开放、模块化的身份层，简化了回退和复杂验证旅程的实施。

• 编排工作流：Didit 业务控制台中的无代码可视化构建器允许您设计多步骤身份验证流程，包括 KYC、年龄检查和反洗钱筛查的条件逻辑节点。您只需定义一次逻辑，Didit 即可处理面向用户的体验、状态管理和条件步骤。这意味着您可以轻松配置主要和回退方法，例如从身份验证（OCR）和活体检测开始，如果未达到阈值，则自动触发地址证明请求或手动审查。
• 全面的产品套件：借助 Didit，您可以访问全方位的验证工具，包括身份验证（OCR、MRZ、条形码）、被动和主动活体检测、1:1 人脸比对和人脸搜索、反洗钱筛查和监控、地址证明、年龄估计（隐私保护）、电话和电子邮件验证以及 NFC 验证（电子护照/电子身份证）。这个广泛的工具包使您能够构建几乎任何可以想象的回退场景。
• 开发者优先方法：Didit 提供即时沙盒、公共文档和简洁的 API，使集成无缝。您可以以编程方式列出、创建、更新和删除工作流，从而完全控制您的验证逻辑。
• 免费核心 KYC：Didit 提供免费核心 KYC，允许企业在没有前期成本的情况下开始构建强大的工作流。我们的按成功检查付费模式和无设置费意味着您只在验证成功时付费，将成本与价值挂钩。
• AI 原生自动化：通过利用 AI，Didit 自动化了工作流中的大部分决策过程，减少了手动审查的需求并加快了验证时间，即使在回退启用时也是如此。

准备好开始了吗？

准备好亲身体验 Didit 了吗？立即获取免费演示。

使用Didit 的免费套餐免费开始验证身份。