iOS开发技术之银联支付

Posted 2020-10-01 桥边风满袖

一、集成银联SDK步骤:

1、查看开发文档

https://open.unionpay.com/ajweb/index

 

2、下载SDK

https://open.unionpay.com/ajweb/help/file/techFile?productId=3

 

3、支付流程说明：

　　(1)用户在客户端中点击购买商品，客户端发起订单生成请求到商户后台;

　　(2)商户后台收到订单生成请求后，按照《手机控件支付产品接口规范》组织并推送订单信息至银联后台;

　　(3)银联后台接收订单信息并检查通过后，生成对应交易流水号(即TN)，并回复至商户后台(应答要素：交易流水号等);

　　(4)商户后台接收到交易流水号(TN)，将交易流水号返回至客户端;

　　(5)客户端通过交易流水号(TN)调用支付控件;

　　(6)用户在支付控件中输入相关支付信息后，由支付控件向银联后台发起支付请求;

　　(7)支付成功后，银联后台将支付结果通知给商户后台;

　　(8)银联后台同时也将支付结果通知支付控件;

　　(9)支付控件显示支付结果并将支付结果返回至客户端;

　　此处备注：我们是通过后台获取订单，我们可以根据商品id等信息通过后台接口获取订单信息，对订单支付流程的签名加密过程后台完成。

 

4、添加SDK包

　　使用UPPaymentControl需要将paymentcontrol/inc目录下UPPaymentControl.h文件和paymentcontrol/libs目录下的libPaymentControl.a文件添加到商户应用的工程中

 

5、添加系统库和工程配置

　　a.http请求设置

　　在Xcode的版本中进行http请求时，需要在工程对应的plist文件中添加NSAppTransportSecurity Dictionary 并同时设置里面NSAllowsArbitraryLoads 属性值为YES

　　b.使用UPPaymentControl需要添加

CFNetwork.framework、SystemConfiguration.framework 、libz、libPaymentControl.a到工程中.

　   c.在工程info.plist设置中添加一个URL Types回调协议(在UPPayDemo工程中使用“UPPayDemo”作为协议)，用于在支付完成后返回商户客户端。

      d.添加协议白名单

　　在Xcode7.0之后的版本中进行开发，需要在工程对应的plist文件中，添加LSApplicationQueriesSchemes Array并加入uppaysdk、uppaywallet、uppayx1、uppayx2、uppayx3五个item

 

6、加-ObjC宏

　　选择工程targets——》build settings ->Linking->other linker flags

7、调用插件

　　在需要调用支付控件接口的代码文件内引用头文件UPPaymentControl.h。

　　(注意：如果工程的compile source as 选项的值不是Objective–C++，则引用此头文件的文件类型都要改为.mm)

　　商户App从商户服务器获取tn(注：先通过调用后台接口获取订单信息)

　　* @param tn 订单信息

　　* @param schemeStr 调用支付的app注册在info.plist中的scheme

　　* @param mode 支付环境"00"代表接入生产环境(正式版本需要);"01"代表接入开发测试环境

　　* @param viewController 启动支付控件的viewController

　　* @return 返回成功失败

//当获得的tn不为空时，调用支付接口 if (tn != nil && tn.length > 0) { 

[[UPPaymentControl defaultControl] startPay:tn fromScheme:@"UPPay" mode:self.tnMode viewController:self]; 

 

}

if([[UPPaymentControl defaultControl] isPaymentAppInstalled])   

{

    //当判断用户手机上已安装银联App，商户客户端可以做相应个性化处理

}

 

8、返回结果接口调用

　　支付控件结果处理函数handlePaymentResult: completeBlock:需要在工程AppDelegate文件的application: openURL: sourceApplication: annotation: 方法中进行调用。

　　支付控件结果处理函数handlePaymentResult: completeBlock:包含两个参数，参数1url为支付结果串，由handlePaymentResult: completeBlock:方法解析url内容;参数2completionBlock为商户APP定义的结果处理方法，包含两个传入参数code和data，其中code表示支付结果，取值为suceess,fail,cancel分别表示支付成功、支付失败和支付取消，data表示结果签名数据，商户使用银联公钥验证结果真实性。

　　completeBlock中的NSDictionary *data结构如下：

　　sign —— 签名后做Base64的数据

　　data —— 用于签名的原始数据，结构如下：

　　pay_result —— 支付结果success，fail，cancel

　　tn —— 订单号

　　Data转换为String后的示例如下：

