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

接口说明

接口名:InitSmartVerify

服务地址:cloudauth.cn-shanghai.aliyuncs.com(上海区域)或cloudauth.cn-beijing.aliyuncs.com(北京区域)。

请求方法:HTTPS POST和GET。

接口描述:每次开始认证前调用本接口获取CertifyId,用来串联认证请求中的各个接口。

请求参数

名称 类型 是否必选 示例值 描述
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 张三 姓名。
说明ModeOCR_VERIFY时,IdName为必填字段。
IdNo String 330103xxxxxxxxxxxx 身份证号。
Ip String 114.xxx.xxx.xxx 用户网络IP。
UserId String 12345xxxx 您业务中自定义的用户ID,请保持唯一。
CallbackUrl String https://www.aliyun.com 认证结果的回调通知地址,必须以https开头。

平台在完成认证后会回调该地址,并自动添加certifyIdpassedsubcode字段,示例: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。

示例

请参见银行卡核验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 系统错误 系统内部错误,请提交工单进行反馈,由阿里云工程师协助排查。