iOS集成微信支付

作者: yaqiong | 来源:发表于2017-08-10 11:49 被阅读5704次

刚集成完微信支付,总结总结

1. 准备

微信平台分为微信公众平台微信开放平台,公众平台是运营微信公众号的管理系统,开放平台主要针对app、网站开发,提供登录、分享、支付等功能。

注册开放平台之后,新建应用,填写应用信息(Android、iOS等信息),创建之后需要等待审核(这个审核很快的,几个小时就通过了)。

然后是为该应用申请支付功能,要注意个人是无法申请的,具体可参考微信支付申请条件和资格。这里牵涉到一系列公司资质的审核和费用支付,需要几个工作日的时间

完成之后可以获取到appid(微信开放平台为应用生成的唯一识别码)、商户id、商户secretKey。对于app端来说只用到appid,商户id最好通过接口从server获取,商户secretKey是用来签名的,一般只有server能用到。

2. 支付流程

先上一个开放平台给出的流程图:

支付流程.png

这个图很实用很详细很清晰,但一开始看可能会觉得复杂。其实对开发者来说,比较关心的流程是:

  1. app向server发起支付请求
  2. server收到请求后向微信后台调用统一下单API,获得预付单信息
  3. server生成带签名的客户端支付信息并返回给app
  4. 用户确认支付,app调起微信客户端进行支付
  5. app获得支付结果后向server查询最终结果并显示

流程了解之后,了解下需要定义的接口和前后端的具体工作:

新接口:
  • app向server发起请求,获得签名后的app支付信息
  • app支付之后向server查询支付结果(微信回调的结果不可信,必须以server的结果为准)
app需要做的:
  • 项目接入微信支付sdk
  • 向server请求支付信息
  • 用支付信息调起微信客户端,然后支付
  • 收到微信回调之后向server查询支付结果
  • 根据支付结果展示页面
server需要做的:
  • 收到app端支付请求后调用统一下单API向微信后台获取预支付信息
  • 将app端需要的支付信息签名之后返回给app
  • 接收微信后台回调信息(支付结果),以供app查询

3. iOS开发

开发文档:https://pay.weixin.qq.com/wiki/doc/api/app/app.php?chapter=8_1

  1. 下载并运行demo
    其实把demo看明白了,直接运用到自己的app里,也不是不可以的
  2. 设置项目
    在Xcode中,projectName-->Info-->URL Types 添加appid。设置之后才能实现应用间跳转


    urltypes.png

导入sdk

sdk.png

如果使用了pod,直接在Podfile中添加pod 'WechatOpenSDK' 然后执行 pod update即可。如果没有使用pod,在添加了sdk文件包之后,需要在pojectName-->General-->Linked Frameworks and Libraries 中添加相应内容

libs.png
  1. 代码
  • AppDelegate.m
    didFinishLaunchingWithOptions方法中
    [WXApi registerApp:@"wx000999888777"];//注册appid
    openUrl、handleOpenURL方法
- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url {
    return  [WXApi handleOpenURL:url delegate:[PaymentManager sharedManager]];
}

- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {
    return [WXApi handleOpenURL:url delegate:[PaymentManager sharedManager]];
}
// NOTE: 9.0以后使用新API接口
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<NSString*, id> *)options
{
    return [WXApi handleOpenURL:url delegate:[PaymentManager sharedManager]];
}

如果之前项目中使用了友盟等第三方框架,直接并排写就可以:

- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url{
    [WXApi handleOpenURL:url delegate:[PaymentAction sharedPayment]];
    [UMSocialSnsService handleOpenURL:url];
    return YES;
}

另外,这个地方的delegate也可以直接设置成nil,表示用当前AppDelegate作为微信支付的代理,这样一来支付回调写在AppDelegate.m中即可。
但不推荐这种做法,我是设置了PaymentManager作为代理,这是项目中专门管理支付的一个类,包括之前的支付宝支付。这也是微信demo中的做法。(支付宝是用block获取回调的,个人感觉代码更紧凑,不容易乱;微信是用的代理,刚开始看晕乎乎的)

  • PaymentManager
    首先是遵守协议WXApiDelegate
    然后在PayVC中通过接口获取支付信息
    然后调起微信客户端:
