全部产品
Search
文档中心

ID Verification:CheckResult

更新时间:Feb 06, 2026

本文介绍如何通过调用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:需要

  • N:不需要(默认)

Y

返回数据

名称

类型

描述

示例值

HTTP Status Code

Integer

HTTP状态码。

200

HTTP Body

RequestId

String

请求ID。

130A2C10-B9EE-4D84-88E3-5384FF039795

Code

String

返回Code

Success

Message

String

返回Code的详细描述。

success

Result.Passed

String

认证最终结果。取值。

  • Y:通过

  • N:不通过

Y

Result.SubCode

String

认证结果描述。更多信息,请参见ResultObject.SubCode错误码说明

200

Result.ExtFaceInfo

String

活体人脸验证相关结果信息。关于JSON格式,请参见右侧示例。更多信息,请参见ExtFaceInfo

{
  "faceAttack": "N",
  "faceComparisonScore": 99.99,
  "faceImg": base64格式,
  "facePassed": "Y",
  "faceQuality": 95.45,
  "faceOcclusion": "N"
   "docVideoUrl": "https://aliyun-cloudauth.oss-aliyuncs.com/******.webm" 
}

Result.ExtIdInfo

String

证件识别相关结果信息。

关于JSON格式,请参见右侧示例。更多信息,请参见ExtIdInfo

{
  "ocrIdInfoData": {
    "01": {
      "ocrIdInfo": {
        "id_number": "083099003767",
        "full_name": "MAC PHAM HOÀNG DƯƠNG",
        "nationality": "Việt Nam",
        "date_of_expiry": "",
        "date_of_birth": "16/08/1999",
        "sex": "Nam"
      },
      "ocrIdPassed": "Y",
      "spoofInfo": {
        "spoofResult": "N"
      }
    },
    "02": {
      "ocrIdInfo": {
        "date_of_issue": "10/02/2022",
        "personal_identification": "Sẹo chấm C.2cm trên sau mèp phải"
      },
      "ocrIdPassed": "Y",
      "spoofInfo": {
        "spoofResult": "N"
      }
    }
  },
  "ocrIdPassed": "Y"
}

Result.ExtSourceInfo

String

数据源核验明细结果说明如下(以印尼数据源为例):

  • govId、fullName、dob:比对得分等于 1.0 表示与官方数据源信息完全一致;低于 1.0 表示不一致。 

  • selfiePhoto:比对得分大于 0.8 表示与官方数据源信息一致;低于或等于 0.8 表示不一致。 

  • liveness:得分高于 0.95 表示存在活体检测风险。 

  • imgManipulationScore:得分高于 0.95 表示存在图片篡改风险。

{
  "govId": 1.0,
  "fullName": 1.0,
  "dob": 0.9,
  "selfiePhoto": 0.8777,
  "liveness": 0.1152,
  "imgManipulationScore": 0.2253
}

ExtFaceInfo

名称

类型

描述

示例值

facePassed

String

扫脸阶段的活体人脸验证最终结果:

  • Y:通过

  • N:不通过

Y

faceComparisonScore

Double

采集人脸和证件人像比对分。比对分取值范围0~100。

99.99

faceImg

String

采集人脸图片,Base64格式。如在发起接口请求时,参数isReturnImage=Y且扫脸流程顺利完成,则返回此字段。

base64格式

faceAttack

String

采集人脸是否涉及活体攻击,攻击为Y,否则为N

N

docVideoUrl

String

存证OSS下载地址。

说明
  • 存证视频URL有效期15分钟。

  • 在认证完成后30分钟内,可重复查询获取。超过30分钟,系统将自动删除存证视频文件且无法恢复,请及时下载保存。

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

faceAge

String

人脸预测的参考年龄,可能存在预测失败无法返回的情况。

30

faceGender

String

人脸图片预测的性别,可能存在预测失败无法返回的情况。

  • M:男

  • F:女

M

faceAttackScore

Double

人脸识别算法预测的假脸攻击可能性,分数越高代表假脸的可能性越高。

分值取值:0~100。

80

guardRiskScore

Double

人脸保镖算法预测的设备风险可能性,分数越高代表设备风险越高。

分值取值:0~100。

