银行卡实名认证标准版API开发文档
一、接口简介
1、版权说明：
未经翔云人工智能开放平台授权，不得擅自进行使用。
2、调用客户端运行环境
当客户端使用的编程语言为Java时，请使用1.5及以上版本JRE。
3、服务主要功能描述
翔云银行卡实名认证标准版服务，实时联网权威数据源，快速核查上传银行卡、姓名、身份证号、手机号是否与权威数据一致，返回银行卡、姓名、身份证号、手机号信息。
- 通过https协议post方法上传，通过https接口进行查验；
- 将核验结果以XML或json格式返回给用户；
4、服务调用约束
在调用银行卡实名认证标准版接口前，请您确保客户端程序或设备网络连接通畅。
二、前提准备
1、用户登录 https://www.netocr.com/register.html注册账号，如图:
2、输入注册信息，确认无误后点击同意条款并注册，如图:
3、注册成功后点击右上角的账号名称-个人中心，进入管理页面:
4、点击“用户管理-基础信息”，查看OCRKey以及OCRSecret：
5、点击“服务列表”，查看服务次数及余额(每调用一次https接口消耗一次)，可点击立即购买直接跳转到购买页面购买API服务次数：
6、购买成功后,会显示购买的总次数及剩余次数，例如下图所示：
7、设置剩余条数提醒，进入个人中心-用户管理-剩余条数提醒，设置提醒下线、通知手机号及服务类型，设置成功后到达用户设置的服务剩余条数下限，系统会发短息至预留手机号。
三、接口说明
1、接口地址：https://netocr.com/verapi/verbankOrd.do
2、接口调用方法：post
3、请求参数
接口接收参数：
序号 名称 类型 必填 说明
1 key String 是 用户ocrKey
2 secret String 是 用户ocrSecrert
3 bankNo String 是 银行卡号
4 trueName String 是 姓名
5 idenNo String 是 身份证号
6 tel String 是 手机号
7 typeId Integer 是 银行卡实名认证标准版：3011
8 format String 是 返回格式(xml或者json)，如果format为空，则默认返回xml
状态码说明：
status code message
0000 认证信息匹配
0001 认证信息不匹配
0002 参数为空或不合法
0003 获取商户信息失败
0004 获取商户费率失败
0005 获取商户可用条数失败
0006 商户资金不足
0007 商户订单号重复
0008 验证异常
0009 身份证名字转码错误
0010 银行卡格式错误或银行规则未配置复
0011 银行卡不支持
0012 未获取到可用渠道
veritem code message
00 一致（扣费）
01 验证信息未通过（扣费）
01 认证失败（扣费）
01 密码错误（扣费）
01 无效卡号（扣费）
01 未开通此功能（扣费）
01 银行卡与证件不符（扣费）
01 银行卡与姓名不符（扣费）
01 请求要素不合法（扣费）
01 响应码设置异常（扣费）
01 不支持该银行验证（扣费）
02 请求银行超时
03 解密失败
03 核对 md5值异常
03 核对 md5值不通过
03 报文解析异常
03 请求银行超时
03 请求银行异常
03 解析银行返回报文失败
03 发送银行加密异常
03 其他错误
03 商户不存在
调用错误码
status值 描述
-1 用户已屏蔽
-2 用户key或secret验证错误
-3 服务次数不足
-4 用户未找到
-6 系统异常
-7 图片不可为空，参数不可为空
-8 类型错误
调用方式(java客户端基于httpclient4.3)
1.依赖库: java客户端httpClient4.3库，如图:
2.示例程序代码详见: java客户端httpClientDemo中的Client类，如图:
在main方法定义参数，并传入 doPost(url, file, key, secret, typeId, format) 方法中。如图:
返回结果如下：
0000 success 00剩余条数查询接口(所有产品类型)
接口地址： https://netocr.com/api/accountLift.do
接口调用方法： post
接口接收参数：
String key： 用户ocrKey
String secret： 用户ocrSecret
String format： 返回格式(xml或者json)，如果format为空，则默认返回xml
