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

notifyData对应的明文：

1.0.0.11200707251050140010200EC2000087520070725105014-2134062548200

tallmentTimes>1020002040901502913020070725105014-21340625493003020002040901502913120070725105014-2134062550600602000204090150291300200707251050149200707251104001

mment>交易成功！

第 14 页 共 16 页

网上银行商户手册

2.3 说明

商户可能收到的银行通知 指令成功：

只能有一笔成功、且要验证银行签名、订单金额等信息是否与商户端记录一致。 指令失败：

商户只能收到一笔客户放弃支付返回商城的信息。 指令可疑：

由于网银系统与后台业务处理系统间通讯异常，造成网银不能确认支付指令结果，则此笔指令为可疑指令；可疑指令将被自动批复，商户、客户可于第二日查询指令状态。

没有收到客户浏览器转发的银行通知：

由于客户浏览器端或互联网通讯等原因可能造成商户端接收不到客户浏览器提交的银行通知。当没有收到银行通知时，可登录工行商户服务网站手工查询指令状态或者商户调用查询接口自动处理。

商户提交的订单信息和银行返回的通知消息都是xml串，并且进行了BASE64编码； 提交和返回的xml都应有xml头；

第 3 章 安全API说明

为了保证商户提交订单数据和银行通知信息数据的完整性，不可抵赖性，现提供一套用于信息签名、验签和BASE64编解码的函数。商户开发时使用这套函数和工行颁发的商户证书进行商户订单信息签名；签名数据项和顺序均固定，具体格式可参见上文的数据定义；同时使用这套API和银行公钥可以验证银行通知消息的有效性。安全API的使用方法可参见相关开发语言的说明和demo程序；

第 4 章 开发步骤

商户程序需在银行模拟测试环境上进行联调后，再投产，以下说明联调开发步骤。 生成订单：

1、 商户和当地行联系，申请联调测试；由当地行在模拟测试环境录入商户信息，生成商户

证书（pfx格式）；并提供银行模拟测试环境的银行证书公钥文件（用于验证银行签名时使用）；

2、 商户或者银行用证书拆分工具将pfx格式的商户证书拆分成扩展名为crt的公钥文件和

扩展名为key的私钥文件；（这两个文件用于商户开发API调用来进行商户订单数据签名）

3、 商户进行开发，准备要求的订单数据；

4、 其中订单签名数据merSignMsg字段是对明文的签名数据；需要使用提供的API函数和

商户私钥进行签名，得到签名串，然后做BASE64编码；

5、 其中商城证书公钥merCert字段需要使用API函数做BASE64编码； 6、 准备好订单数据，即完成订单提交的开发；之后只要将订单提交银行接收入口“https://

第 15 页 共 16 页

网上银行商户手册

银行地址/servlet/ICBCINBSEBusinessServlet”，银行来处理B2C指令的资金支付；

接收通知：

交易处理后，会将客户定向回商户网站，此时包含交易结果信息和银行签名。商户接收到银行通知后，需使用开发API和银行公钥来验证银行签名，以确保通知消息的有效性，以下简要说明验证步骤：

1、 获得各字段取值后，注意提交的明文需要进行base64解码才能获得。使用商户开发API

和银行公钥文件对表单中的银行签名signMsg进行验签；

2、 验签成功后，为确保数据一致，建议商户比较一下通知消息中订单金额、卖家卡号等关

键信息和自己记录的是否一致；

3、 商户根据交易结果tranStat来更新自己的指令状态和相关数据库信息；

第 16 页 共 16 页