90

deviceToken

String

设备助手DeviceToken,当SDK完整集成设备助手模块时返回,可通过该Token 查询设备助手服务端接口,获取设备风险详情。

  • 设备助手为付费服务,具体信息,请参考产品计费

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

e0c34a77f5ac40a5aa5e6ed20c35****

ExtIdInfo

名称

类型

描述

示例值

ocrIdPassed

String

证件OCR识别阶段的最终结果:

  • Y:通过

  • N:不通过

N

ocrIdInfoData

Map<String,Object>

证件OCR详细信息,key是证件页码,value详见ocrIdInfoData

01、02字样表示证件的正面背面(或副页)

{
  "01": 
    "ocrIdInfo": {
      "expiryDate": "2030.01.01",
      "englishName": "SUN, xxx",
      "originOfIssue": "中华人民共和国出入境管理局",
      "placeOfIssue": "北京",
      "sex": "男",
      "name": "孙x",
      "idNumber": "CGxxxxxxxx",
      "issueDate": "2024.12.01",
      "birthDate": "1992.12.01"
    },
    "ocrIdPassed": "Y",
    "spoofInfo": {
      "spoofResult": "N"
    }
  }
}

ocrIdEditInfo

String

用户在OCR结果页二次编辑后,提交的证件OCR字段信息。该功能适用客户端配置选择启用OCR结果编辑页面时(ShowOcrResult)返回。

{
  "expiryDate": "2026-01-02",
  "originOfIssue": "公安部出入境管理局",
  "englishName": "ZHANG SAN",
  "sex": "男",
  "name": "张三",
  "idNumber": "H11111115",
  "issueDate": "2013-01-02",
  "birthDate": "1990-02-21"
}

ocrIdInfoData

名称

类型

描述

示例值

idImage

String

证件OCR照片,base64格式。如在发起接口请求时,参数isReturnImage=Y且证件OCR流程顺利完成,则返回此字段。

base64格式

ocrIdPassed

String

证件OCR识别阶段的该页证件结果:

  • Y:通过

  • N:不通过

N

ocrIdInfo

String

证件OCR字段信息。

字段明细,请参见证件OCR字段表

说明

如果证件OCR流程失败,则该字段值为空。

{
  "expiryDate": "2030.01.01",
  "englishName": "SUN, xxx",
  "originOfIssue": "中华人民共和国出入境管理局",
  "placeOfIssue": "北京",
  "sex": "男",
  "name": "孙x",
  "idNumber": "CGxxxxxxxx",
  "issueDate": "2024.12.01",
  "birthDate": "1992.12.01"
}

spoofInfo

String

证件防伪检测结果,包括风险判定结果和风险类型:

说明

仅当Initialize接口中 IdSpoof = Y 时,才会开启卡证检测。

否则 spoofResult 默认返回NspoofType 为空。

  • spoofResult:

    • Y存在风险

    • N正常

  • spoofType:

    • SCREEN_REMARK翻拍

    • PHOTO_COPY复印件

    • TAMPER:PS篡改

{
 "spoofResult": "Y",
 "spoofType": ["SCREEN_REMARK"]
}

返回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

业务策略限制。开启安全模式后,会对认证的设备等环境进行安全检测,若检测到可能存在风险,则判定认证结果不通过。

您可以按照如下方法排查处理:

  1. 提醒用户卸载掉设备上可能安装的各种多开、分身、虚拟环境等软件或插件,恢复设备系统初始安全环境后重试。

  2. 检查您使用的包名是否为测试demo包名,如使用了测试demo包名需修改为业务包名,以避免被工程或服务的安全策略拦截。

207

官方数据库中的个人信息一致,人脸不一致。

209

权威数据源异常。

212

证件防伪检测存在风险。可能存在翻拍、篡改、复印等高风险操作。

214

官方数据库中的人脸信息一致,个人信息不一致。

215

官方数据库中个人信息和人脸均与数据库信息不一致。

216

官方数据源判断照片活体异常(在印尼数据源核验中,ExtScoureInfo字段中的liveness高于0.95,或imgManipulationScore高于0.95)。

217

官方数据源判断图片质量异常。

218

业务通过但是数据源未调用。