中国工商银行网上银行网上支付接口规范.doc

商户手册
中国工商银行软件开发中心
Copyright Reserved
目录
第 1 章 业务说明 3
第 2 章 商户接口 4
支付接口 5
支付接口表单定义 5
tranData数据定义 6
tranData格式定义 7
表单样例 8
通知接口 9
通知接口表单定义 9
notifyData数据定义 10
notifyData格式定义 11
表单样例 11
说明 12
第 3 章 安全API说明 13
第 4 章 开发步骤 13
业务说明
B2C在线支付接口实现工行个人网银客户在工行B2C商户网站进行消费支付的业务处理。。
(扩充语言字段以支持英文版)在订单中要求商户选择通知方式,即1、需要银行通知交易结果,2、不需要银行通知交易结果而是商户主动查询;当需要通知时,需要在订单中提供商户接收银行通知地址,当银行处理结束后,会在银行的后台服务器请求商户的此地址,将交易结果用http连接post表单形式提交给商户,然后返回客户交易结果页面。
,和接收银行通知的地址;此版本要求商户在提交订单时,提供交易处理后返回商户的地址,即完成客户从商户转向到银行进行支付,处理后又从银行定向回商户网站的闭环。在从银行交易页面返回商户时,将交易结果作为表单数据提交到商户此返回地址。
处理的优点:1、强制完成交易闭环;2、无需银行后台发送通知,客户不需要等待商户接收银行通知后才能看到交易结果页面,缩短响应时间;3、通知方式不再局限于http连接和80端口,返回商户的地址可以使用https方式和其他商户支持的端口,提高安全性;4、银行作为交易的一方,支持众多商户和客户时,存在一定的带宽和服务器处理压力,使用客户返回商户方式提供交易结果,可有效减少交易掉单现象,只要客户到了银行的结果页面,如果还出现掉单问题,则可能是客户和商户的通讯等方面的问题。
以下简述处理流程:
客户在商户网站浏览商品信息,签订订单;
,并使用工行提供API和商户证书对订单数据签名,形成form表单返回客户浏览器,表单action地址指向工行接收商户订单信息的servlet;
客户确认使用工行支付后,提交此表单到工行;
工行网银系统接收此笔订单,对订单信息和商户信息进行检查;
通过检查则显示工行支付页面,;
客户输入后提交;
银行查询客户相关信息;
返回客户在银行的预留信息;
客户确认;
返回交易确认页面;
不同类型客户使用各自认证方式进行交易确认,支持静态支付密码、动态口令卡、证书签名;
银行校验后进行支付处理;
将结果形成通知消息并有银行端签名信息,返回客户端;
引导客户返回商户网站,地址是订单中提供的商户url,此url支持http和https及自定义端口;
B2C在线支付接口版本说明:
(基本支付)
(支持英文界面)
(内部保留)
(,优化通知方式)
(商户订单中指定支付卡,不强制使用e卡支付,不允许客户的支付卡透支支付,专门用于基金商户进行基金直销业务,)
通知消息模式区别:
原有模式:支付处理后,后台发送商户通知;
新增模式:支付完成后或客户点击“返回商户”,利用客户浏览器跳转,完成商户通知的转发,后台不再单独发送商户通知。
对于不同类型商户接口区别:
..

商户接口
接口定义通过接口名称和接口版本号来标识,以便将来的扩展;新通知方式的B2C接口称为新模式B2C接口;原有后台发送http通知的方式称为原模式接口;
支付接口
支付接口表单定义
新模式接口的交易数据整合到一个xml格式串,作为表单的一项整体提交,不再同原来每个字段都是key-value形式;
FORM表单数据如下:
变量名称
变量命名
长度定义
说明
接口名称
interfaceName
MAX(30)
必输,
取值:“ICBC_PERBANK_B2C”
接口版本号
interfaceVersion
MAX(15)
必输,
取值:“”