全部产品
Search

搜索本产品

    ID Verification：CheckResult

    文档中心

    ID Verification：CheckResult

    更新时间：Jan 22, 2024

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

    接口说明

    • 接口名： CheckResult。

    • 服务地址： cloudauth-intl.cn-hongkong.aliyuncs.com。

    • 请求方法：HTTPS POST。

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

    请求参数

    名称

    类型

    是否必选

    描述

    示例值

    MerchantBizId

    String

    Yes

    您自定义的业务唯一标识，用于后续定位排查问题使用。支持长度为32位的字母和数字的组合，请确保唯一。

    说明

    阿里云服务器不会对该字段的值进行唯一性检查。为了更好地跟踪，强烈建议保证字段唯一性。

    e0c34a77f5ac40a5aa5e6ed20c35****

    TransactionId

    String

    Yes

    整个认证流程的唯一标识。该值需要调用Initialize获取。

    hksb7ba1b28130d24e015d694361bee4

    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和Message说明。

    Success

    Message

    String

    请求消息的响应信息。

    success

    Result.Passed

    String

    认证最终结果。取值。

    • Y：通过。

    • P：待定。该状态后续将更新为Y或N。

      说明

      建议您收到回调通知时，再查询该接口获取认证结果。

    • N：不通过。

    Y

    Result.SubCode

    String

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

    200

    Result.ExtFaceInfo

    String

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

    {

    "faceAttack": "N", "faceComparisonScore": 99.99,

    "extraFaceImg": [base64格式],

    "faceImg": "base64格式",

    "facePassed": "Y",

    "faceQuality": 95.45,

    "faceOcclusion": "N"

    }

    Result.ExtIdInfo

    String

    证件识别相关结果信息。JSON格式。

    更多信息，请参见ExtIdInfo。

    {

    "ocrIdInfo": {

    "firstName": "**龙",

    "lastName": "**",

    "countryCode": "CHN",

    "docType": "01560001",

    "dateOfBirth": "2002-08-04",

    "idNumber": "410************19"

    },

    "idImage": "base64格式",

    "ocrIdPassed": "N",

    "spoofInfo": {

    "spoofResult": "Y"}

    }

    返回Code和Message说明

    HTTP状态码

    Code

    Message说明

    200

    Success

    请求成功。

    400

    MissingParameter

    参数不能为空。

    400

    InvalidParameter

    非法参数。

    400

    TransactionIdInvalid

    无效Transaction id。

    401

    OcrFail

    文本解析失败。

    403

    Forbidden.RAMUserAccessDenied

    需要给RAM用户授予AliyunAntCloudAuthFullAccess的操作权限。更多信息，请参见授权RAM用户访问服务。

    403

    Forbidden.AccountAccessDenied

    账户存在欠费，请充值后再进行操作。

    403

    Throttling.Api

    API限流拦截。

    404

    ProcessNotCompleted

    整个认证流程未完成。

    500

    InternalError

    系统内部错误，请反馈工程师排查。

    ​ResultObject.SubCode错误码说明

    错误码

    是否计费

    描述和原因建议

    200

    Yes

    认证通过。

    204

    Yes

    认证未通过。原因是证件人脸和活体人脸比对相似度过低。可能不是同一人或活体照片质量较低。

    205

    Yes

    认证未通过，原因是活体检测存在风险。若是正常用户操作，可建议用户重新操作。

    212

    Yes

    认证未通过，原因是证件防伪检测未通过。建议用户使用自己的真实证件原件认证操作。

    ExtFaceInfo

    名称

    类型

    描述

    示例值

    facePassed

    String

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

    • Y：通过。

    • N：不通过。

    Y

    faceComparisonScore

    Double

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

    99.99

    faceImg

    String

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

    base64格式

    extraFaceImg

    String

    如需返回认证流程中更多数量的人脸图片，请联系客户经理。如在发起接口请求时，参数isReturnImage = Y且扫脸流程顺利完成，则返回此字段。

    base64格式

    faceAttack

    String

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

    N

    faceQuality

    Double

    活体人脸质量分数。取值范围0～100。

    99.99

    faceOcclusion

    String

    是否有脸部遮挡，有脸部遮挡为Y，否则为N。

    N

    ExtIdInfo

    名称

    类型

    描述

    示例值

    ocrIdPassed

    String

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

    • Y：通过。

    • N：不通过。

    N

    idImage

    String

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

    base64格式

    ocrIdInfo

    String

    证件OCR字段信息。更多信息，请参见OCR识别返回字段。

    说明

    证件OCR结果可能会延迟一定时间后返回，请耐心等待。如果证件OCR流程失败，则该字段值为空。

    {

    "firstName": "**龙",

    "lastName": "**",

    "countryCode": "CHN",

    "docType": "01560001",

    "dateOfBirth": "2002-08-04",

    "idNumber": "410************19"

    }

    spoofInfo

    String

    证件防伪检测结果。

    spoofResult：

    • Y：存在风险。

    • N：正常。

    说明

    防伪结果可能会延迟一定时间后返回，请耐心等待。

    {

    "spoofResult": "Y",

    }

    extLabel

    String

    证件相关扩展信息。

    {

    "UNQUALIFIED_DOC_IMAGE", "OTHERS"

    }

    OCR识别返回字段

    身份证

    中国内地身份证

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    idNumber

    String

    证件号

    dateOfBirth

    String

    出生日期，yyyy-MM-dd

    validUntil

    String

    有效期截止日， yyyy-MM-dd

    中国香港身份证

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    idNumber

    String

    证件号

    issueDate

    String

    签发日期

    dateOfBirth

    String

    出生日期

    validUntil

    String

    有效期截止日

    中国澳门身份证

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    idNumber

    String

    证件号

    dateOfBirth

    String

    出生日期

    validUntil

    String

    有效期截止日

    中国台湾身份证

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    idNumber

    String

    证件号

    dateOfBirth

    String

    出生日期

    validUntil

    String

    有效期截止日

    日本身份证

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    idNumber

    String

    证件号

    dateOfBirth

    String

    出生日期

    validUntil

    String

    有效期截止日

    韩国身份证

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    idNumber

    String

    证件号

    dateOfBirth

    String

    出生日期

    validUntil

    String

    有效期截止日

    俄罗斯身份证

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    middleName

    String

    中间名

    idNumber

    String

    证件号

    issueDate

    String

    颁发日期

    dateOfBirth

    String

    出生日期

    validUntil

    String

    有效期截止日

    土耳其身份证

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    middleName

    String

    中间名

    idNumber

    String

    证件号

    issueDate

    String

    签发日期

    dateOfBirth

    String

    出生日期

    validUntil

    String,

    有效期截止日

    护照

    中国内地护照

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    middleName

    String

    中间名

    idNumber

    String

    证件号

    dateOfBirth

    String

    出生日期， yyyy-MM-dd

    validUntil

    String

    有效期截止日， yyyy-MM-dd

    中国香港护照

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    idNumber

    String

    证件号

    dateOfBirth

    String

    出生日期

    validUntil

    String

    有效期截止日

    中国澳门护照

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    idNumber

    String

    证件号

    dateOfBirth

    String

    出生日期

    validUntil

    String

    有效期截止日

    日本护照

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    idNumber

    String

    证件号

    dateOfBirth

    String

    出生日期

    validUntil

    String

    有效期截止日

    韩国护照

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    idNumber

    String

    证件号

    dateOfBirth

    String

    出生日期

    validUntil

    String

    有效期截止日

    俄罗斯护照

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    middleName

    String

    中间名

    idNumber

    String

    证件号

    issueDate

    String

    签发日期

    dateOfBirth

    String

    出生日期

    validUntil

    String

    有效期截止日

    土耳其护照

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    idNumber

    String

    证件号

    dateOfBirth

    String

    出生日期

    validUntil

    String

    有效期截止日

    新加坡护照

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    idNumber

    String

    证件号

    dateOfBirth

    String

    出生日期

    validUntil

    String

    有效期截止日

    印尼护照

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    idNumber

    String

    证件号

    dateOfBirth

    String

    出生日期

    validUntil

    String

    有效期截止日

    马来西亚护照

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    idNumber

    String

    证件号

    dateOfBirth

    String

    出生日期

    validUntil

    String

    有效期截止日

    泰国护照

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    idNumber

    String

    证件号

    dateOfBirth

    String

    出生日期

    validUntil

    String

    有效期截止日

    越南护照

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    idNumber

    String

    证件号

    issueDate

    String

    签发日期

    dateOfBirth

    String

    出生日期

    validUntil

    String

    有效期截止日

    美国护照

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    middleName

    String

    中间名

    idNumber

    String

    证件号

    dateOfBirth

    String

    出生日期

    validUntil

    String

    有效期截止日

    英国护照

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    idNumber

    String

    证件号

    dateOfBirth

    String

    出生日期

    validUntil

    String

    有效期截止日

    印度护照

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    idNumber

    String

    证件号

    dateOfBirth

    String

    出生日期

    validUntil

    String

    有效期截止日

    法国护照

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    idNumber

    String

    证件号

    issueDate

    String

    签发日期

    dateOfBirth

    String

    出生日期

    validUntil

    String

    有效期截止日

    德国护照

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    idNumber

    String

    证件号

    issueDate

    String

    签发日期

    dateOfBirth

    String

    出生日期

    validUntil

    String

    有效期截止日

    驾照

    中国驾照

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    idNumber

    String

    证件号

    dateOfBirth

    String

    出生日期

    validUntil

    String

    有效期截止日

    日本驾照

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    idNumber

    String

    证件号

    dateOfBirth

    String

    出生日期

    validUntil

    String

    有效期截止日

    韩国驾照

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    idNumber

    String

    证件号

    dateOfBirth

    String

    出生日期

    validUntil

    String

    有效期截止日

    俄罗斯驾照

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    middleName

    String

    中间名

    idNumber

    String

    证件号

    issueDate

    String

    签发日期

    dateOfBirth

    String

    出生日期

    validUntil

    String

    有效期截止日

    土耳其驾照

    字段名

    字段类型

    描述

    firstName

    String

    名

    lastName

    String

    姓

    middleName

    String

    中间名

    idNumber

    String

    证件号

    issueDate

    String

    签发日期

    dateOfBirth

    String

    出生日期

    validUntil

    String

    有效期截止日