刚集成完微信支付,总结总结
1. 准备
微信平台分为微信公众平台和微信开放平台,公众平台是运营微信公众号的管理系统,开放平台主要针对app、网站开发,提供登录、分享、支付等功能。
注册开放平台之后,新建应用,填写应用信息(Android、iOS等信息),创建之后需要等待审核(这个审核很快的,几个小时就通过了)。
然后是为该应用申请支付功能,要注意个人是无法申请的,具体可参考微信支付申请条件和资格。这里牵涉到一系列公司资质的审核和费用支付,需要几个工作日的时间
完成之后可以获取到appid(微信开放平台为应用生成的唯一识别码)、商户id、商户secretKey。对于app端来说只用到appid,商户id最好通过接口从server获取,商户secretKey是用来签名的,一般只有server能用到。
2. 支付流程
先上一个开放平台给出的流程图:
这个图很实用很详细很清晰,但一开始看可能会觉得复杂。其实对开发者来说,比较关心的流程是:
- app向server发起支付请求
- server收到请求后向微信后台调用统一下单API,获得预付单信息
- server生成带签名的客户端支付信息并返回给app
- 用户确认支付,app调起微信客户端进行支付
- 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
- 下载并运行demo
其实把demo看明白了,直接运用到自己的app里,也不是不可以的 -
设置项目
在Xcode中,projectName-->Info-->URL Types 添加appid。设置之后才能实现应用间跳转
导入sdk
如果使用了pod,直接在Podfile中添加pod 'WechatOpenSDK' 然后执行 pod update即可。如果没有使用pod,在添加了sdk文件包之后,需要在pojectName-->General-->Linked Frameworks and Libraries 中添加相应内容
- 代码
- 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;
}