快速开始
集成 / SDK
用户验证
企业验证
交易监控
更新日志portrait_image，或通过 vendor_data 查询到的用户已存储的人脸）。这两项检查均作为标准功能项出现在 V3 会话决策响应中。
概述
生物识别认证是一种工作流类型（workflow_type: "biometric_authentication"），而非单独的响应对象。工作流运行时会生成：
- 一次活体检测：采集实时自拍照并针对欺骗攻击进行评分。
- 一次人脸比对：将采集到的人脸与创建会话时解析的参考人脸进行比对（仅在工作流中启用人脸比对时）。
portrait_image（Base64 编码的图像，最大 2MB），或者将其省略，此时 Didit 会复用已为该 vendor_data 用户存储的人脸：优先使用已通过的活体检测人脸，其次是电子护照（ePassport）芯片照片，再次是身份证件肖像，最后是手动录入的个人资料中的人脸。如果既没有 portrait_image 也没有已存储的人脸，创建会话将返回 400 并附带 {"portrait_image": "No stored face image was found for this user. Send a portrait_image, or complete an approved verification with face liveness or an ID document for this vendor_data first."}。在这两种情况下，解析出的参考都会记录在新会话下，因此人脸比对项的 source_image_session_id 会设置为该会话自身的 session_id（这表明参考来自该会话存储的肖像，而非在同一会话中采集的证件肖像，后者会使该字段为 null）。
出现位置
对于工作流类型为
biometric_authentication 的会话，这两个数组均由 GET /v3/session/{sessionId}/decision/ 返回。它们始终为数组形式（绝非单个对象），且在对应步骤生成数据之前均为 null。每个项都包含一个 node_id，以便多实例工作流消除步骤之间的歧义。
架构参考
完整字段列表已在数据模型页面统一定义，因此呈现这些功能的所有报告共享同一个权威来源：- 活体检测项架构 —
status、method、score、reference_image、video_url、age_estimation、matches[]、face_quality、face_luminance、warnings[]、node_id。 - 人脸比对项架构 —
status、score、source_image_session_id、source_image、target_image、warnings[]、node_id。 - 警告条目结构 —
feature、risk、additional_data、log_type、short_description、long_description、node_id。
状态值
liveness_checks[].status 和 face_matches[].status 均使用通用的功能生命周期（功能级状态）：
会话整体的
status 汇总了这两个项：任何功能处于 Declined 都会使会话被拒绝；任何处于 In Review 都会使会话处于 In Review；否则为 Approved（在所有功能完成后）。
有关阈值行为和警告代码的完整列表，请参阅生物识别认证警告。
示例 — 活体检测 + 人脸比对 (已通过)
示例已作删减：完整的决策外层数据还包含session_url、metadata、callback、reviews、contact_details、expected_details、environment、created_at 和 expires_at。
示例 — 仅活体检测 (工作流中已禁用人脸比对)
face_matches 保持为 null。当启用人脸比对时，省略 portrait_image 并不会回退到仅活体检测：Didit 会复用为 vendor_data 用户存储的人脸，如果不存在存储的人脸，会话创建将失败并返回 400。
示例 — 因相似度低而拒绝人脸比对
安全注意事项
reference_image、video_url、source_image 和 target_image 是带有签名的 URL，在有限的有效期（默认为 4 小时）后会过期。它们指向生物识别数据——切勿对其进行缓存或公开展示。请在您方保存验证结果（状态、评分、source_image_session_id）；如果您需要新的 URL，请重新调用决策 endpoint。
相关内容
生物识别认证警告
警告代码、阈值以及自动拒绝条件。
活体检测报告
liveness_checks[] 项的完整字段参考。人脸比对报告
face_matches[] 项的完整字段参考。