ID Verification：InitializeV2

集成方式

适用场景

初始化接口返回

请求参数

App SDK

Android / iOS 原生 App 内完成认证

TransactionId、Protocol

共有参数 + App 特有参数

Web SDK

移动端 H5 或 PC 浏览器认证

TransactionId、TransactionUrl、Protocol

共有参数 + Web SDK特有参数

字段

类型

必选

说明

示例值

ProductCode

String

是

产品方案标识，取值：

ID_OCR_PRO。用户需完成证件识别。

ID_OCR_PRO

SceneCode

String

否

自定义认证场景 ID；用于后续在控制台输入此ID进行记录检索。支持长度为10位的字母、数字或下划线组合。

1234567890

MerchantBizId

String

是

商户业务唯一标识，用于后续定位排查问题。支持32 位字母和数字组合。服务端不校验此ID唯一性，商户应自行保证唯一。

e0c34a77f5ac40a5aa5e6ed20c35****

MetaInfo

String

是

{
  "zimVer": "3.0.0",
  "appVersion": "1",
  "bioMetaInfo": "4.1.0:1150****,0",
  "appName": "com.aliyun.antcloudauth",
  "deviceType": "h5",
  "osVersion": "iOS 10.3.2",
  "apdidToken": "",
  "deviceModel": "iPhone9,1"
}

MerchantUserId

String

是

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

123456789

CallbackUrl

String

否

CallbackToken

String

否

商户自定义安全令牌；设置后将会原样随CallbackUrl返回，用于防重放、防篡改校验。

NMjvQanQgplBSaEI0sL********

IdThreshold

String

否

3

IdSpoof

String

否

【OCR配置】是否开启卡证防伪检测：

• Y：开启（默认）

• N：关闭

输出结果请在CheckResult中查看Result.ExtIdInfo.ocrIdInfoData.{page}.spoofInfo

N

OcrValueStandard

String

否

【OCR配置】是否返回 OCR 标准化字段：

• 0：否（默认）

• 1：是

输出结果请在CheckResult中查看Result.ExtIdInfo.ocrStandardData

0

DocType

String

是

【OCR配置】证件编码，或国家 / 地区编码。若传入国家/地区编码，最多可指定3个（例如：CHN,HKG,GLB）作为自动分类范围。系统将自动检索该范围内支持的证件类型，并在识别成功后返回具体的证件编码。

请在证件编码表中查询支持的国家/地区证件编码；在证件OCR字段表中查询每种证件的OCR返回字段详情。

GLB03001

Pages

String

否

【OCR配置】证件采集页：

• 01：人像面（默认）

• 01,02 ：人像面+背面

01

AutoDocPageConfig

String

否

【OCR配置】仅当 DocType 为国家/地区编码时生效，为具体的证件类型编码配置指定的采集页数。未在 AutoDocPageConfig 中配置的证件，仅采集该证件正面。

Native SDK 1.4.0及以上版本支持。

{
 "BRA01001": "01",
 "BRA01002": "01,02"
}

ShowGuidePage

String

否

【UI配置】是否展示引导页：

• 1：展示（默认）

• 0：不展示

PC浏览器模式不支持此配置。Native SDK 1.2.8及以上版本支持。

1

字段

类型

必选

说明

示例值

DocScanMode

String

否

【OCR配置】OCR 证件扫描模式：

• shoot：拍照

• scan：自动扫描

• auto：拍照/扫描自动切换

仅Native SDK1.2.8及以上且集成自动扫描组件模块支持。

shoot

字段

类型

必选

说明

示例值

LanguageConfig

String

否

{
  "languageContent": {****},
  "ocrResultContent": {****},
  "supportedLanguage": [****],
  "titleTranslate": {****},
}

StyleConfig

String

否

{
  "guidepage:": {****}, 
  "ocrPage": {****},
  "ocrResultPage": [****],
  "facePage": {****},
}

ShowAlbumIcon

String

否

【OCR配置】OCR 环节是否展示相册上传入口：

• 1：展示（默认）

• 0：不展示

1

ShowOcrResult

String

否

【OCR配置】OCR 环节是否展示识别结果页：

• 1：展示（默认）

• 0：不展示

1

EditOcrResult

String

否

【OCR配置】是否允许用户编辑 OCR 识别结果：

• 1：允许（默认）

• 0：不允许

1

ReturnUrl

String

条件必选

认证结束后的业务回跳地址。使用 iframe 内嵌模式时非必填；非 iframe 页面跳转场景应提供。

https://www.alibabacloud.com

ProcedurePriority

String

否

当移动端H5方式认证出现兼容性问题时，是否允许展示降级的处理方式。

• url：支持降级。页面展示认证URL，用户可复制URL打开或者切换浏览器继续认证（默认）。

• keep：不支持降级。直接返回错误原因，并结束认证流程。PC端不支持，App 内嵌网页建议设为 keep。

url

字段

App SDK

Web SDK

说明

RequestId / Code / Message

是

是

通用响应信息。

Result.TransactionId

是

是

认证流程唯一标识、计费统计字段，也是后续 CheckResult 的请求参数。建议与商户业务 ID 绑定后仅保存在服务端。

Result.Protocol

是

是

认证标准加密协议。建议透传给客户端 SDK；Web SDK iframe 内嵌方式依赖该字段。

Result.TransactionUrl

否

是

Web SDK认证 URL，认证后按 ReturnUrl 回跳。不可修改、仅能访问一次；获取到 URL 或 TransactionId 后须在 30 分钟内完成认证。