版本记录
版本号 | 时间 |
---|---|
V1.0 | 2017.05.23 |
前言
很多app都有支付和提现功能,而移动支付中支付宝、微信无疑是国内重要的支付平台和工具,最近有一个项目需要增加微信支付功能,很久没有集成了,所以最近又重新集成并整理了下,希望对大家有所帮助。
详情
微信支付原理
微信支付的原理官方开发文档写的很清楚,这里我也给大家整理出来了。先看下面这个原理图。
这个图有点小,有点看不清楚,我给大家贴出链接地址。具体步骤如下:
- 用户在商户APP中选择商品,提交订单,选择微信支付。
- 商户后台收到用户支付单,调用微信支付统一下单接口。参见统一下单API。
- 统一下单接口返回正常的prepay_id,再按签名规范重新生成签名后,将数据传输给APP。参与签名的字段名为appId,partnerId,prepayId,nonceStr,timeStamp,package。注意:package的值格式为Sign=WXPay。
- 商户APP调起微信支付。api参见本章节app端开发步骤说明。
- 商户后台接收支付通知。api参见支付结果通知API。
- 商户后台查询支付结果。,api参见查询订单API。
微信支付SDK介绍
微信支付的SDK可以从开发者平台上下载,如下图所示。具体可以参考微信支付APP开发文档
这里面用的较多的是APP支付和API列表。
这里可以下载SDK资源
下载好的微信SDK包含了一个SDK包还有一个Demo,这里的demo将支付的验证功能都放在客户端做,但是微信平台建议还是尽量放在自己的服务端去做。
我们看一下微信SDK。
微信支付的SDK比较简洁,就这三个文件,集成也比较简单。
微信集成和实现支付步骤
一、 签约商户和平台注册
1. 商户签约申请流程图
先看一下商户的签约流程,如下图所示:
2. 申请接入步骤
到微信开发平台添加移动应用
微信目前仅对已经通过认证的开发者创建的移动应用开放申请,需要先登录微信开发平台,添加移动应用,等待审核。
申请支付功能,提交相关资料
审核通过后,可在管理中心--移动应用,为通过审核的移动应用申请支付功能。
1)填写资料:根据页面提示,分别填写应用基本资料、企业审核资料和财务审核资料。
每一步填写所需的材料均会在填写前给予相应提示,您可提前进行准备,以加快填写和审批速度。
2)等待审核:微信团队会在7个工作日给出审核结果,结果会发送到开放平台通知中心和邮箱中;通知中心:(登录后页面右上角)。通过审核后,商户将收到邮件通知,邮件中包含商户号和登录密码,请牢记申请时填写的邮箱地址。
验证结算账户,在线签署协议
1)验证账户,签署协议:
微信支付会向申请时提交的结算账户汇入一笔金额随机的验证款,登陆商户平台回填验证款,并签署在线协议,开启结算功能。
2)开始开发工作:
开发文档:微信支付App支付开发文档
二、客户端集成
下面说明一下微信支付的客户端集成,如下所示。
1. 项目设置APPID
2. 注册APPID
商户APP工程中引入微信lib库和头文件,调用API前,需要先向微信注册您的APPID,代码如下:
[WXApi registerApp:@"wxd930ea5d5a258f4f" withDescription:@"demo 2.0"];
3. 调起支付
向自己的服务器发送请求,请求的数据包含prepare_id等参数,生成预支付订单,然后将参数传输给微信APP发起支付请求。具体配置代码如下:
PayReq *request = [[[PayReq alloc] init] autorelease];
request.partnerId = @"10000100";
request.prepayId= @"1101000000140415649af9fc314aa427";
request.package = @"Sign=WXPay";
request.nonceStr= @"a462b76e7436e98e0ed6e13c64b4fd1c";
request.timeStamp= @"1397527777";
request.sign= @"582282D72DD2B03AD892830965F428CB16E7A256";
[WXApi sendReq:request];
4. 支付结果回调
支付完成后,微信APP会返回到商户APP并回调onResp函数,开发者需要在该函数中接收通知,判断返回错误码,如果支付成功则去后台查询支付结果再展示用户实际支付结果。注意 一定不能以客户端返回作为用户支付的结果,应以服务器端的接收的支付通知或查询API返回的结果为准。代码示例如下:
-(void)onResp:(BaseResp*)resp{
if ([respisKindOfClass:[PayRespclass]]){
PayResp*response=(PayResp*)resp;
switch(response.errCode){
caseWXSuccess:
//服务器端查询支付通知或查询API返回的结果再提示成功
NSlog(@"支付成功");
break;
default:
NSlog(@"支付失败,retcode=%d",resp.errCode);
break;
}
}
}
三、微信支付实例代码
下面详细的说一下微信支付集成的代码。
1. AppDelegate.m中的代码
#import "WXApi.h"
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
//注册微信支付
[WXApi registerApp:kZBCommonShareSDKWeChatAppKey];
return YES;
}
//微信支付 9.0前的方法,为了适配低版本 保留
- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url
{
return [WXApi handleOpenURL:url delegate:self];
}
//微信支付 9.0后的方法
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<NSString *,id> *)options
{
//这里判断是否发起的请求为微信支付,如果是的话,用WXApi的方法调起微信客户端的支付页面(://pay 之前的那串字符串就是你的APPID,)
return [WXApi handleOpenURL:url delegate:self];
}
//微信支付 如果第三方程序向微信发送了sendReq的请求,那么onResp会被回调。sendReq请求调用后,会切到微信终端程序界面。
- (void)onResp:(BaseResp *)resp
{
if ([resp isKindOfClass:[PayResp class]]) {
PayResp *response = (PayResp *)resp;
switch (response.errCode) {
case WXSuccess:
NSLog(@"支付成功,向后台发送消息");
break;
case WXErrCodeCommon:
NSLog(@"签名错误、未注册APPID、项目设置APPID不正确、注册的APPID与设置的不匹配、其他异常等");
break;
case WXErrCodeUserCancel:
NSLog(@"用户点击取消并返回");
break;
case WXErrCodeSentFail:
NSLog(@"发送失败");
break;
case WXErrCodeUnsupport:
NSLog(@"微信不支持");
break;
case WXErrCodeAuthDeny:
NSLog(@"授权失败");
break;
default:
break;
}
//根据返回结果就可以在想要的控制器里面更新数据
NSDictionary *userInfoDic = @{@"info":@(response.errCode)};
[[NSNotificationCenter defaultCenter] postNotificationName:@"WXPay" object:nil userInfo:userInfoDic];
}
}
//是在这里控制器里面发起的微信支付
2. JJRechargeViewController.m中
//在确定支付按钮点击的情况下,发起支付
- (void)viewDidLoad
{
[super viewDidLoad];
//处理微信回调客户端结果的通知
if ([WXApi isWXAppInstalled]) {
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(getWechatOrderPayResult:) name:@"WXPay" object:nil];
}
}
- (void)cashChargeEnsureButtonDidClick:(ZBUIButton *)button
{
NSLog(@"开始现金充值");
//微信充值
[self requestWechatCharge];
}
- (void)requestWechatCharge
{
self.dataDictM = [NSMutableDictionary dictionary];
//向后台服务器获取签名
[self requestWechatSignedString];
}
//维信支付从后台获取签名
- (void)requestWechatSignedString
{
NSMutableDictionary *mutableDict = [NSMutableDictionary dictionary];
[mutableDict setObject:@"0" forKey:@"chargeType"];
[mutableDict setObject:self.cashNumTextField.text forKey:@"totalAmount"];
[[JJNetWorkManager manager] requestByPostNetworkWithPayUrl:kwechatPharchase parameters:mutableDict success:^(NSURLSessionDataTask * _Nonnull task, id _Nullable responseObject) {
NSLog(@"responseObject--%@",responseObject);
if ([[responseObject objectForKey:@"code"] integerValue] == 0) {
self.dataDictM = [responseObject objectForKey:@"data"];
PayReq *payRequest = [[PayReq alloc] init];
payRequest.partnerId = [self.dataDictM objectForKey:@"partnerid"];
payRequest.prepayId = [self.dataDictM objectForKey:@"prepayid"];
payRequest.package = [self.dataDictM objectForKey:@"package"];
payRequest.nonceStr = [self.dataDictM objectForKey:@"noncestr"];
payRequest.timeStamp = [[self.dataDictM objectForKey:@"timestamp"] intValue];
payRequest.sign = [self.dataDictM objectForKey:@"sign"];
NSLog(@"payRequest===%@--%@--%@--%@--%d--%@",payRequest.partnerId,payRequest.prepayId,payRequest.package,payRequest.nonceStr,payRequest.timeStamp,payRequest.sign);
//向微信客户端发起请求
BOOL isRequest = [WXApi sendReq:payRequest];
NSLog(@"isRequest--%d",isRequest);
}
} error:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
NSLog(@"error--%@",error);
}];
}
//处理通知结果,更新余额等信息
- (void)getWechatOrderPayResult:(NSNotification *)noti
{
NSLog(@"收到微信支付通知");
NSDictionary *notiDict = noti.userInfo;
int errorCode = [[notiDict objectForKey:@"info"] intValue];
switch (errorCode) {
case WXSuccess:
NSLog(@"支付成功,向后台发送消息");
CGFloat totalMoney = [self.RMBDisplayLabel.text floatValue] + [self.cashNumTextField.text floatValue];
self.RMBDisplayLabel.text = [NSString stringWithFormat:@"%.2f",totalMoney];
break;
case WXErrCodeCommon:
NSLog(@"签名错误、未注册APPID、项目设置APPID不正确、注册的APPID与设置的不匹配、其他异常等");
break;
case WXErrCodeUserCancel:
NSLog(@"用户点击取消并返回");
break;
case WXErrCodeSentFail:
NSLog(@"发送失败");
break;
case WXErrCodeUnsupport:
NSLog(@"微信不支持");
break;
case WXErrCodeAuthDeny:
NSLog(@"授权失败");
break;
default:
break;
}
}
下面给出我实例代码中的页面
参考博客和资料
后记
微信SDK的集成和使用都很简单,注意细节和流程,完成支付并不困难,后面我还会给出内购和支付宝支付集成,谢谢大家的支持。