手机支付控件使用指南
手机支付控件使用指南
2.0.0
中国银联
2013-01-08
手机支付控件使用指南
版本号
日期
说明
2. 0.0
2013-01-08
初稿
手机支付控件使用指南
一、概述 ........................................................................................................................... 1
二、支付流程介绍 ........................................................................................................... 1
二、测试帐号 ................................................................................................................... 2
三、iOS 客户端 ................................................................................................................. 2
1、 SDK 说明 ................................................................................................... 2
2、 接口说明 .................................................................................................. 3
3、 添加 SDK 包 .............................................................................................. 3
4、 调用插件 .................................................................................................. 4
四、Android 客户端 ......................................................................................................... 4
1、 SDK 包说明 ............................................................................................... 4
2、 接口说明 .................................................................................................. 5
3、 添加 SDK 包 .............................................................................................. 6
4、 调用支付控件 .......................................................................................... 7
五、手机 Web 站点 .......................................................................................................... 8
1、 支持浏览器 .............................................................................................. 8
2、 方式一 ...................................................................................................... 8
3、 方式二 ...................................................................................................... 9
4、 Web 订单生成 ......................................................................................... 10
5、 接入浏览器方案推荐 ............................................................................ 11
6、 控件下载地址 ........................................................................................ 11
六、开发者注意事项 ..................................................................................................... 12
七、常见问题总结 ......................................................................................................... 12
1、 iOS 平台常见问题 ................................................................................. 12
2、 Android 平台常见问题 ......................................................................... 12
附录一、主流浏览器支持情况 ..................................................................................... 12
手机支付控件使用指南
1
一、概述
银联手机支付控件(以下简称支付控件)，主要为合作商户的手机客户端或手机 Web
网站提供安全、便捷的支付服务。目前支付控件支持 Android 和 iOS 两个平台，用户通
过在支付控件中输入银行卡卡号、手机号、密码（借记卡和预付卡）或者 CVN2、有效期
（信用卡）、验证码等要素完成支付。
二、支付流程介绍
通过支付控件进行交易的流程如下图：
客户端
商户后台
银联后台
1、浏览商品，点击下单
2、提交订单信息
3、返回交易流水号（TN）
4、返回交易流水号（TN）
5、通过交易流水
号启动支付控件开
始支付
6、支付控件收集支付信息，完成支付
7、通知商户后台支付结果
8、通知支付控件支付结果
9、支付控件通知
客户端或浏览器支
付结果
流程图说明：
（1）用户在客户端中点击购买商品，客户端发起订单生成请求到商户后台；
（2）商户后台收到订单生成请求后，按照《UPMP 商户接入接口规范》组织并推送
订单信息至银联后台；
（3）银联后台接收订单信息并检查通过后，生成对应交易流水号（即 TN），并回复
交易流水号至商户后台（应答要素：交易流水号等）；
（4）商户后台接收到交易流水号，将交易流水号返回给客户端；
手机支付控件使用指南
2
（5）客户端通过交易流水号（TN）调用支付控件；
（6）用户在支付控件中输入相关支付信息后，由支付控件向银联后台发起支付请
求；
（7）支付成功后，银联后台将支付结果通知给商户后台；
（8）银联将支付结果通知支付控件；
（9）支付控件显示支付结果并将支付结果返回给客户端；
注: 本文档主要关注上述流程中（5）、（ 9）部分的实现
目前各个平台支持的设备情况如下：
Android 平台 SDK 主要适用于 Android 2.1 及以上版本的终端设备；
iOS 版本支付控件适用 iOS 5.1 及以上版本终端设备。
二、测试帐号
提供测试使用卡号、手机号信息（此类信息仅供测试，不会发生正式交易）
招商银行预付费卡：
卡号：6226 4401 2345 6785
密码：111101
三、iOS 客户端
本小节提供给那些具有一定 iOS 编程经验和了解面向对象概念的读者使用。
SDK 文件所在目录：upmp_iphone/sdk,以下部分所说文件，均在该目录中查找。
1、 SDK 说明
SDK 分为以下两个版本：
① 支持纯无卡交易静态库，以下简称 UPPayPlugin，包含文件：
UPPayPlugin.h
UPPayPluginDelegate.h
libUPPayPlugin.a
② 支持纯无卡交易和 VIPOS 音频口支付静态库,以下简称 UPPayPluginPro，包含
文件：
UPPayPluginPro.h
- 1
- 2
- 3
前往页