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

网上银行商户手册 PAGE 第 PAGE 9 页 共 NUMPAGES 16 页 网上银行商户手册 B2C支付接口v1 商户手册 商户手册 中国工商银行软件开发中心 Copyright Reserved 目录 TOC \o 1-3 \h \z \u HYPERLINK \l _Toc 第 1 章 业务说明 PAGEREF _Toc \h 3 HYPERLINK \l _Toc 第 2 章 商户接口 PAGEREF _Toc \h 4 HYPERLINK \l _Toc 2.1 支付接口 PAGEREF _Toc \h 5 HYPERLINK \l _Toc 2.1.1 支付接口表单定义 PAGEREF _Toc \h 5 HYPERLINK \l _Toc 2.1.2 tranData数据定义 PAGEREF _Toc \h 6 HYPERLINK \l _Toc 2.1.3 tranData格式定义 PAGEREF _Toc \h 7 HYPERLINK \l _Toc 2.1.4 表单样例 PAGEREF _Toc \h 8 HYPERLINK \l _Toc 2.2 通知接口 PAGEREF _Toc \h 9 HYPERLINK \l _Toc 2.2.1 通知接口表单定义 PAGEREF _Toc \h 9 HYPERLINK \l _Toc 2.2.2 notifyData数据定义 PAGEREF _Toc \h 10 HYPERLINK \l _Toc 2.2.3 notifyData格式定义 PAGEREF _Toc \h 11 HYPERLINK \l _Toc 2.2.4 表单样例 PAGEREF _Toc \h 11 HYPERLINK \l _Toc 2.3 说明 PAGEREF _Toc \h 12 HYPERLINK \l _Toc 第 3 章 安全API说明 PAGEREF _Toc \h 13 HYPERLINK \l _Toc 第 4 章 开发步骤 PAGEREF _Toc \h 13 业务说明 以下简述处理流程： 客户在商户网站浏览商品信息，签订订单； 商户按照工行B2C支付1接口形成提交数据，并使用工行提供API和商户证书对订单数据签名，形成form表单返回客户浏览器，表单action地址指向工行接收商户订单信息的servlet； 客户确认使用工行支付后，提交此表单到工行； 工行网银系统接收此笔订单，对订单信息和商户信息进行检查； 通过检查则显示工行支付页面，1版本会提示客户输入交易卡号； 客户输入后提交； 银行查询客户相关信息； 返回客户在银行的预留信息； 客户确认； 返回交易确认页面； 不同类型客户使用各自认证方式进行交易确认，支持静态支付密码、动态口令卡、证书签名； 银行校验后进行支付处理； 工行进行支付指令处理后，如果商户需要工行实时通知，则工行将处理结果使用http协议post方式将通知消息数据提交到商户网站（这个接收银行通知消息的商户端地址是随商户订单数据提交银行的merURL字段），商户返回取货地址或关闭这个银行与其建立的连接后，银行才显示交易结果页面给客户。（注意1、发送通知和显示结果页面是串行的，所以商户端接收银行通知处理时间太长可能导致客户等待超时，造成银行不能将交易结果页面显示给客户。2、此连接是银行服务器自动和商户进行的连接，商户返回也是直接返回给银行，商户端不能对银行的这个请求进行重定向。） 工行进行支付指令处理后，如果商户不需要工行实时通知，则工行直接显示交易结果给客户。 B2C在线支付接口版本说明： （基本支付） （支持中英文界面） （内部保留） （保留功能，优化通知方式） （商户订单中指定支付卡，不强制使用e卡支付，不允许客户的支付卡透支支付，专门用于基金商户进行基金直销业务，同通知方式） （基于，在原有接口基础上扩展支持红利卡，支持红利卡的商户采用；当上送项不支持红利卡的时候，接口等同于） （基于，在原有接口基础上扩展支持红利卡，支持红利卡的商户采用；当上送项不支持红利卡的时候，接口等同于） （基于，在原有接口基础上扩展支持同时上送5笔订单，即支持购物车模式，支持商户主动分期付款模式，当商户选择1期和1笔订单的时候，功能等同于接口） （基于，在原有接口基础上扩展，根据商户上送的是否允许透支标志来控制是否运行客户使用信用卡进行支付，同通知方式） （基于，在原有接口基础上优化商户校验及接口并发性，同通知方式） 0（基于，同通知方式） 1（基于，在原有接口基础上增加的透支标志控制，增加商户上送数据,丰富及扩展用户体验，增加校验商户域名，同通知方