全部產品
Search
文件中心

ID Verification:CheckResult

更新時間:Feb 07, 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
}

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

業務通過但是資料來源未調用。

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

Face Service演算法預測的假臉攻擊可能性,分數越高代表假臉的可能性越高。

分值取值: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)返回。

說明

ShowOcrResult配置,Web SDK 接入在服務端Initialize介面中配置。

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

ExtInfo

名稱

類型

描述

樣本值

procedurePriority

String

認證的降級方式:

  • keep:沒有降級

  • url:url降級

keep

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:篡改

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