调用InitSmartVerify发起银行卡核验请求。

接口说明

接口名：InitSmartVerify。

服务地址：cloudauth.cn-shanghai.aliyuncs.com（上海区域）或cloudauth.cn-beijing.aliyuncs.com（北京区域）。

请求方法：POST和GET。

传输协议：HTTPS。

接口描述：调用InitSmartVerify发起中国内地银联银行卡自动OCR识别银行卡卡号信息或识别卡号信息后并对卡号信息与身份信息一致性验证服务。

说明 仅支持中国内地银联银行卡。

请求参数

名称 类型 是否必选 示例值 描述
SceneId Long 是 100000xxxx 认证场景ID。

您必须先在增强版实人认证控制台创建认证场景，才能获得认证场景ID。更多信息，请参见添加认证场景。

OuterOrderNo String 是 e0c34a77f5ac40a5aa5e6ed20c35xxxx 商户请求的唯一标识，由32位字母、数字组合而成。
CertType String 是 BANK_CARD 证件类型。唯一取值：BANK_CARD，表示银行卡。
Mode String 是 OCR 卡证核身的模式。取值：
  • OCR：识别模式。
  • OCR_VERIFY：识别且认证模式。
MetaInfo String 是 {"zimVer":"3.0.0","appVersion": "1","bioMetaInfo": "4.1.0:11501568,0","appName": "com.aliyun.antcloudauth","deviceType": "ios","osVersion": "iOS 10.3.2","apdidToken": "","deviceModel": "iPhone9,1"} MetaInfo环境参数，需要通过客户端SDK获取。

更多信息，请参见Android客户端接入、iOS客户端接入。

Mobile String 否 130xxxxxxxx 用户手机号码。
IdName String 否 张三 姓名。
说明 当Mode为OCR_VERIFY时，IdName为必填字段。
IdNo String 否 330103xxxxxxxxxxxx 身份证号。
Ip String 否 114.xxx.xxx.xxx 用户网络IP。
UserId String 否 12345xxxx 您业务中自定义的用户ID，请保持唯一。
CallbackUrl String 否 https://www.aliyun.com 认证结果的回调通知地址，必须以https开头。
平台在完成认证后会回调该地址，并自动添加certifyId、passed和subcode字段，示例：https://www.aliyun.com?certifyId=xxxx&passed=T&subcode=200。
说明 仅当认证完成（包含认证通过和认证未通过）时才会触发回调，若认证中放弃、异常中断或未进行认证均不会通知。建议您收到回调通知时，若有需要可通过查询接口获取认证详情资料信息。
CallbackToken String 否 NMjvQanQgplBSaEI0sL86WnQplB 安全Token，用于防重复、防篡改校验。如果传入该参数，会在回调地址显示CallbackToken字段。

返回数据

名称 类型 是否必选 示例值 描述
RequestId String 是 130A2C10-B9EE-4D84-88E3-5384FF039795 请求ID。
Message String 否 success 错误信息。
Code String 是 200 返回码。关于错误码的具体介绍，请参见错误码。
ResultObject.CertifyId String 否 91707dc296d469ad38e4c5efa6a0xxxx 认证请求ID，增强版实人认证服务认证请求的唯一标识。
查询认证结果时，必须传入认证请求ID。
说明 初始化接口返回的认证CertifyId在30分钟有效且仅能认证提交一次，请您在有效期内应用，避免重复使用。

示例

请参见银行卡核验Java SDK调用示例。
说明 如果您需要其他语言的SDK代码示例，您可以通过OpenAPI开发者门户在线调试工具调试API接口。运行成功后，OpenAPI开发者门户可以自动生成SDK代码示例。

错误码

Code Message 描述
200 success 接口响应成功。
400 参数不能为空 参数不能为空。
401 参数非法 非法参数。传入的姓名、身份证号码长度必须符合国家标准且不得包含英文字母和特殊字符。
404 认证场景配置不存在 认证场景配置不存在，请先在控制台上创建认证场景。

更多信息，请参见添加认证场景。

410 未开通服务 未开通OSS产品或未完成OSS读写授权，请登录增强版实人认证控制台完成授权。
411 RAM无权限 需要给RAM用户授予AliyunYundunCloudAuthFullAccess的操作权限。
412 欠费中 增强版实人认证或OSS存在欠费，请充值后再进行操作。
428 格式校验错误 参数格式校验错误，请调整参数格式。
500 系统错误 系统内部错误，请通过智能在线联系阿里云工程师协助排查。