银行卡实名认证接口技术规范

1、深圳市超彩网络信息有限公司 热线电话超彩官网： / 9/9银行卡实名认证接口技术规范文件状态： 草稿 正式发布 正在修改文件标识：当前版本：1.1作 者：张有伟完成日期：2017-1-4目 录 TOC o 1-3 h z u HYPERLINK l _Toc456596863 1 适用范围 PAGEREF _Toc456596863 h 3 HYPERLINK l _Toc456596864 2银行卡实名认证接口 PAGEREF _Toc456596864 h 3 HYPERLINK l _Toc456596865 接口流程介绍 PAGEREF _Toc45659

2、6865 h 3 HYPERLINK l _Toc456596866 2.1二元素实名认证： PAGEREF _Toc456596866 h 4 HYPERLINK l _Toc456596867 2.1.1输入参数 PAGEREF _Toc456596867 h 4 HYPERLINK l _Toc456596868 2.1.1输出结果 PAGEREF _Toc456596868 h 4 HYPERLINK l _Toc456596869 2.2三元素实名认证： PAGEREF _Toc456596869 h 5 HYPERLINK l _Toc456596870 2.2.1输入参数 PAG

3、EREF _Toc456596870 h 5 HYPERLINK l _Toc456596871 2.2.1输出结果 PAGEREF _Toc456596871 h 5 HYPERLINK l _Toc456596872 2.3四元素实名认证： PAGEREF _Toc456596872 h 6 HYPERLINK l _Toc456596873 2.3.1输入参数 PAGEREF _Toc456596873 h 6 HYPERLINK l _Toc456596874 2.3.1输出结果 PAGEREF _Toc456596874 h 6 HYPERLINK l _Toc456596875 3

4、银行卡实名查询数量接口： PAGEREF _Toc456596875 h 7 HYPERLINK l _Toc456596876 3.1输入参数 PAGEREF _Toc456596876 h 7 HYPERLINK l _Toc456596877 3.2输出结果 PAGEREF _Toc456596877 h 7 HYPERLINK l _Toc456596878 4 返回结果resp_code PAGEREF _Toc456596878 h 81 适用范围 如今随着互联网产业的多元化发展，尤其是互联网金融，O2O，移动支付，共享经济等新兴商业形式的兴起，企业对实名认证业务的数据形式和数据质

5、量有了更高的需求。2银行卡实名认证接口 接口流程介绍接口地址：HYPERLINK:99/gway/httpRealNameCheck.action返回格式：JSON请求方式：GET/POST接口作用：对外提供给用户，进行实名校验。需要IP绑定，只能在绑定的IP上访问接口。 2.1二元素实名认证：2.1.1输入参数请求示例：URL?code=账号&pass=密码&goodsNo=业务编号& cardNum=银行卡号&name=姓名&phoneNum=预留手机号参数名参数类型描述处理要求codestring实名验证业务账号必填passstring账号密码必填goodsNostring业务编号必填c

6、ardNumstring持卡人银行卡号必填namestring持卡人姓名（姓名UTP-8格式）二者必填一项phoneNumString银行预留手机号2.1.1输出结果返回结果报文json： orderNumber:1601051531229446176,resp_code:10000,resp_msg:一致 orderNumber：交易编号resp_code:状态码“10000”成功resp_msg：响应信息，描述错误信息参数名参数类型描述resp_codestring“10000”认证成功，其他失败原因描述请参阅“返回结果”orderNumberstring交易编号，查询完成后提供作为交易标

7、识resp_msgstring 响应信息，描述错误信息，可为空，仅供参考！2.2三元素实名认证：2.2.1输入参数请求示例：URL?code=账号&pass=密码&goodsNo=业务编号&name=姓名&idCard=身份证& cardNum=银行卡号参数名参数类型描述处理要求codestring实名验证业务账号必填passstring账号密码必填goodsNostring业务编号必填namestring持卡人姓名（UTP-8格式）必填idCardstring持卡人18位身份证号码必填cardNumstring持卡人银行卡号必填2.2.1输出结果返回结果报文json： orderNumber

8、:1601051531229446176,resp_code:10000,resp_msg:一致 orderNumber：交易编号resp_code:状态码“10000”成功resp_msg：响应信息，描述错误信息参数名参数类型描述resp_codestring“10000”认证成功，其他失败原因描述请参阅“返回结果”orderNumberstring交易编号，查询完成后提供作为交易标识resp_msgstring 响应信息，描述错误信息，可为空，仅供参考！2.3四元素实名认证：2.3.1输入参数请求示例：URL?code=账号&pass=密码&goodsNo=业务编号&name=姓名&idC

9、ard=身份证&cardNum=银行卡号& phoneNum=手机号码参数名参数类型描述处理要求codestring实名验证业务账号必填passstring账号密码必填goodsNostring业务编号必填namestring持卡人姓名（UTP-8格式）必填idCardstring持卡人18位身份证号码必填cardNumstring持卡人银行卡号必填phoneNumstring银行预留手机号必填2.3.1输出结果返回结果报文json： orderNumber:1601051531229446176,resp_code:10000,resp_msg:一致 orderNumber：交易编号resp

10、_code:状态码“10000”成功resp_msg：响应信息，描述错误信息参数名参数类型描述resp_codestring“10000”认证成功，其他失败原因描述请参阅“返回结果”orderNumberstring交易编号，查询完成后提供作为交易标识resp_msgstring 响应信息，描述错误信息，可为空，仅供参考！3银行卡实名查询数量接口：3.1输入参数请求示例：http:/ :99/gway/queryBusinessCount.action?code=账号&pass=密码&goodsNo=业务编号参数名参数类型描述处理要求codestring实名验证业务账号必填passstring

11、账号密码必填goodsNostring业务编号必填3.2输出结果返回结果报文json： count:123,resp_code:10000count：数量resp_code:状态码参数名参数类型描述resp_codestring“10000”成功，其他失败原因描述请参阅“返回结果”countstring 账号查询数量4 返回结果resp_code 代码状态意义10000成功认证成功1000001失败认证失败C1失败账号不正确C2失败账号密码不对C3失败未开通实名验证C4失败实名验证可用次数不足C5失败实名验证查询时间范围不满足一周内C6失败实名验证ip校验不通过C7失败查询完成C8失败查询日期条件不充足C9失败查询结果为空C10失败查询异常C11失败用户被禁用C12失败实名认证业务禁用C13失败实名认证业务不存在C14失败手机号码交易失败C