一:介绍
项目中要用到支付功能,需要支付宝支付、支付宝网页支付、微信支付、银联支付、Apple_pay,所以打算总结一下,方便以后的查阅,也方便大家, 用到的地方避免再次被坑。 今天我们就主要介绍一下银联控件支付,其他支付也写了对应教程,并且给出了连接。
集成前首先要看看文档,银联手机控件支付,里面包含需要的库文件和详细的文档。鉴于小伙伴们不容易找到,好事做到底,送上截图方便下载。
银联手机控件SDK
二:支付流程介绍
通过支付控件进行交易的流程如下图:
业务流程图
流程图说明: (1)用户在客户端中点击购买商品,客户端发起订单生成请求到商户后台; (2)商户后台收到订单生成请求后,按照《手机控件支付产品接口规范》组织并推送订单信息至银联后台; (3)银联后台接收订单信息并检查通过后,生成对应交易流水号(即TN),并回复至商户后台(应答要素:交易流水号等); (4)商户后台接收到交易流水号(TN),将交易流水号返回至客户端; (5)客户端通过交易流水号(TN)调用支付控件; (6)用户在支付控件中输入相关支付信息后,由支付控件向银联后台发起支付请求; (7)支付成功后,银联后台将支付结果通知给商户后台; (8)银联后台同时也将支付结果通知支付控件; (9)支付控件显示支付结果并将支付结果返回至客户端; 此处备注:我们是通过后台获取订单,我们可以根据商品id等信息通过后台接口获取订单信息,对订单支付流程的签名加密过程后台完成。
三:下载银联SDK
银联手机控件支付SDK
下载之后,找到.h文件和库文件,使用UPPaymentControl需要将paymentcontrol/inc目录下UPPaymentControl.h文件和paymentcontrol/libs目录下的libPaymentControl.a文件添加到商户应用的工程中
SDK路径
四:工程配置
4.1 导入SDK库
导入上面那个iOS头文件和库下载下载出来的SDK包的就行,然后需要链接上依赖库,在Target —> BuildPhases —> Link Binary With Libraries— 点击 号 -> 搜索你需要的系统库。
- CFNetwork.framework
- SystemConfiguration.framework
- libz
- libPaymentControl.a
导入SDK库
4.2 设置URL Scheme
在工程info.plist设置中添加一个URL Types回调协议(在UPPayDemo工程中使用“UPPayDemo”作为协议),用于在支付完成后返回商户客户端。
URL Scheme
4.3 http请求设置
进行http请求时,需要在工程对应的plist文件中添加NSAppTransportSecurity Dictionary 并同时设置里面NSAllowsArbitraryLoads 属性值为 YES
4.4 添加协议白名单
需要在工程对应的plist文件中,添加LSApplicationQueriesSchemes Array并加入uppaysdk、uppaywallet、uppayx1、uppayx2、uppayx3五个item,如下图:
添加白名单
4.5 调用支付接口
在调用银联支付类里面,首先增加头文件引用。
代码语言:javascript复制#import "UPPaymentControl.h"
在调起支付的方法中代码如下:
代码语言:javascript复制//当获得的tn不为空时,调用支付接口
if (tn != nil && tn.length > 0) {
[[UPPaymentControl defaultControl]startPay:tn
fromScheme:@"URL Scheme"
mode:tnModel
viewController:self];
}
方法需要的几个参数文档上都写的有,tn是交易流水号,服务器端传回来的,客户端只有凭借这个参数才能调用支付控件 进行支付的。只需要调用一个方法就行啦!!!
4.6 支付结果回调
在支付成功之后,支付结果返回,需要获取url,需要在Appdelegate中完成 在Appdelegate里面,首先增加头文件引用。
代码语言:javascript复制#import "UPPaymentControl.h"
代码如下:
代码语言:javascript复制- (BOOL)application:(UIApplication *)application
openURL:(NSURL *)url
sourceApplication:(NSString *)sourceApplication
annotation:(id)annotation {
if ([url.host isEqualToString:@"uppayresult"]){
//银联支付结果
[[UPPaymentControl defaultControl] handlePaymentResult:url completeBlock:^(NSString *code, NSDictionary *data) {
//结果code为成功时,先校验签名,校验成功后做后续处理
if([code isEqualToString:@"success"]) {
//交易成功
}else if([code isEqualToString:@"fail"]) {
//交易失败
}else if([code isEqualToString:@"cancel"]) {
//交易取消
}
}];
}
return YES;
}// NOTE: 9.0以后使用新API接口
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<NSString*, id> *)options
{
if ([url.host isEqualToString:@"uppayresult"]){
//银联支付结果
[[UPPaymentControl defaultControl] handlePaymentResult:url completeBlock:^(NSString *code, NSDictionary *data) {
//结果code为成功时,先校验签名,校验成功后做后续处理
if([code isEqualToString:@"success"]) {
//交易成功
}else if([code isEqualToString:@"fail"]) {
//交易失败
}else if([code isEqualToString:@"cancel"]) {
//交易取消
}
}];
}
return YES;
}
4.7 常见问题解决
1.由于支付控件使用到了C、C 和OC混编的情况,将涉及到引用UPPaymentControl.h的源文件的后缀名都改为.mm;2.由于在UPPayDemo工程中添加了自定义的库文件libPaymentControl.a,当编译Demo工程时,应该检查工程设置Search Paths里的Framework Search Paths、Header Search Paths、Library Search Paths的路径设置,看设置路径是否正确,另外还要注意里边是否多余一些不确定的路径。3.控件界面无限加载,请参考控件使用指南iOS “添加SDK包“里“添加-ObjC宏”,特别注意大小写不要弄混。(此步骤操作有问题时也可修改为 -force_load 空格 控件路径,如:-force_load (PROJECT_DIR)/ libPaymentControl.a)。4.控件闪退异常'NSInvalidArgumentException', reason: '-[__NSCFConstantString newSizeWithFont:详略]' 出现以上问题是由于添加-ObjC宏的地方没有配置正确,如果配-ObjC实在解决不了的话,可尝试去掉-ObjC,改为-force_load 空格 控件路径,如:-force_load (PROJECT_DIR)/ libPaymentControl.a。