ID Verification：ID_OCR_MIN

名称

类型

是否必选

描述

示例值

ProductCode

String

是

要接入的产品方案。取值ID_OCR_MIN：使用证件OCR识别API。

ID_OCR_MIN

SceneCode

String

否

您自定义的认证场景ID，用于后续控制台输入此场景ID查询相关记录。支持长度为10位的字母、数字和下划线的组合。

1234567890

MerchantBizId

String

是

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

e0c34a77f5ac40a5aa5e6ed20c35****

MerchantUserId

String

是

您自定义的用户ID，或者其他可以识别特定用户的标识，例如：手机号码、邮箱地址等。强烈建议对该字段的值进行预先脱敏，例如对值进行哈希处理。

123456789

IdOcrPictureBase64

String

是

证件头像面图片Base64编码。如果您选择IdOcrPictureBase64（照片Base64编码）方式传入证件照片，请注意检查照片大小，不要传入过大的照片。

base64

IdOcrPictureUrl

String

是

证件头像面图片地址，公网可访问的HTTP、HTTPS链接。

https://***

DocType

String

是

证件类型，以8位数字组合作为唯一标识，详见证件类型列表。

F

Ocr

String

是

是否开启OCR功能进行证件信息自动提取。

• T：开启OCR功能

• F：不开启OCR功能

T

IdFaceQuality

String

否

是否返回证件人脸的质量分，默认不开启。

• T：返回人脸质量分

• F：不返回

F

Spoof

String

否

是否开启证件防伪功能，默认不开启。

• T：开启证件防伪功能

• F：不开启

F

IdThreshold

String

否

3

CardSide

String

否

区分证件国徽面和人像面 ，不传默认人像面 。

• OCR_ID_FACE （默认）：人像面

• OCR_ID_NATIONAL_EMBLEM ：国徽面

OCR_ID_NATIONAL_EMBLEM

名称

类型

描述

示例值

HTTP Status Code

Integer

HTTP状态码。

200

HTTP Body

RequestId

String

请求ID。

130A2C10-B9EE-4D84-88E3-5384FF039****

Result.TransactionId

String

整个认证流程的唯一标识。

hksb7ba1b28130d24e015d694361b****

Code

String

返回Code。

Success

Message

String

返回Code的详细描述。

success

Result.Passed

String

认证结果，取值：

• Y：通过

• N：不通过

Y

Result.SubCode

String

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

200

Result.ExtIdInfo

String

证件识别相关结果信息。关于JSON格式，请参见右侧示例。更多信息，请参见ExtIdInfo。

{
  "idFaceQualityScore": 98.0,
  "ocrIdInfo": {
    "expiryDate": "",
    "originOfIssue": "公安部出入境管理局",
    "englishName": "LI SI",
    "sex": "男",
    "name": "李四",
    "idNumber": "H11111112",
    "issueDate": "2013-01-02",
    "birthDate": "1990-02-21"
  },
  "spoofInfo": {
    "spoofResult": "Y",
    "spoofType": [
      "SCREEN_REMARK"
    ]
  }
}