ID Verification：CheckResult

分类

字段

说明

共有输出

通用响应、认证结论

两种集成模式均可能返回，具体是否返回由认证流程和 InitializeV2 配置决定。

Web SDK 特有

faceQuality、faceOcclusion、faceAge、faceGender、ExtInfo.procedurePriority

Web 侧人脸质量、遮挡、年龄、性别及实际降级策略。

App 特有

无

无

字段

类型

必选

说明

示例值

MerchantBizId

String

是

商户业务唯一标识；由32 位字母和数字组成。必须与 InitializeV2 请求中使用的值一致。

e0c34a77f5ac40a5aa5e6ed20c35****

TransactionId

String

是

hksb7ba1b28130d24e015d6********

IsReturnImage

String

否

是否返回认证图片资料（若方案包含证件，则同时返回证件图片）：

• Y：返回

• N：不返回（默认）

Y

名称

类型

描述

示例值

HTTP Status Code

Integer

HTTP状态码。

200

HTTP Body

RequestId

String

请求ID，用于问题排查。

130A2C10-B9EE-4D84-88E3-5384FF03****

Code

String

服务端返回码，具体信息请参见服务端返回HTTP状态码说明。

Success

Message

String

返回码的详细说明。

success

Result.Passed

String

认证最终结果，取值：

• Y：通过

• N：不通过

Y

Result.SubCode

String

认证结果描述。更多信息，请参见Result.SubCode认证结果子码说明。

200

Result.ExtFaceInfo

String

活体人脸验证相关结果。具体信息，请参见Result.ExtFaceInfo。

{
  "faceAttack": "N",
  "faceImg": "/9j/4AAQSkZJRgABAQAAAQqviV6oakp8...",
  "docVideoUrl": "https://aliyun-cloudauth.oss-aliyuncs.com/******.webm" 
}

Result.ExtInfo

String

其他认证信息，主要包含移动端H5的实际降级信息。具体信息，请参见Result.ExtInfo。

{
  "procedurePriority": "keep"
}

名称

类型

描述

示例值

faceImg

String

活体人脸图片，Base64格式。仅 IsReturnImage=Y 且刷脸成功时返回。

base64格式

docVideoUrl

String

https://aliyun-cloudauth.oss-aliyuncs.com/******.webm

faceAttack

String

是否检测到活体攻击：

• Y：是

• N：否

N

faceAttackScore

（已下线）

Double

活体攻击风险分，范围0~100

目前活体攻击风险由大模型能力输出，无风险分概念，此字段已下线。

80

guardRiskScore

Double

设备风险分，取值0~100，分数越高代表设备风险越高。

90

deviceToken

String

设备助手DeviceToken，当完整集成设备助手模块时返回，可用于查询设备助手服务端接口，获取设备风险详情。

• 设备助手为付费服务，具体信息，请参考计费概述。

• 此Token 具有7天有效期且不具备唯一性。

e0c34a77f5ac40a5aa5e6ed20c35****

faceAttributeInfo

String

{
        gender: 1
        glasses: 0
        hat: 1
        mask: 1
        tattoo: 0
        smoking: 0
        others: 1
        env：office
        expression：1
        age：16
}

字段

类型

说明

procedurePriority

String

移动端 H5 认证的实际降级方式：

• keep：未降级

• url：使用 URL 降级