跳转到主要内容
Didit Authentication 的已验证身份功能会在您选择的时机请求用户证明其身份:账户注册之前,以及提现等敏感操作之前再次验证。 您的应用会收到验证结果,以及您选择的已验证声明(例如 over_18 或已验证的姓名)。验证结果和这些声明包含在用户的 token 中,您的应用不会收到用户的证件或照片。 请在控制台中的 Authentication > Verified identity 进行设置,或通过 API 调用 verified/ 进行设置。
Didit 商业控制台中的已验证身份页面,展示注册时的验证级别及其价格,以及敏感操作前的二次验证规则

Authentication > Verified identity:注册时的验证以及敏感操作前的规则。

工作原理

每项检查都会作为您应用中的一个验证会话运行,并使用该用户的 vendor_data 创建。这意味着该会话会出现在您的验证记录中,并与同一用户的登录和交易归在一起;与其他验证一样,它会进入人工审核,并按该验证的价格计费。 Didit 会使用每项检查的默认工作流运行,您也可以为该检查选择自己的工作流。请参阅定价,了解所有验证的价格。

注册时

选择用户创建账户前必须通过的验证级别: 新级别只适用于此后注册的用户,不会影响现有账户。 在托管验证页面上,Didit 会在注册期间引导用户完成验证。在您自己的页面上,注册请求会返回 verification_required 以及有效期为 30 分钟的 verification_url,请将用户引导至该链接。只有在验证通过后,Didit 才会签发登录验证码。

敏感操作前的升级验证

只有当操作风险足够高时,升级验证才会要求用户再次验证。 您启用这些规则后,应用会在每次敏感操作前向 Didit 询问是否适用某条规则。
手机上显示升级验证页面,要求用户通过自拍确认本人身份

用户在升级验证要求自拍时看到的界面。

您可以将每条规则的检查方式改为活体检测、自拍照登录或完整身份证件验证。 当多条规则同时适用时,Didit 会要求最强的检查方式。 若 Didit 尚未保存该用户的人脸,自拍照登录将改为完整身份证件验证。

发起升级验证

您的应用通过用户的访问令牌调用 POST {issuer}/step-up/,或调用 SDK 的 stepUp() 方法:
  • 200 {"required": false}:没有规则适用,可以继续操作。
  • 201 且包含 verification_url:将用户引导至该地址。升级验证将保持开放 30 分钟(expires_in: 1800)。

在后端读取结果

用户返回 return_to 时会附加 step_up=<id>&status=approved,但这些查询参数不能证明任何事情。 您的后端需使用 GET {issuer}/step-up/{step_up_id}/ 并携带同一会话的访问令牌读取升级验证结果,且仅当 status 为 approved 时才执行操作。 升级验证绝不会在失败时放行:验证服务不可用时,该操作仍被阻止。 JavaScript、Next.js 和 iOS 快速入门展示了 SDK 端的实现,API 参考包含完整的接口规范。

您的应用将收到的内容

选择将哪些已验证的声明写入用户的 token: 访问 token 和 ID token 会在 verified 中携带这些声明,并包含 level,即用户已通过的最高等级:liveness、liveness_face_match 或 full_id。 用户尚未通过任何检查时,它为 {},而 GET /session/ 则返回 null。
  • 会话期间通过的检查,会在下一次刷新时同步到 token 中,最长不超过 5 分钟。
  • 任何持有 token 的人都可以读取这些声明,包括您的前端,因此请只选择应用所需的个人声明。
  • 您的应用获得的只是声明,绝不会获得证件、自拍照或人脸数据。

通过 API 设置

在应用的 认证管理 API 中,对 verified/ 执行 GET 和 PATCH,可以读取和修改与控制台相同的设置:
您未包含的规则将保持其当前设置。
最后修改于 2026年11月22日