　　"{"sign":"ZnZY4nqFGu/ugcXNIhniJh6UDVriWANlHtIDRzV9w120E6tUgpL9Z7jIFzWrSV73hmrkk8BZMXMc/9b8u3Ex1ugnZn0OZtWfMZk2I979dxp2MmOB+1N+Zxf8iHr7KNhf9xb+VZdEydn3Wc/xX/B4jncg0AwDJO/0pezhSZqdhSivTEoxq7KQTq2KaHJmNotPzBatWI5Ta7Ka2l/fKUv8zr6DGu3/5UaPqHhnUq1IwgxEWOYxGWQgtyTMo/tDIRx0OlXOm4iOEcnA9DWGT5hXTT3nONkRFuOSyqS5Rzc26gQE6boD+wkdUZTy55ns8cDCdaPajMrnuEByZCs70yvSgA==","data":"pay_result=success&tn=201512151321481233778"}"

　　对于新增的签名信息需注意以下几点：

　　1. 前台返回的支付结果中包含银联签名，要在商户后台对签名进行校验后才能展示结果。

　　2. 前台签名使用的密钥和算法与后台结果中的签名一致。

　　3. 如果商户APP在客户端内进行签名验证，要自行实现签名密钥更新的机制，否则更换密钥后会导致验签失败。(不推荐)

　　4. 商户订单是否成功支付应该以商户后台收到全渠道返回的支付结果为准，此处支付控件返回的结果仅作为参考。

 

二、注意事项:

1、编译时提示Undefined for architecture XXX 错误

　　1)由于支付控件使用到了C、C++和OC混编的情况，所以商户工程引入UPPaymentControl.h头文件以后可能会出现链接错误，这个时候可以通过以下三种方式解决：

　　① 将涉及到引用UPPaymentControl.h的源文件的后缀名都改为.mm;

　　② 如果商户不想修改源文件的后缀名，可以在工程中添加一个空的继承自NSObject的类，并将文件.m后缀名该改为.mm即可方法为new file->Objective-C class->类名自取->保存->修改后缀名为.mm;

　　③ 将工程的compile source as 选项的值设置为Objective–C++;

　　2)由于在UPPayDemo工程中添加了自定义的库文件libPaymentControl.a

　　，当编译Demo工程时，应该检查工程设置Search Paths里的Framework Search Paths、Header Search Paths、Library Search Paths的路径设置，看设置路径是否正确，另外还要注意里边是否多余一些不确定的路径。

　　3) 将xcode工程中Build Setting -> Apple LLVM compiler Language 标签下的C++ Language Dialect 和 C++ Standard Library 属性值修改为 Compiler Default如实在无法解决，尝试添加-ObjC宏的地方修改为 -force_load+空格+控件路径，如：-force_load $(PROJECT_DIR)/ libPaymentControl.a，如果还报错，上下文应该会有libPaymentControl.a文件找不到异常，比如ld: file not found: /Users/apple/Desktop/Communication 2/ libPaymentControl.a

　　clang: error: linker command failed with exit code 1 (use -v to see invocation)

　　请确定libPaymentControl.a文件确实存在于此路径，可能为上下文路径配错。

 

2、控件闪退异常\'NSInvalidArgumentException\', reason: \'-[__NSCFConstantString newSizeWithFont:详略]\'

　　出现以上问题是由于添加-ObjC宏的地方没有配置正确，如果配-ObjC实在解决不了的话，可尝试去掉-ObjC，改为-force_load+空格+控件路径，如：-force_load $(PROJECT_DIR)/ libPaymentControl.a。

 

3、orientation异常

　　详细现象为控件崩溃，报错信息：Terminating app due to uncaught exception ‘UIApplicationInvalidInterfaceOrientation’, reason: ‘Supported orientations has no common orientation with the application, and shouldAutorotate is returning YES’ 请勿修改横竖屏配置，iphone控件只能竖屏，ipad控件才支持横竖屏。如果app本身为横屏，请代码控制横竖屏，勿修改配置。

 

4、其他第三方静态库(如支付宝、微信等)的文件产生冲突duplicate symbols for architecture XXX

　　请尝试将添加-ObjC宏的地方修改为 -force_load+空格+控件路径，如：-force_load $(PROJECT_DIR)/ libPaymentControl.a，这样做不会影响支付宝等其他支付渠道功能。

 

5、控件界面无限加载

　　1. 调用控件的逻辑应当在主线程中执行，子线程中尽量不要进行UI操作，无限加载等待实际是子线程死锁所致。2. 请参考控件使用指南ios “添加SDK包“里“添加-ObjC宏”，特别注意大小写不要弄混。(此步骤操作有问题时也可修改为 -force_load+空格+控件路径，如：-force_load $(PROJECT_DIR)/ libPaymentControl.a)。3. Build Setting -> Apple LLVM compiler Language-C++