手机银行(WAP)B2C在线支付接口说明V1.0.0.6

1、手机银行(WAP)B2c在线支付接口说明VL 0. 0. 6手机银行商户手册B2c 支付接口 vl.0.0. 6中国工商银行软件开发中心Copyright Reserved商户手册手机银行商户手册目录第1章业务说明3第2章商户接口 42. 1支付接口 4 2. 1. 1支付接口表单定义 42. 1.2 tranData 数据定义 52. 1. 3 tranData 格式定义72. 1. 4表单样例82. 2通知接口 9 2. 2. 1通知接口表单定义 92. 2. 2 notifyData 数据定义 102. 2. 3 notifyData 格式定义112.2.4表单样例122.3商户判断支付

2、结果及返回商户取货13 2. 4其他说明13第3章安全API说明14第4章开发步骤144. 1通用步骤 144. 2移动生活商户改造方法154. 3 附件16第2页共17页手机银行商户手册第1章业务说明B2c在线支付接口版本说明：1.0. 0.0 （基本支付）1. 0. 0. 1 （支持商户主动分期付款模式，商户不分期的情况下支持客户自助分期，商 户客户都不分期的情况下，流程同1.0. 0.0）1.0. 0.3 （1.0. 0.1版本基础上，支持后台自动给商户发送支付结果通知消息，通知消 息发送方式为只有支付成功的情况下发送通知，其余情况不通知）1.0. 0.4 （1.0. 0.3版 本基础上

3、，支持他人代付功能）1. 0. 0. 6 （基于1.0. 0.3版本，支持启动工行手机银行客户端（iPhones Android）进 行支付，支持工行移动生活商户进行支付，支持HTML网页版本（只支持iPhone、Android 的webkit核心浏览器，需要商户侧白行判断客户的浏览器是否可用）进行支付。注：1.0. 0.6接口的HTML网页版本暂未开放!以下简述处理流程:1 .客户在商户WAP网站、商户客户端（iPhone. Andrid）、工行移动生活商户浏览 商品信息，签订订单；2 .商户按照工行手机银行B2c支付L 0.0. 6接口形成提交数据，并使用工行提供API 和商户证书对订单数

4、据签名，形成form表单返回客户浏览器，表单action地址指向工行 接收商户订单信息的servlet：3 .客户确认使用工行支付后，提交此表单到工行；4 .工行手机银行系统接收此笔订单，对订单信息和商户信息进行检查；5 .通过检查则根据商户上送的启动类型，启动工行手机银行客户端程序（iPhone. Android）的支付页面或HTML网页版本（只支持iPhone、Android的webkit核心浏览器） 的支付页面：6.客户输入后提交：7.银行查询客户相关信息；8.返回客户在银行的 预留信息：9.客户确认；10 .返回交易确认页面；11 .不同类型客户使用各白认证方式进行交易确认，支持静态支

5、付密码、动态口令卡、 工银电子密码器、音频U盾（U盾只支持iPhone客户端版本）。12.银行校验后进行支 付处理；13.工行将处理结果使用http协议post方式，将通知消息数据提交到商户网站； 14.给客户展现成功支付页面。1）若商户启动类型为客户端版本，则结果页面只提供返回手机银行按钮，点击后返 回手机银行程序，客户需要自行回到商户页面或商户程序进行取货，商户根据上一步的通知 消息判断是否支付成功。2）若商户启动类型为工行移动生活版本，则结果页面提供返回商户按钮，点击返回 后会回到商户的页面，客户可以在此页面进行取货，商户可以根据上一步发送的通知消息判 断是否支付成功。3）若商户启动类型

6、为HTML网页版本，则上一步通知商户时，商户返回取货地址 （必须是正确格式的URL地址)，银行会在成功支付页面展现取货地址链接，客户点击链接返 回商户的取货地址页面。第3页共17页手机银行商户手册第2章商户接口接口定义通过接口名称和接口版本号来标识，以便将来的扩展；1 .1支付接口2 . 1. 1支付接口表单定义WAP银行B2c接口的交易数据整合到一个xml格式串，作为表单的一项整体提交； FORM表单数据如下：变量名称接口名称接口版本号变量命名interfaceName interfaceversion 长度定义 MAX(30) MAX(15)必输， 取值："ICBC'AP

7、B_B2C” 必输, 取值：“1.0. 0.6”必输，签名；整合所有交易数据形成的xml明文串，并做BASE64编 码；交易数据tranData无限制具体格式定义见下文；注意：需有xml头属性；整个 字段使用BASE64编码；xml明文中没有回车换行和多余空格；必输，商户使用工行提 供的签名API和商户证书将tranData的xml明文串进行签名，订单签名数据merSignMsg 无限制得到二进制签名数据，然后进行BASE64编码后得到可视的merSignMsg：注意： 签名时是针对tranData的xml明文，不是将tranData进行BASE64编码后的串：商城证 书公钥必输，merCer

8、t无限制商户用二进制方式读取证书公钥文件后，进行BASE64编 码后产生的字符串；必输，取值：1：工行iPhone客户端版启动类型clientType MAX(2) 2：工行Android客户端版21：工行移动生活版(iPhone) 22：工行移动生活版 (Android) 0： HTML 版(只支持 iPhone、Android 第 4 页共 17 页说明手机银行商户手册的webkit核心浏览器)暂未开放注：1、数据中不能包含“I”、“&"、“ 二 "，这些字符为银行端程序保留字符；中文变 量使用GBK编码。2、从商户Post过来的数据，参数名的名称必须与上表中完

9、全相同，名称中的字母大 小写均要相同，不能进行随意更改(在form中的提交按钮中submit不能有Name属性); 此外，如果其他input项的Name中使用了双引号，如：4、商户提交数据中的空格将被认为是有效字符被接收，请商户开发时注意对多余空 格的控制。5、tranData交易数据的xml串需要有xml的头，即2. 1. 2 tranData 数据定义变量名称接口名称接口版本号变量命名interfaceName interfaceVersion长度 定义=13=7必输，取值："ICBC_WAPB_B2C”必输，取值：“L0.0.6”必输，格 式为：YYYYMMDDHHmmss交易日期时间orderDate =14要求在银行系统当前时间的前1小 时和后12小时范围内，否则判定交易时间非法。必输，客户支付后商户网站产生的一 个唯一订单号orderid MAX(30)的定单号，该订单号应该在相当长的时间内不重复。工 行通过订单号加订单日期来唯一确认一笔订单的重复性。必输，订单金额amount MAX(IO)客户支付订单的总金额，一笔订单一个，以