ID Verification：eKYC_MIN

名稱

類型

是否必選

描述

樣本值

ProductCode

String

是

要接入的產品方案。取值eKYC_MIN。

eKYC_MIN

SceneCode

String

否

您自訂的認證情境ID，用於後續控制台輸入此情境ID查詢相關記錄。支援長度為10位的字母、數字或底線的組合。

1234567890

MerchantBizId

String

是

自訂的業務唯一標識，用於後續定位排查問題使用。支援長度為32位的字母和數位組合，請確保唯一。

e0c34a77f5ac40a5aa5e6ed20c35****

MerchantUserId

String

是

您自訂的使用者ID，或者其他可以識別特定使用者的標識，例如手機號碼、郵箱地址等。強烈建議對該欄位的值進行預先脫敏，例如對值進行雜湊處理。

Y

DocType

String

是

證件類型，以8位元字組合作為唯一標識。更多說明，請參見證件類型列表。

01000000

DocName

String

否

使用者的真實姓名。

張三

DocNo

String

否

使用者的證件號碼。

411xxxxxxxxxxx0001

IdOcrPictureBase64

String

否

證件圖片Base64編碼。

base64編碼

IdOcrPictureUrl

String

否

證件圖片地址，公網可訪問的HTTP、HTTPS連結。

https://***

FacePictureBase64

String

否

人像圖片Base64編碼。

base64編碼

FacePictureUrl

String

否

人像地址，公網可訪問的HTTP、HTTPS連結。

https://***

Crop

String

否

是否允許裁剪人臉圖片：

• T：允許剪裁

• F：不允許剪裁（預設）

F

Authorize

String

否

是否開啟官方資料庫身份核驗：

• T：開啟

• F：關閉（預設）

F

IdThreshold

String

否

0

名稱

類型

描述

樣本值

HTTP Status Code

Integer

HTTP狀態代碼。

200

HTTP Body

RequestId

String

請求ID。

​130A2C10-B9EE-4D84-88E3-5384FF0****

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": 52.57,
  "facePassed": "N",
  "authorityComparisonScore": 80.39
}

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"
    ]
  }
}