手机银行(WAP)B2C在线支付接口说明V1.0.0.6
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
B2C 支付接口v1.0.0.6
中国工商银行软件开发中心 Copyright Reserved
商户手册
目录
第1 章业务说明 (3)
第2 章商户接口 (4)
2.1支付接口 (4)
2.1.1支付接口表单定义 (4)
2.1.2tranData数据定义 (5)
2.1.3tranData格式定义 (7)
2.1.4表单样例 (8)
2.2通知接口 (9)
2.2.1通知接口表单定义 (9)
2.2.2notifyData数据定义 (10)
2.2.3notifyData格式定义 (11)
2.2.4表单样例 (12)
2.3商户判断支付结果及返回商户取货 (13)
2.4其他说明 (13)
第3 章安全API说明 (14)
第4 章开发步骤 (14)
4.1通用步骤 (14)
4.2移动生活商户改造方法 (15)
4.3附件 (16)
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版本基础上，支持他人代付功能）
1.0.0.6（基于1.0.0.3版本，支持启动工行手机银行客户端（iPhone、Android）进行支付，支持工行移动生活商户进行支付，支持HTML网页版本（只支持iPhone、Android的webkit核心浏览器，需要商户侧自行判断客户的浏览器是否可用）进行支付。
注：1.0.0.6接口的HTML网页版本暂未开放！
以下简述处理流程：
1.客户在商户WAP网站、商户客户端（iPhone、Andrid）、工行移动生活商户浏览商品信息，签订订单；
2.商户按照工行手机银行B2C支付1.0.0.6接口形成提交数据，并使用工行提供API和商户证书对订单数据签名，形成form表单返回客户浏览器，表单action地址指向工行接收商户订单信息的servlet；
3.客户确认使用工行支付后，提交此表单到工行；
4.工行手机银行系统接收此笔订单，对订单信息和商户信息进行检查；
5.通过检查则根据商户上送的启动类型，启动工行手机银行客户端程序（iPhone、Android）的支付页面或HTML网页版本（只支持iPhone、Android的webkit核心浏览器）的支付页面；
6.客户输入后提交；
7.银行查询客户相关信息；
8.返回客户在银行的预留信息；
9.客户确认；
10.返回交易确认页面；
11.不同类型客户使用各自认证方式进行交易确认，支持静态支付密码、动态口令卡、工银电子密码器、音频U盾（U盾只支持iPhone客户端版本）。
12.银行校验后进行支付处理；
13.工行将处理结果使用http协议post方式，将通知消息数据提交到商户网站；
14.给客户展现成功支付页面。
1）若商户启动类型为客户端版本，则结果页面只提供返回手机银行按钮，点击后返回手机银行程序，客户需要自行回到商户页面或商户程序进行取货，商户根据上一步的通知消
息判断是否支付成功。
2）若商户启动类型为工行移动生活版本，则结果页面提供返回商户按钮，点击返回后会回到商户的页面，客户可以在此页面进行取货，商户可以根据上一步发送的通知消息判断
是否支付成功。
3）若商户启动类型为HTML网页版本，则上一步通知商户时，商户返回取货地址（必须是正确格式的URL地址），银行会在成功支付页面展现取货地址链接，客户点击链接返回
商户的取货地址页面。
接口定义通过接口名称和接口版本号来标识，以便将来的扩展；
2.1支付接口
2.1.1支付接口表单定义
WAP银行B2C接口的交易数据整合到一个xml格式串，作为表单的一项整体提交； FORM 表单数据如下：
变量名称变量命名长度定义说明
接口名称interfaceName MAX(30) 必输，
取值：“ICBC_WAPB_B2C”
接口版本号interfaceVersion MAX(15) 必输，
取值：“1.0.0.6”
交易数据tranData 无限制必输，签名；
整合所有交易数据形成的xml明文串，并做BASE64编码；
具体格式定义见下文；
注意：
需有xml头属性；整个字段使用BASE64编码；
xml明文中没有回车换行和多余空格；
订单签名数
据merSignMsg 无限制
必输，
商户使用工行提供的签名API和商户证
书将tranData的xml明文串进行签名，
得到二进制签名数据，然后进行BASE64
编码后得到可视的merSignMsg；
注意：签名时是针对tranData的xml
明文，不是将tranData进行BASE64编
码后的串；
商城证书公
钥merCert 无限制
必输，
商户用二进制方式读取证书公钥文件
后，进行BASE64编码后产生的字符串；
启动类型clientType MAX(2) 必输，
取值：
1：工行iPhone客户端版
2：工行Android客户端版
21：工行移动生活版（iPhone）
22：工行移动生活版（Android）
0：HTML版（只支持iPhone、Android