ID Verification：CheckResult

分类

字段

说明

共有输出

通用响应、认证结论及ExtFaceInfo（包含人脸活体结果、人脸比对结果/重复人脸检索结果、人脸库注册结果）

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

Web SDK 特有

procedurePriority

认证发生兼容性降级时，返回实际降级策略。

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

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

Success

Message

String

返回Code的详细描述。

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
}

faceComparisonScore

Double

【VerifyModel=1/2时返回】人脸比对结果，比对分范围 0~100；系统默认阈值为 90，也可以基于自身业务需求自定义决策。

90

duplicateFace

List

【VerifyModel=0/2时返回】重复人脸检索结果；检索到相似人脸时返回。

返回字段定义如下：

• faceGroupCode：相似人脸的人脸库编码

• faceId：相似人脸的人脸 ID

• merchantUserId：相似人脸的用户唯一ID

• score：相似人脸的分数

[
  {
    "faceGroupCode": "sg7****uzt",
    "faceId": "f5a921*******9e792ec84c8f0ca592a"
    "merchantUserId":"face0005",
    "score":93.26
  }
]

faceRegistrationResult

Integer

【VerifyModel=0/2时返回】人脸库注册结果：

• 0：注册失败，人脸图片原因导致

• 1：注册成功

• 2：注册失败，自动注册入库条件未满足

• 3：注册失败，用户已存在

• 4：注册成功，人脸图片更新成功（符合自动注册入库条件，但MerchantUserId重复，且UpdateFaceIfUserExists=Y）

1

faceRegistrationId

String

【VerifyModel=0/2且AutoRegistration=0 并注册成功时返回】人脸注册ID。

f5a9219aefd6*******c84c8f0ca592a

字段

类型

说明

procedurePriority

String

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

• keep：未降级

• url：使用 URL 降级