项目最近需要集成银联,在网上搜了一下发现都并不是最新版的银联集成教程,自己摸索了一下,总结写了下来。
附上3.3.0的下载网址 https://open.unionpay.com/upload/download/手机控件支付开发包%28IOS版%293.3.3.rar
文件解压后在 /app开发包/控件使用指南/ 可以得到官方写的开发文档, /app开发包/控件开发包/ 下可以得到demo和SDK,个人感觉官方文档写的很详细了……大家也可以自己结合文档和Demo自己试下。
一:环境配置
1、3.3.0的银联SDK和之前发生了变化,之前是**UPPayPlugin.h UPPayPluginDelegate.h libUPPayPlugin.a**一共三个文件,现在精简成**UPPaymentControl.h libPaymentControl.a**两个文件,当然方法也会有改变。新建工程的话直接将payment control文件夹导入。
//顺便说一句,我下的Demo会报错的,原因是SDK并没有导入,大家遇到同样的问题可以将 /app开发包/控件开发包/upmp_iphone/paymentcontrol 文件夹直接加到Demo里。
导入之后要在Build Settings --> Library Search Paths里对 libPaymentControl.a 路径设置,可以参考 demo,$(PROJECT_DIR)/(这里写libs的上层文件夹,所有的=_=)/libs
2、添加:CFNetwork.framework、SystemConfiguration.framework 、lib系统框架到工程中;
3、 在工程info.plist设置中添加一个URL Types回调协议,用于在支付完成后返回商户客户端;
4、 在Xcode7.0之后的版本中进行开发,需要在工程对应的plist文件中,添加LSApplicationQueriesSchemes Array并加入uppaysdk、uppaywallet、uppayx1、uppayx2、uppayx3五个item。
5、如果工程的compile source as 选项的值不是Objective–C++,则引用此头文件的文件类型都要改为.mm.
二、支付方法:
1、- (BOOL)isPaymentAppInstalled
判断设备上是否安装了银联客户端。
2、
- (BOOL)startPay:(NSString*)tn fromScheme:(NSString*)schemeStr
mode:(NSString*)mode
viewController:(UIViewController*)viewController
tn是交易流水号,从商户后台得到,商户把用户的订单信息提交给银联,银联返回交易流水号,我们只要从后台得到流水好,调用方法就行;
schemeStr:完成支付后,返回自己的应用,在info里的URL types里设置;
mode:固定字符串,测试环境@"01",正式软件版本@"00"; viewController:一般self就行。
3、- (void)handlePaymentResult:(NSURL*)url
completeBlock:(UPPaymentResultBlock)completionBlock;
支付过程结束后在AppDelegate里使用,具体见Demo;
code:字符串,success,cancel,fail简单易懂;
data:用来校验签名。
- (BOOL) application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {
[[UPPaymentControl defaultControl] handlePaymentResult:url completeBlock:^(NSString *code, NSDictionary *data) {
//结果code为成功时,先校验签名,校验成功后做后续处理
if([code isEqualToString:@"success"]) {
//判断签名数据是否存在
if(data == nil){
//如果没有签名数据,建议商户app后台查询交易结果
return;
}
//数据从NSDictionary转换为NSString
NSData *signData = [NSJSONSerialization dataWithJSONObject:data
options:0
error:nil];
NSString *sign = [[NSString alloc] initWithData:signData encoding:NSUTF8StringEncoding];
//验签证书同后台验签证书
//此处的verify,商户需送去商户后台做验签
if([self verify:sign]) {
//支付成功且验签成功,展示支付成功提示
}
else {
//验签失败,交易结果数据被篡改,商户app后台查询交易结果
}
}
else if([code isEqualToString:@"fail"]) {
//交易失败
}
else if([code isEqualToString:@"cancel"]) {
//交易取消
}
}];
return YES;
}
开发文档还提供了试用卡号、手机号等信息(此类信息仅供测试使用,不会发生真实交易)
招商银行借记卡:6226090000000048 手机号:18100000000 密码:111101 短信验证码:123456(先点获取验证码之后再输入) 证件类型:01身份证 证件号:510265790128303 姓名:张三
华夏银行贷记卡:6226388000000095 手机号:18100000000 CVN2:248 有效期:1219 短信验证码:123456(先点获取验证码之后再输入) 证件类型:01身份证 证件号:510265790128303 姓名:张三以上就是银联的集成,很简单。
水平所限,有错误求指正。