中国银联手机支付控件使用指南

手机支付控件使用指南手机支付控件使用指南2.0.0中国银联2013-01-08手机支付控件使用指南版本信息版本号日期说明2.0.02013-01-08初稿2.0.12015-07-29部分错误修正。安卓升级3.0.7控件data.bin移到assets文件夹下。增加jar集成方式说明。删除浏览器调起控件相关说明，浏览器方式请直接使用wap产品。增加FAQ。手机支付控件使用指南目录版本信息...................................................................................................................2目录...........................................................................................................................31概述....................................................................................................................12支付流程介绍....................................................................................................13测试帐号............................................................................................................24iOS客户端.........................................................................................................34.1SDK说明.................................................................................................34.2接口说明................................................................................................44.3添加SDK包...........................................................................................54.4调用插件................................................................................................55常见问题总结....................................................................................................65.1iOS平台常见问题..................................................................................6手机支付控件使用指南11概述银联手机支付控件(以下简称支付控件)，主要为合作商户的手机客户端或手机Web网站提供安全、便捷的支付服务。目前支付控件支持Android和iOS两个平台，用户通过在支付控件中输入银行卡卡号、手机号、密码（借记卡和预付卡）或者CVN2、有效期（信用卡）、验证码等要素完成支付。2支付流程介绍通过支付控件进行交易的流程如下图：客户端商户后台银联后台1、浏览商品，点击下单2、提交订单信息3、返回交易流水号（TN）4、返回交易流水号（TN）5、通过交易流水号启动支付控件开始支付6、支付控件收集支付信息，完成支付7、通知商户后台支付结果8、通知支付控件支付结果9、支付控件通知客户端或浏览器支付结果流程图说明：（1）用户在客户端中点击购买商品，客户端发起订单生成请求到商户后台；（2）商户后台收到订单生成请求后，按照《手机控件支付产品接口规范》组织并推送手机支付控件使用指南2订单信息至银联后台；（3）银联后台接收订单信息并检查通过后，生成对应交易流水号（即TN），并回复交易流水号至商户后台（应答要素：交易流水号等）；（4）商户后台接收到交易流水号，将交易流水号返回给客户端；（5）客户端通过交易流水号（TN）调用支付控件；（6）用户在支付控件中输入相关支付信息后，由支付控件向银联后台发起支付请求；（7）支付成功后，银联后台将支付结果通知给商户后台；（8）银联将支付结果通知支付控件；（9）支付控件显示支付结果并将支付结果返回给客户端；注:本文档主要关注上述流程中（5）、（9）部分的实现目前各个平台支持的设备情况如下：Android平台SDK主要适用于Android2.1及以上版本的终端设备；iOS版本支付控件适用iOS6.0及以上版本终端设备。3测试帐号提供测试使用卡号、手机号信息（此类信息仅供测试，不会发生正式交易）招商银行借记卡：6226090000000048手机号：[phone]密码：111101短信验证码：123456（先点获取验证码之后再输入）证件类型：01身份证手机支付控件使用指南3证件号：510265790128303姓名：张三华夏银行贷记卡：6226388000000095手机号：[phone]cvn2：248有效期：1219短信验证码：123456（先点获取验证码之后再输入）证件类型：01身份证证件号：510265790128303姓名：张三4iOS客户端本小节提供给那些具有一定iOS编程经验和了解面向对象概念的读者使用。SDK文件所在目录：upmp_iphone/sdk，以下部分所说文件，均在该目录中查找。4.1SDK说明SDK分为以下两个版本：①支持纯无卡交易静态库，以下简称UPPayPlugin，包含文件：UPPayPlugin.hUPPayPluginDelegate.hlibUPPayPlugin.a手机支付控件使用指南4②支持纯无卡交易和VIPOS音频口支付静态库,以下简称UPPayPluginPro，包含文件：UPPayPluginPro.hUPPayPluginDelegate.hlibUPPayPluginPro.a4.2接口说明+(BOOL)startPay:(NSString*)tnmode:(NSString*)modeviewController:(UIViewController*)viewControllerdelegate:(idUPPayPluginDelegate)delegate;各个参数的介绍如表3-1：表3-1接口参数说明参数名称类型含义tnNSString*必填项；交易流水号信息，银联后台生成，通过商户后台返回到客户端并传入支付控件；modeNSString*必填项；接入模式设定，两个值：@00:代表接入生产环境（正式版本需要）；手机支付控件使用指南5@01：代表接入开发测试环境（测试版本需要）；viewControllerUIViewController*必填项；商户应用程序调用银联手机支付的当前UIViewController；delegateidUPPayPluginDelegate必填项；实现UPPayPluginDelegate方法的UIViewController；4.3添加SDK包a)根据商户选择的SDK版本，将sdk/inc目录和sdk/libs目录下对应版本的三个文件添加到UPPayDemo工程中；b)如果你选择的是UPPayPlugin版本，添加QuartzCore.framework、Security.framework到工程中；c)如果你选择的是UPPayPluginPro版本，添加QuartzCore.framework、AudioToolbox.framework,CoreAudio.framework、MediaPlayer.framework,AVFoundation.framework和Security.framework到工程中；d)在工程的BuildSettings中找到OtherLinkerFlags中添加-ObjC宏；4.4调用插件a)在需要调用支付控件的源文件内引用头文件UPPayPlugin.h或UPPayPluginPro.h（注意：如果工程的compilesourceas选项的值不是Objective–C++，则引用此头手机支付控件使用指南6文件的文件类型都要改为.mm）b)通过调用+(BOOL)startPay:(NSString*)tnmode:(NSString*)modeviewController:(UIViewController*)viewControllerdelegate:(idUPPayPluginDelegate)delegate;实现控件的调用c)处理支付结果银联手机支付控件有三个支付状态返回值：success、fail、cancel，分别代表：支付成功、支付失败、用户取消支付。这三个返回状态值以字符串的形式作为回调函数参数(NSString*)result返回。通过在工程中添加头文件“UPPayPluginDelegate.h”，在处理交易结果的界面，实现UPPayPluginDelegate接口，根据该头文件中的回调函数：-(void)UPPayPluginResult:(NSString*)result来实现回调方法，从而可以根据支付结果的不同进行相关的处理。5常见问题总结更多请参见——》buildsettings-Linking-otherlinkerflags手机支付控件使用指南75.1.2编译时提示UndefinedforarchitectureXXX错误?如：1）由于支付控件使用到了C、C++和OC混编的情况，所以商户工程引入UPPayPlugin.h头文件以后可能会出现链接错误。这个时候可以通过两种方式解决：①将涉及到引用UPPayPlugin.h的源文件的后缀名都改为.mm；②如果商户不想修改源文件的后缀名，可以在工程中添加一个空的继承自NSObject的类，并将文件.m后缀名该改为.mm即可。方法为newfile-Objective-Cclass-类名自取-保存-修改后缀名为.mm。手机支付控件使用指南8③将工程的compilesourceas选项的值不是Objective–C++；2）由于在UPPayDemo工程中添加了自定义的库文件libUPPayPlugin.a，当编译Demo工程时，应该检查工程设置SearchPaths里的FrameworkSearchPaths、HeaderSearchPaths、LibrarySearchPaths的路径设置，看设置路径是否正确，另外还要注意里边是否多余一些不确定的路径3)将xcode工程中BuildSetting-AppleLLVMcompilerLanguage标签下的C++LanguageDialect和C++StandardLibrary属性值修改为CompilerDefault。如实在无法解决，尝试添加-ObjC宏的地方修改为-force_load+空格+控件路径，如：-force_load$(PROJECT_DIR)/libUPPayPlugin.a