- (void)weiXinPayWithDic:(NSDictionary *)wechatPayDic {
    PayReq *req = [[PayReq alloc] init];
    req.openID = [wechatPayDic objectForKey:@"appId"];
    req.partnerId = [wechatPayDic objectForKey:@"partnerId"];
    req.prepayId = [wechatPayDic objectForKey:@"prepayId"];
    req.package = [wechatPayDic objectForKey:@"packages"];
    req.nonceStr = [wechatPayDic objectForKey:@"nonceStr"];
    req.timeStamp = [[wechatPayDic objectForKey:@"timesTamp"] intValue];
    req.sign = [wechatPayDic objectForKey:@"sign"];
    [WXApi sendReq:req];
}

这里的数据wechatPayDic一定是server经过二次签名的

回调

// 微信支付返回结果回调
- (void)onResp:(BaseResp *)resp {
    if ([resp isKindOfClass:[PayResp class]]) {
        
        PayResp *response = (PayResp *)resp;
        if (_delegate && [_delegate respondsToSelector:@selector(managerDidRecvPaymentResponse:)]) {
            [_delegate managerDidRecvPaymentResponse:response];
        }
    }
}

当然前提是在PaymentManager.h中已经定义了代理:

@protocol WXApiManagerDelegate <NSObject>

@required
- (void)managerDidRecvPaymentResponse:(PayResp *)response;
@end

@interface PaymentManager : NSObject <WXApiDelegate>

@property (nonatomic, assign) id<WXApiManagerDelegate> delegate;

这个代理是用来处理回调结果,展示页面的,所以设置成PayVC控制器

处理回调结果
PayVC.m
遵守协议WXApiManagerDelegate
在viewDidLoad中设置[PaymentManager sharedManager].delegate = self;

- (void)managerDidRecvPaymentResponse:(PayResp *)response {
        switch (response.errCode) {
            case WXSuccess:
                [self checkWechatPayResult];
                break;
            case WXErrCodeUserCancel:
                [[HintManager shareManager] showHint:@"中途取消"];
                break;
            default:{
                [[HintManager shareManager]showHint:@"支付失败"];
            }
                
                break;
        }
}

然后在checkWechatPayResult向server查询支付结果,刷新页面
哦了~~ 泼佛客特

4. 出现的问题

当然了,并不泼佛客特

  • 系统版本大于等于iOS9的,调起微信客户端之后,可以直接点击状态栏左侧按钮返回,这时是不走回调方法的。
    这样在支付成功之后,不走回调方法,就无法知道支付状态,当前页面无法给出提示。
    解决方案是,在AppDelegate.m的applicationWillEnterForeground方法中,调用查询支付结果接口然后刷新当然页面。需要设置bool变量作为标志,否则每次应用进入前台都去查询,就不符合业务要求了。
  • 进入微信支付页面之后,不做操作,切换到自己应用中,退出当前支付页面,然后再进入微信客户端点击支付或者取消,此时自己的应用会崩溃闪退
    原因是退出页面后页面已经出栈被销毁,但wx回调时还是去调用其中的代理方法,就会出现野指针。
    解决方法是,在页面的viewWillDisappear方法中加入[PaymentManager sharedManager].delegate = nil;

5. 需要注意的点

  • 一定设置好scheme,否则应用无法跳转
  • 在调起微信支付使用的PayReq类,一定要用WXApi中自带的类,不要自己创建新类。我之前自己创建的类,定义了同样的变量,同样继承了BaseReq,然并卵,sendReq方法一直返回false
  • 调起微信支付的数据,一定是server经过二次签名的,不要把调用统一下单API获取到的数据直接返给app
  • 虽然类中的变量命名是驼峰式,但签名时的key值全部是小写的,签名时不要忘了后面加上商户key。

