全部產品
Search

搜尋本產品

    ID Verification：CheckResult

    文件中心

    ID Verification：CheckResult

    更新時間：Jul 06, 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

    有效期間截止日