verify checkresult

2026-08-11 08:14

重要说明：

所有请求及返回参数均严格以官网API文档为准。
API返回结果中可能包含未在文档中定义的字段。这些字段仅供内部调试使用，不保证稳定性及兼容性，请勿在生产环境中依赖这些字段，ZOLOZ保留随时修改或删除这些字段的权利，且无需另行通知。

概览

API URL：/api/v1a/zoloz/smile/verify/checkResult
API 描述：该接口用于获取生物特征验证的结果。

请求参数

字段名称

数据类型

最大长度

是否必填

默认值

描述

示例值

bizId

String

是

业务ID，业务的唯一标识，用于追踪业务。例如，商户业务相关数据库中的序列号。

说明：ZOLOZ不校验该值的唯一性，商户侧需自行保证该业务ID的唯一性。

"2017839040588699"

transactionId

String

是

调用verify initialize API返回的交易ID。

"G000000001FSE2025052300000001218988****"

返回参数

字段名称	数据类型	必须返回	描述	示例值
result	Result	是	API请求结果，包含结果状态、结果码和结果消息。	{ "resultStatus": "S", "resultCode": "SUCCESS", "resultMessage": "Success" }
verifyResult	String	是	验证结果。 `Success`：验证成功 `Failure`：验证失败	"Success"
extFaceInfo	ExtFaceInfo	否	活体检测与人脸比对信息。仅当`verificationType`为`face`时返回。	{ "faceAttack": false, "score": 90.1 }
verificationType	String	是	生物特征验证类型。 `palm`：掌纹识别 `face`：人脸识别	"palm"
userId	String	是	用户ID。	"test_yyt_1"
twoFaInfo	String	否	注册时输入的二次验证信息。	"11111111111"
verifyTwoFaInfo	String	否	本次验证时输入的二次验证信息。	"11111111111"

ExtFaceInfo字段说明

字段名称	数据类型	必须返回	描述	示例值
score	double	否	人脸比对分数，分值越高表示相似度越高。	90.1
faceAttack	Boolean	否	是否检测到人脸攻击（如照片、视频伪造）。 `true`：检测到人脸攻击。 `false`：未检测到人脸攻击。	false
similarUserList	List<SimilarUserInfo>	否	相似用户信息列表。仅当`multiMatchControl`设置为`AUTO_FAIL`或`AUTO_PASS`时返回。 `AUTO_PASS`：列表包含1个元素，即匹配分数最高的用户。`twoFaInfo`和`verifyTwoFaInfo`字段中包含该用户的二次验证信息。 `AUTO_FAIL`：列表包含N个元素（N ≥ 1），按匹配分数从高到低排序。`twoFaInfo`和`verifyTwoFaInfo`字段均为空字符串。	参考返回示例

SimilarUserInfo字段说明

字段名称	数据类型	必须返回	描述	示例值
userId	String	是	相似用户的用户ID。	"1008612"
score	double	是	人脸比对分数。	0.9210667412936551

处理结果

API通用结果码

有关通用结果码的完整列表，请参见API通用结果码。

API特有结果码

Smile verify checkresult API的结果码见下表。

结果码	结果状态	描述
SUCCESS	S	API调用成功。
INVALID_ARGUMENT	F	请求参数无效。关于无效参数的详细信息，请查看返回的`resultMessage`。
PROCESSING	F	正在处理中。
VERIFY_FAIL	F	生物特征验证失败。
NO_ACCOUNT_FOUND	F	未找到已注册的用户信息。
MULTIPLE_ACCOUNT_FOUND	F	检测到多个生物特征记录。
LIMIT_EXCEEDED	F	超过最大次数限制。
SYSTEM_ERROR	F	系统内部错误。有关错误详情，请查看返回的`resultMessage`。

代码示例

请求示例

copy
{
    "bizId": "2017839040588699",
    "transactionId": "G000000001FSE2025052300000001218988****"
}

返回示例

copy
{
    "result": {
        "resultStatus": "S", 
        "resultCode": "SUCCESS", 
        "resultMessage": "Success"
    }, 
    "extFaceInfo": {
        "faceAttack": false, 
        "score": 90.1, 
        "similarUserList": [
            {
                "score": 0.9210667412936551, 
                "userId": "1008612"
            }, 
            {
                "score": 0.8980509100376135, 
                "userId": "1008673"
            }
        ]
    }, 
    "verificationType": "palm", 
    "verifyTwoFaInfo": "11111111111", 
    "twoFaInfo": "11111111111", 
    "userId": "test_yyt_1", 
    "verifyResult": "Success"
}