6. 签名

可能某些server端由于这样那样的原因不愿意做二次签名,app可以自己做。(不过因为签名需要用到secretKey,让app端做签名是有风险的)
下面是签名代码:

#import <CommonCrypto/CommonDigest.h>

// wechatDic中的数据是调用统一下单API之后返回的数据
- (void)wxpay:(NSDictionary *)wechatDic {
    time_t now;
    time(&now);
    NSString *timestamp = [NSString stringWithFormat:@"%ld",now];
    NSString *noncestr = [self md5:timestamp];
    NSDictionary *dict = @{
                           @"appid":[wechatDic objectForKey:@"appId"],
                           @"noncestr":noncestr,
                           @"package":@"Sign=WXPay",
                           @"partnerid":[wechatDic objectForKey:@"partnerId"],
                           @"prepayid":[wechatDic objectForKey:@"prepayId"],
                           @"timestamp":timestamp
                           };
    NSMutableString *contentString = [NSMutableString string];
    NSArray *keys = [dict allKeys];
    // 按照ASCII 码排序
    NSArray *sortedArray = [keys sortedArrayUsingComparator:^NSComparisonResult(id  _Nonnull obj1, id  _Nonnull obj2) {
        return [obj1 compare:obj2 options:NSNumericSearch];
    }];
    // 拼接字符串
    for (NSString *categoryId in sortedArray) {
        if (![[dict objectForKey:categoryId] isEqualToString:@""]&&![[dict objectForKey:categoryId] isEqualToString:@"key"]&&![[dict objectForKey:categoryId] isEqualToString:@"sign"]) {
            [contentString appendFormat:@"%@=%@&",categoryId,dict[categoryId]];
        }
    }
    // 添加商户key字段
    NSString *secretkey = @"1K2222ILTKCH33CQ4444SI5ZNMTM66VS";
    [contentString appendFormat:@"key=%@",secretkey];
    // 加密
    NSString *md5Sign = [self md5:contentString];
    // 支付数据
    PayReq *req = [[PayReq alloc] init];
    req.openID = [wechatDic objectForKey:@"appId"];
    req.partnerId = [wechatDic objectForKey:@"partnerId"];
    req.prepayId = [wechatDic objectForKey:@"prepayId"];
    req.package = @"Sign=WXPay";
    req.nonceStr = noncestr;
    req.timeStamp = [timestamp intValue];
    req.sign = md5Sign;
    [WXApi sendReq:req];
}

- (NSString *)md5:(NSString *)str {
    const char *cStr = [str UTF8String];
    unsigned char digest[CC_MD5_DIGEST_LENGTH];
    CC_MD5(cStr,(unsigned int)strlen(cStr),digest);
    NSMutableString *output = [NSMutableString stringWithCapacity:CC_MD5_DIGEST_LENGTH * 2];
    for (int i = 0; i < CC_MD5_DIGEST_LENGTH; i ++) {
        [output appendFormat:@"%02X",digest[i]];
    }
    return output;
}

相关文章

网友评论

  • 木槿WEIXIAO:求个demo大佬,我对delegate不感冒:cry:
  • my_杨哥:我想知道checkWechatPayResult方法里是怎么写的?
  • LV大树:谢谢啦。
    yaqiong:@LV大树 :blush:
  • chen文:PayReq类中,@"package":@"Sign=WXPay",一定为WXPay,还是使用app 的bundle ID?
    yaqiong:@chen文 这个写法是固定的
  • Arthur澪:PayReq类,一定要用WXApi中自带的类。这什么意思?
    yaqiong:@Arthur凌 直接使用这个PayReq类,不能自定义
  • S型身材的猪:delegate设置为nil并不默认是AppDelegate,必须设置为self才会回调onResp:
    yaqiong:谢谢指正
  • Look2021:给个赞👍
  • r_瑞:蛮有用的

本文标题:iOS集成微信支付

本文链接:https://www.haomeiwen.com/subject/dwhqrxtx.html