全部产品
Search
文档中心

ID Verification:CheckResult

更新时间:Sep 18, 2026

本文介绍如何通过调用CheckResult接口查询eKYC_PRO方案认证后的结果。

接口说明

  • 接口名:CheckResult

  • 请求方法:HTTPS POST

  • 接口说明:当您收到回调通知之后,可以在服务端通过该接口获取相应的认证状态和认证资料。

    重要

    ID Verification服务结果默认存储30天,超期系统自动删除,请您在认证结束后的30天内查询认证结果。

  • QPS限量:API独享QPS限量,详情请参见服务端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接口在OpenAPI平台的调用方式和SDK及其代码的获取方式。

您可以在OpenAPI Explorer中直接运行本接口进行调试,并生成本接口的SDK代码示例。

接入注意事项

  1. TransactionId 存储规范:TransactionId 为认证记录的服务端可信标识,须与商户业务 ID 绑定,并持久化存储于服务端。

  2. 日志保存期限:认证结果日志默认保存 30 天,到期后系统将自动删除。商户须在有效期内完成查询,并按合规要求妥善保存所需数据。

  3. 视频获取与留存合规:视频仅在对应功能开关开启且认证流程成功时返回。存证视频下载链接的有效期为 15 分钟,原视频将在认证完成 30 分钟后自动删除。若业务需留存视频,请及时下载,并严格遵守当地隐私与数据合规要求。

  4. 图片获取规范:认证图片仅在 IsReturnImage=Y 且人脸验证成功时返回。鉴于 Base64 数据体积较大,若无展示或留存需求,请保持该参数为默认值 N。

  5. 接口状态与认证结果区分:Code=Success 仅表示接口调用成功。最终认证结论须以 Result.Passed 和 Result.SubCode 字段为准。

  6. 认证失败排查:当 Passed=N 时,需结合 SubCode、ExtFaceInfo、ExtIdInfo 及 ExtSourceInfo(若存在)等字段,综合判定失败原因。

  7. 字段解析兼容性:OCR 字段、证件页数及人脸属性等返回内容,将随证件类型、地域服务能力及 SDK 配置动态变化。客户端解析逻辑须具备向后兼容性,确保在字段缺失或新增时正常运行。

字段分布说明

App SDK接入与 Web SDK 接入的 CheckResult 主返回结构、活体结果和 OCR 结果字段一致。

分类

字段

说明

共有输出

通用响应、认证结论、ExtFaceInfo、ExtIdInfo、ExtSourceInfo 及其子字段

两种集成模式均可能返回,具体是否返回由认证流程和 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-5384FF039795

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",
  "faceComparisonScore": 99.99,
  "faceImg": base64格式,
  "facePassed": "Y",
  "faceQuality": 95.45,
  "faceOcclusion": "N",
  "docVideoUrl": "https://aliyun-cloudauth.oss-aliyuncs.com/******.webm" 
}

Result.ExtIdInfo

String

证件 OCR 与防伪结果。具体信息,请参见Result.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

权威数据源核验明细。仅支持InitializeV2的Authorize=T 且实际调用相应数据源时返回,具体信息,请参见Result.ExtSourceInfo。

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

Result.ExtInfo

String

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

{
  "procedurePriority": "keep"
}

Result.ExtFaceInfo

名称

类型

描述

示例值

facePassed

String

活体人脸整体验证结果:

  • Y:通过

  • N:不通过

Y

faceComparisonScore

Double

活体人脸与证件人像比对分,范围 0~100。阈值大于等于90时比对通过。

99.99

faceImg

String

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

Base64格式

docVideoUrl

String

存证视频的OSS下载地址。仅 InitializeV2 参数 DocVideo=Y 且视频成功上传后可能返回。URL 有效期 15 分钟;认证完成后 30 分钟内可重复查询,超过 30 分钟视频将被删除且无法恢复。

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

faceAttack

String

是否检测到活体攻击:

  • Y:是

  • N:否

N

faceAttributeInfo

String

检测传入图片中的主体人脸(离镜头最近、面部面积最大且清晰的人脸)的相关面部属性。检测结果以字符串形式返回,据此决策消费内容。

