本文介绍如何通过调用CheckResult接口查询eKYC_PRO方案认证后的结果。
接口说明
接口名:CheckResult
请求方法:HTTPS POST
接口说明:当您收到回调通知之后,可以在服务端通过该接口获取相应的认证状态和认证资料。
重要ID Verification服务结果默认存储30天,超期系统自动删除,请您在认证结束后的30天内查询认证结果。
QPS限量:API独享QPS限量,详情请参见ID Verification服务端API QPS限量说明。
服务地址:
说明内网访问优势:内网指阿里云同一地域内各产品间的私有通信网络。若您的业务服务器部署于阿里云对应地域,请使用内网域名访问 ID Verification 服务,以获得更安全、稳定的通信质量。
海外访问优化建议:海外网络环境复杂,建议参考服务端网络耗时分析与优化,优化集成方案,降低网络延迟及请求失败概率。
新加坡
公网:
cloudauth-intl.ap-southeast-1.aliyuncs.com内网:
cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com
印度尼西亚
公网:
cloudauth-intl.ap-southeast-5.aliyuncs.com内网:
cloudauth-intl-vpc.ap-southeast-5.aliyuncs.com
中国香港
公网:
cloudauth-intl.cn-hongkong.aliyuncs.com内网:
cloudauth-intl-vpc.cn-hongkong.aliyuncs.com
马来西亚(吉隆坡)
公网:
cloudauth-intl.ap-southeast-3.aliyuncs.com内网:
cloudauth-intl-vpc.ap-southeast-3.aliyuncs.com
在线调试和集成
在调试和集成前,请确保您已完整阅读使用OpenAPI调试和集成服务端API文档,充分了解API接口在OpenAPI平台的调用方式和SDK及其代码的获取方式。
您可以在OpenAPI Explorer中直接运行本接口进行调试,并生成本接口的SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 描述 | 示例值 |
MerchantBizId | String | Yes | 您自定义的业务唯一标识,用于后续定位排查问题。支持长度为32位的字母和数字的组合,请确保唯一。 说明 阿里云服务器不会对该字段的值进行唯一性检查。为了更好地跟踪,强烈建议保证字段唯一性。 | e0c34a77f5ac40a5aa5e6ed20c35**** |
TransactionId | String | Yes | 整个认证流程的唯一标识。该值需要调用 Initialize 接口获取。 重要 为避免篡改风险,该值必须使用您Initialize接口时服务端存储的TransactionId,不建议使用客户端回调的TransactionId。 | hksb7ba1b28130d24e015d6******** |
IsReturnImage | String | No | 是否需要返回认证图片资料:
| Y |
返回数据
名称 | 类型 | 描述 | 示例值 | |
HTTP Status Code | Integer | HTTP状态码。 | 200 | |
HTTP Body | RequestId | String | 请求ID。 | 130A2C10-B9EE-4D84-88E3-5384FF039795 |
Code | String | Success | ||
Message | String | 返回Code的详细描述。 | success | |
Result.Passed | String | 认证最终结果。取值。
| Y | |
Result.SubCode | String | 认证结果描述。更多信息,请参见ResultObject.SubCode错误码说明。 | 200 | |
Result.ExtFaceInfo | String | 活体人脸验证相关结果信息。关于JSON格式,请参见右侧示例。更多信息,请参见ExtFaceInfo。 | | |
Result.ExtIdInfo | String | 证件识别相关结果信息。 关于JSON格式,请参见右侧示例。更多信息,请参见ExtIdInfo。 | | |
Result.ExtSourceInfo | String | 数据源核验明细结果说明如下(以印尼数据源为例):
| | |
ExtFaceInfo
名称 | 类型 | 描述 | 示例值 |
facePassed | String | 扫脸阶段的活体人脸验证最终结果:
| Y |
faceComparisonScore | Double | 采集人脸和证件人像比对分。比对分取值范围0~100。 | 99.99 |
faceImg | String | 采集人脸图片,Base64格式。如在发起接口请求时,参数 | base64格式 |
faceAttack | String | 采集人脸是否涉及活体攻击,攻击为Y,否则为N。 | N |
docVideoUrl | String | 存证OSS下载地址。 说明
| https://aliyun-cloudauth.oss-aliyuncs.com/******.webm |
faceAge | String | 人脸预测的参考年龄,可能存在预测失败无法返回的情况。 | 30 |
faceGender | String | 人脸图片预测的性别,可能存在预测失败无法返回的情况。
| M |
faceAttackScore | Double | 人脸识别算法预测的假脸攻击可能性,分数越高代表假脸的可能性越高。 分值取值:0~100。 | 80 |
guardRiskScore | Double | 人脸保镖算法预测的设备风险可能性,分数越高代表设备风险越高。 分值取值:0~100。 | 90 |
deviceToken | String | 设备助手DeviceToken,当SDK完整集成设备助手模块时返回,可通过该Token 查询设备助手服务端接口,获取设备风险详情。
| e0c34a77f5ac40a5aa5e6ed20c35**** |
ExtIdInfo
名称 | 类型 | 描述 | 示例值 |
ocrIdPassed | String | 证件OCR识别阶段的最终结果:
| N |
ocrIdInfoData | Map<String,Object> | 证件OCR详细信息,key是证件页码,value详见ocrIdInfoData。 01、02字样表示证件的正面和背面(或副页)。 | |
ocrIdEditInfo | String | 用户在OCR结果页二次编辑后,提交的证件OCR字段信息。该功能适用客户端配置选择启用OCR结果编辑页面时(ShowOcrResult)返回。 | |
ocrIdInfoData
名称 | 类型 | 描述 | 示例值 |
idImage | String | 证件OCR照片,base64格式。如在发起接口请求时,参数isReturnImage=Y且证件OCR流程顺利完成,则返回此字段。 | base64格式 |
ocrIdPassed | String | 证件OCR识别阶段的该页证件结果:
| N |
ocrIdInfo | String | 证件OCR字段信息。 字段明细,请参见证件OCR字段表。 说明 如果证件OCR流程失败,则该字段值为空。 | |
spoofInfo | String | 证件防伪检测结果,包括风险判定结果和风险类型: 说明 仅当Initialize接口中 IdSpoof = Y 时,才会开启卡证检测。 否则 spoofResult 默认返回N,spoofType 为空。
| |
返回Code
HTTP状态码 | Code | Message描述 |
200 | Success | 请求成功。 |
400 | MissingParameter | 参数不能为空。 |
InvalidParameter | 非法参数。 | |
TransactionIdInvalid | 无效Transaction id。 | |
403 | Forbidden.RAMUserAccessDenied | 需要给RAM用户授予AliyunAntCloudAuthFullAccess的操作权限。更多信息,请参见授权RAM用户访问服务。 |
Forbidden.AccountAccessDenied | 确保您开通了ID verifycation,并且保证账户未欠费。 | |
Throttling.Api | API限流拦截。 | |
404 | ProcessNotCompleted | 整个认证流程未完成。 |
500 | InternalError | 系统内部错误,请反馈工程师排查。 |
503 | ServiceUnavailable | 服务不可用,请反馈工程师排查。 |
ResultObject.SubCode错误码说明
错误码 | 认证记录是否计费 | 描述和原因建议 |
200 | 是 | 认证通过。 |
202 | 是 | 证件号在官方数据库的证件号库中不存在。 |
204 | 是 | 活体人脸和证件照片比对不一致。可能是人证不符或活体照片质量较低。 |
205 | 是 | 活体检测存在风险。 |
206 | 是 | 业务策略限制。开启安全模式后,会对认证的设备等环境进行安全检测,若检测到可能存在风险,则判定认证结果不通过。 您可以按照如下方法排查处理:
|
207 | 是 | 官方数据库中的个人信息一致,人脸不一致。 |
209 | 是 | 权威数据源异常。 |
212 | 是 | 证件防伪检测存在风险。可能存在翻拍、篡改、复印等高风险操作。 |
214 | 是 | 官方数据库中的人脸信息一致,个人信息不一致。 |
215 | 是 | 官方数据库中个人信息和人脸均与数据库信息不一致。 |
216 | 是 | 官方数据源判断照片活体异常(在印尼数据源核验中, |
217 | 是 | 官方数据源判断图片质量异常。 |
218 | 是 | 业务通过但是数据源未调用。 |