ios开发--集成银联3.3.0

时间:2023-01-10 06:53:55

项目最近需要集成银联,在网上搜了一下发现都并不是最新版的银联集成教程,自己摸索了一下,总结写了下来。

附上3.3.0的下载网址 https://open.unionpay.com/upload/download/手机控件支付开发包(IOS版)3.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开发包/控件开发包/upmpiphone/paymentcontrol 文件夹直接加到Demo里。

导入之后要在Build Settings --> Library Search Paths里对 libPaymentControl.a 路径设置,可以参考 demo,$(PROJECTDIR)/(这里写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。

        <key>LSApplicationQueriesSchemes</key>
<array>
<string>uppaysdk</string>
<string>uppaywallet</string>
<string>uppayx1</string>
<string>uppayx2</string>
<string>uppayx3</string>
</array>

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 姓名:张三 以上就是银联的集成,很简单。

水平所限,有错误求指正。