返回字段定义如下:

  • gender:主体人物性别。1 代表男性,0 代表女性。

  • glasses:主体人物是否携带眼镜。1 代表检测到对应信息,0 代表未检测到。

  • hat:主体人物是否头顶戴帽子(包含头巾/头纱场景)。1 代表检测到对应信息,0 代表未检测到。

  • mask:主体人物是否戴口罩。1 代表检测到对应信息,0 代表未检测到。

  • tattoo:主体人物是否有可见纹身。1 代表检测到对应信息,0 代表未检测到。

  • smoking:主体人物是否在抽烟。1 代表检测到对应信息,0 代表未检测到。

  • others:除主体外是否还有其他人物出现。1 代表检测到对应信息,0 代表未检测到。

  • env:主体人物所在的环境,例如办公室、工厂、医院、车内等。目前支持返回 office / hospital / factory / vehical / other。

  • expression:主体人物是否为夸张表情(指人物面部出现明显异于自然/平静状态的强烈表情)。1 代表检测到夸张表情,0 代表未检测到。

  • age:主体人物对应的真实年龄(周岁)。对应真实年龄。

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

faceAttackScore

(已下线)

Double

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

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

80

guardRiskScore

Double

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

90

deviceToken

String

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

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

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

e0c34a77f5ac40a5aa5e6ed20c35****

Result.ExtIdInfo

名称

类型

描述

示例值

ocrIdPassed

String

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

  • Y:通过

  • N:不通过

N

ocrDocType

String

仅 InitializeV2 的 DocType参数传入“国家或地区编码”时返回,作为自动分类模式下系统自动识别的证件精确编码。

CHN01001

ocrIdInfoData

Map<String,Object>

各证件页的详细结果,key为证件页码,value详见ocrIdInfoData.{page}单页字段。

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"
}

ocrStandardData

String

证件OCR标准化字段信息。

说明

仅当该证件类型支持,且OcrValueStandard设置1时返回。

{
    "given_name_s": "HYUNEUI",
    "surname_s": "MUN",
    "date_of_expiry_s": "2028-02-08",
    "date_of_birth_s": "1988-10-26",
    "sex_s": "M"
}

ocrIdInfoData.{page}单页字段

名称

类型

描述

示例值

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 返回N,spoofType 为空。

  • spoofResult:

    • Y:存在风险

    • N:正常

  • spoofType:

    • SCREEN_REMARK:翻拍

    • PHOTO_COPY:复印件

    • TAMPER:PS篡改

    • SHORTCUT:截屏

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

Result.ExtSourceInfo

印尼数据源明细字段说明:

字段

类型

说明

govId

Double

证件号与官方数据源的比对分;1.0 表示完全一致。低于 1.0 表示不一致。

fullName

Double

姓名比对分;1.0 表示完全一致。低于 1.0 表示不一致。

dob

Double

出生日期比对分;1.0 表示完全一致。低于 1.0 表示不一致。

selfiePhoto

Double

自拍照比对分;大于 0.8 表示与官方数据源信息一致。低于或等于 0.8 表示不一致。

liveness

Double

数据源活体风险分;高于 0.95 表示存在活体风险。

imgManipulationScore

Double

图片篡改风险分;高于 0.95 表示存在篡改风险。

Result.ExtInfo

字段

类型

说明

procedurePriority

String

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

  • keep:未降级

  • url:使用 URL 降级

Result.SubCode认证结果子码说明

错误码

认证记录是否计费

描述和原因建议

200

是

认证通过。

204

是

【活体比对】活体人脸和证件照片比对不一致。可能是人证不符或活体照片质量较低。

205

是

【活体攻击】活体检测存在风险。

206

是

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

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

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

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

212

是

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

202

是

【权威数据源】证件号在权威源数据中不存在。

207

是,权威源额外计费

【权威数据源】权威源数据判断个人信息一致,人脸不一致。

214

是,权威源额外计费

【权威数据源】权威源数据判断人脸信息一致,个人信息不一致。

215

是,权威源额外计费

【权威数据源】权威源数据判断个人信息与人脸均不一致。

216

是,权威源额外计费

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

217

是,权威源额外计费

【权威数据源】权威源数据判断图片质量异常。

218

是,权威源额外计费

【权威数据源】业务通过但权威源传入参数错误。

209

是,权威源不计费

【权威数据源】权威源异常。

常见问题

faceComparisonScore人脸比对阈值误识率是多少,不同误识率对应的阈值是多少?

误识率是指系统把“非本人”错误判定为“本人”的概率。数值越低,安全性越高。各误识率对应的阈值如下:

1% 误识率

0.1% 误识率

0.05% 误识率

0.01% 误识率(推荐)

0.005% 误识率

0.001% 误识率

57.3

76.4

81.8

90.0

90.5

91.3