中国工商银行网上银行新B2C在线支付接口说明V1.0.0.11

网上银行商户手册

B2C支付接口v1.0.0.11

商户手册 中国工商银行软件开发中心 Copyright Reserved

网上银行商户手册

目录

第 1 章 第 2 章

2.1 2.1.1 2.1.2 2.1.3 2.1.4 业务说明 ....................................................................................................................... 3 商户接口 ....................................................................................................................... 4 支付接口 ....................................................................................................................... 4 支付接口表单定义 ................................................................................................... 4 tranData数据定义 .................................................................................................. 6 tranData格式定义 .................................................................................................. 8 表单样例 ................................................................................................................... 9 2.2 2.2.1 2.2.2 2.2.3 2.2.4 2.3 第 3 章 第 4 章

通知接口 ..................................................................................................................... 11 通知接口表单定义 ................................................................................................. 11 notifyData数据定义 ............................................................................................ 12 notifyData格式定义 ............................................................................................ 13 表单样例 ................................................................................................................. 14 说明 ............................................................................................................................. 15 安全API说明 ............................................................................................................ 15 开发步骤 ..................................................................................................................... 15

第 2 页 共 16 页

网上银行商户手册

第 1 章 业务说明

以下简述处理流程：

4、校验商户签名和证书、订单数据、商户状态等7、检查客户信息指令主机发12、主机14、将结果返回商户商户13、返回客户支付结果3、客户将订单数据提交银行返回客户支付页面5、回显订单指定卡号或提示客户输入卡号6、客户确定提交网银1、客户浏览商户网站并下订单2、商户使用API证书对订单签名并返回客户端8、返回预留信息9、客户确认10、返回确认页面11、客户确认（静态密码、动态密码、签名）客户

1. 客户在商户网站浏览商品信息，签订订单；

2. 商户按照工行B2C支付1.0.0.11接口形成提交数据，并使用工行提供API和商户证书对订单数据签名，形成form表单返回客户浏览器，表单action地址指向工行接收商户订单信息的servlet；

3. 客户确认使用工行支付后，提交此表单到工行；

4. 工行网银系统接收此笔订单，对订单信息和商户信息进行检查；

5. 通过检查则显示工行支付页面，1.0.0.11版本会提示客户输入交易卡号； 6. 客户输入后提交；

7. 银行查询客户相关信息； 8. 返回客户在银行的预留信息； 9. 客户确认；

10. 返回交易确认页面；

11. 不同类型客户使用各自认证方式进行交易确认，支持静态支付密码、动态口令卡、证书签名；

12. 银行校验后进行支付处理；

13. 工行进行支付指令处理后，如果商户需要工行实时通知，则工行将处理结果使用http协议post方式将通知消息数据提交到商户网站（这个接收银行通知消息的商户端地址是随商

第 3 页 共 16 页

网上银行商户手册

户订单数据提交银行的merURL字段），商户返回取货地址或关闭这个银行与其建立的连接后，银行才显示交易结果页面给客户。（注意1、发送通知和显示结果页面是串行的，所以商户端接收银行通知处理时间太长可能导致客户等待超时，造成银行不能将交易结果页面显示给客户。2、此连接是银行服务器自动和商户进行的连接，商户返回也是直接返回给银行，商户端不能对银行的这个请求进行重定向。）

14. 工行进行支付指令处理后，如果商户不需要工行实时通知，则工行直接显示交易结果给客户。

B2C在线支付接口版本说明： 1.0.0.0（基本支付）

1.0.0.1（支持中英文界面） 1.0.0.2（内部保留）

1.0.0.3（保留1.0.0.1功能，优化通知方式）

1.0.0.4（商户订单中指定支付卡，不强制使用e卡支付，不允许客户的支付卡透支支付，专门用于基金商户进行基金直销业务，同1.0.0.3通知方式）

1.0.0.5（基于1.0.0.1，在原有接口基础上扩展支持红利卡，支持红利卡的商户采用；当上送项不支持红利卡的时候，接口等同于1.0.0.1）

1.0.0.6（基于1.0.0.3，在原有接口基础上扩展支持红利卡，支持红利卡的商户采用；当上送项不支持红利卡的时候，接口等同于1.0.0.3）

1.0.0.7（基于1.0.0.3，在原有接口基础上扩展支持同时上送5笔订单，即支持购物车模式，支持商户主动分期付款模式，当商户选择1期和1笔订单的时候，功能等同于1.0.0.3接口） 1.0.0.8（基于1.0.0.3，在原有接口基础上扩展，根据商户上送的是否允许透支标志来控制是否运行客户使用信用卡进行支付，同1.0.0.3通知方式）

1.0.0.9（基于1.0.0.3，在原有接口基础上优化商户校验及接口并发性，同1.0.0.0通知方式） 1.0.0.10（基于1.0.0.8，同1.0.0.0通知方式）

1.0.0.11（基于1.0.0.7，在原有接口基础上增加1.0.0.8的透支标志控制，增加商户上送数据,丰富及扩展用户体验，增加校验商户域名，同1.0.0.0通知方式）

第 2 章 商户接口 2.1 支付接口

2.1.1 支付接口表单定义

新模式接口的交易数据整合到一个xml格式串，作为表单的一项整体提交，不再同原来每个字段都是key-value形式；

FORM表单数据如下： 变量名称 接口名称 变量命名 interfaceName 长度定义 MAX(30) 说明 必输， 取值：“ICBC_PERBANK_B2C” 第 4 页 共 16 页

网上银行商户手册

接口版本号 交易数据 interfaceVersion MAX(15) tranData 无限制 必输， 取值：“1.0.0.11” 必输，签名； 整合所有交易数据形成的xml明文串，并做BASE64编码； 具体格式定义见下文； 注意： 需有xml头属性；整个字段使用BASE64编码； xml明文中没有回车换行和多余空格； 必输， 商户使用工行提供的签名API和商户证书将tranData的xml明文串进行签名，得到二进制签名数据，然后进行BASE64编码后得到可视的merSignMsg； 注意：签名时是针对tr …… 此处隐藏：2588字，全部文档内容请下载后查看。喜欢就下载吧 ……