ID Verification：CheckResult

名稱

類型

是否必選

描述

樣本值

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：通過。

• 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。

{

"ocrIdInfo": {

"expiryDate": "",

"originOfIssue": "公安部出入境管理局",

"englishName": "LI SI",

"sex": "男",

"name": "李四",

"idNumber": "H11111112",

"issueDate": "2013-01-02",

"birthDate": "1990-02-21"

},

"ocrIdPassed": "N",

"spoofInfo": {

"spoofResult": "Y",

"spoofType": [

"SCREEN_REMARK"

]

}

}

名稱

類型

描述

樣本值

facePassed

String

掃臉階段的活體人臉驗證最終結果：

• Y：通過。

• N：不通過。

Y

faceComparisonScore

Double

採集人臉和證件人像比對分。比對分取值範圍0～100。

99.99

faceImg

String

採集人臉圖片，base64格式。如在發起介面請求時，參數isReturnImage=Y且掃臉流程順利完成，則返回此欄位。

base64格式

faceAttack

String

採集人臉是否涉及活體攻擊，攻擊為Y，否則為N。

N

faceQuality

Double

活體人臉品質分數。取值範圍0～100。

99.99

faceOcclusion

String

是否有臉部遮擋，有臉部遮擋為Y，否則為N。

N

docVideoUrl

String

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

名稱

類型

描述

樣本值

ocrIdPassed

String

證件OCR識別階段的最終結果：

• Y：通過。

• N：不通過。

N

idImage

String

證件OCR照片，base64格式。如在發起介面請求時，參數isReturnImage=Y且證件OCR流程順利完成，則返回此欄位。

base64格式

ocrIdInfo

String

證件OCR欄位資訊。

{

"expiryDate": "",

"originOfIssue": "公安部出入境管理局",

"englishName": "LI SI",

"sex": "男",

"name": "李四",

"idNumber": "H11111112",

"issueDate": "2013-01-02",

"birthDate": "1990-02-21"

}

spoofInfo

String

證件防偽檢測結果，包括風險判定結果和風險類型：

• spoofResult：

  • Y：存在風險。

  • N：正常。

• spoofType：

  • SCREEN_REMARK：翻拍。

  • PHOTO_COPY：複印件。

  • TAMPER：篡改。

{

"spoofResult": "Y",

"spoofType": [

"SCREEN_REMARK"

]

}

ocrIdEditInfo

String

使用者在OCR結果頁二次編輯後，提交的證件OCR欄位資訊。該功能支援配置關閉，具體請聯絡客戶經理。

{

"expiryDate": "2026-01-02",

"originOfIssue": "公安部出入境管理局",

"englishName": "ZHANG SAN",

"sex": "男",

"name": "張三",

"idNumber": "H11111115",

"issueDate": "2013-01-02",

"birthDate": "1990-02-21"

}

HTTP狀態代碼

Code

Message說明

200

Success

請求成功。

400

MissingParameter

參數不可為空。

400

InvalidParameter

非法參數。

400

TransactionIdInvalid

無效Transaction id。

403

Forbidden.RAMUserAccessDenied

需要給RAM使用者授予AliyunAntCloudAuthFullAccess的操作許可權。更多資訊，請參見授權RAM使用者訪問服務。

403

Forbidden.AccountAccessDenied

賬戶存在欠費，請儲值後再進行操作。

403

Throttling.Api

API限流攔截。

404

ProcessNotCompleted

整個認證流程未完成。

500

InternalError

系統內部錯誤，請反饋工程師排查。

錯誤碼

是否計費

描述和原因建議

200

Yes

認證通過。

201

Yes

官方資料庫中姓名和身份證不一致。可能是使用者的資訊有誤或使用者的資訊為假資訊，建議使用者確認後重新操作。

202

Yes

官方資料庫查詢不到身份資訊。建議預留人工審核入口，進行人工審核。

204

Yes

活體人臉和證臉比對不一致。可能人證不符或活體照片品質較低。

205

Yes

活體檢測存在風險。

206

Yes

業務策略限制。開啟安全模式下，會對認證的裝置等環境進行安全檢測，若檢測到可能存在風險會判定認證結果不通過。您可以按照如下方法排查處理：

• 提醒使用者卸載掉裝置上可能安裝的各種多開、分身、虛擬環境等軟體或外掛程式，恢複裝置系統初始安全環境後重試。

207

Yes

官方資料庫中人臉核驗失敗。可能不是同一人或活體照片品質較低。

209

Yes

權威比對源異常。

212

Yes

證件防偽檢測存在風險。可能存在翻拍、篡改、複印等高風險操作。