全部产品
Search

搜索本产品

    ID Verification：CheckResult

    文档中心

    ID Verification：CheckResult

    更新时间：Sep 18, 2026

    本文介绍如何通过调用CheckResult接口查询ID_OCR_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. 认证图片返回条件：仅在 IsReturnImage=Y 且扫脸成功时返回认证图片。鉴于 Base64 内容体积较大，若无展示或留存需求，请保持默认值 N。

    4. 认证结果判定逻辑：Code=Success 仅代表接口调用成功；最终认证结论须以 Result.Passed 和 Result.SubCode 字段为准。

    5. OCR 字段解析容错：OCR 字段、证件页数及人脸属性将随证件类型、地域能力及 SDK 配置动态变化，客户端解析时须兼容字段缺失或新增的情况。

    字段分布说明

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

    分类

    字段

    说明

    共有输出

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

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

    String

    证件 OCR 与防伪结果。具体信息，请参见Result.ExtIdInfo。

    {
  "ocrIdInfoData": {
    "01": {
      "ocrIdInfo": {
        "id_number": "083****767",
        "full_name": "MAC *** NG",
        "nationality": "Việt Nam",
        "date_of_expiry": "",
        "date_of_birth": "10/10/1999",
        "sex": "Nam"
      },
      "ocrIdPassed": "Y",
      "spoofInfo": {
        "spoofResult": "N"
      }
    },
    "02": {
      "ocrIdInfo": {
        "date_of_issue": "10/10/2022",
        "personal_identification": "Sẹo **** phải"
      },
      "ocrIdPassed": "Y",
      "spoofInfo": {
        "spoofResult": "N"
      }
    }
  },
  "ocrIdPassed": "Y"
}

    Result.ExtInfo

    String

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

    {
  "procedurePriority": "keep"
}

    Result.ExtIdInfo

    名称

    类型

    描述

    示例值

    ocrIdPassed

    String

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

    • Y：通过

    • N：不通过

    N

    ocrDocType

    String

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

    CHN01001

    ocrIdInfoData

    Map<String,Object>

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

    01、02字样表示证件的正面和背面（或副页）。

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

    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.ExtInfo

    字段

    类型

    说明

    procedurePriority

    String

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

    • keep：未降级

    • url：使用 URL 降级

    Result.SubCode认证结果子码说明

    错误码

    认证记录是否计费

    描述和原因建议

    200

    是

    认证通过。

    212

    是

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