IOS客户端接入微信支付

时间:2021-07-24 08:30:26

实际上,从代码的角度,调起支付APP就是把一些关键的参数通过一定方式打包成为一个订单,然后发送到支付平台的服务器。所以,只要搞清楚了参数设置,搞清楚了每个支付平台的SDK里面一些关键API的使用,基本上就可以很简单的支持支付。

今天记录一下客户端里面,如何支持微信支付。首先。我们要仔细阅读一下微信SDK的开发文档,了解一下整个支付的大概流程。

然后根据提示,把相应的SDK下载下来,所谓的SDK,也就是一个链接库和两个头文件,很简单。

下载完毕,需要把SDK导入到工程里面,并且配置一下工程。因为开发者文档已经有详细描述,这里就不再复述。

从文档看到,调起微信支付其实最核心的是一下这么一段

?
1
2
3
4
5
6
7
8
<code class="hljs" vbscript="">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];</code>

这里的范例是一段hardcode,真正使用的时候,参数都需要自行传入。

为了搞清楚如何使用API,我们可以下载Sample代码。不过,这个sample代码应该是微信的实习生写的,而且应该是一个对于C++比较熟悉,对于ObjectC比较陌生的实习生。。。代码风格可以看出很多东西哈。。所以这个sample读起来总觉得有点奇怪。当然,写出这个demo也是需要不错的水平,因为这个sample不仅仅是一些API的调用,还包括了一些算法的实现,MD5之类的。
看懂了sample之后,一般可以自己重构一下,成为自己APP里面的一个Manager类。

我是在2015 5 23下载的微信Sampel代码,里面包括有:

ApiXml.h

ApiXml.m

WXUtil.h

WXUtil.m

payRequestHandler.h

payRequestHandler.m

如果比较看重命名规范的OC程序猿,就会觉得这个payRequestHandler类非常别扭,不符合camel命名规则,而且handler这个词更偏向于c++风格。我就以这个类为原型,重构了一下,并改装成一个传参的方法,供自己的APP调用。APP里面卖商品,一般就是商品名字,价格两个关键参数。所以这个重构的方法也只是提供这两个参数的接口。
ApiXml.h && ApiXml.m && WXUtil.h && WXUtil.m不变

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
<code class="hljs" objectivec="">//
// WechatPayManager.h
//
// Created by HuangCharlie on 5/24/15.
//
//
#import <foundation foundation.h="">
#import WXUtil.h
#import ApiXml.h
#import WXApi.h
// 账号帐户资料
// 更改商户把相关参数后可测试
#define APP_ID     @wx@@@@@@@@@@@@@@@@    //APPID
#define APP_SECRET   @             //appsecret,看起来好像没用
//商户号,填写商户对应参数
#define MCH_ID     @@@@@@@@@@@
//商户API密钥,填写相应参数
#define PARTNER_ID   @12345678901234567890123456789012
//支付结果回调页面
#define NOTIFY_URL   @http://wxpay.weixin.qq.com/pub_v2/pay/notify.v2.php
//获取服务器端支付数据地址(商户自定义)(在小吉这里,签名算法直接放在APP端,故不需要自定义)
#define SP_URL     @http://wxpay.weixin.qq.com/pub_v2/app/app_pay.php
@interface WechatPayManager : NSObject
{
}
//预支付网关url地址
@property (nonatomic,strong) NSString* payUrl;
//debug信息
@property (nonatomic,strong) NSMutableString *debugInfo;
@property (nonatomic,assign) NSInteger lastErrCode;//返回的错误码
//商户关键信息
@property (nonatomic,strong) NSString *appId,*mchId,*spKey;
//初始化函数
-(id)initWithAppID:(NSString*)appID
       mchID:(NSString*)mchID
       spKey:(NSString*)key;
//获取当前的debug信息
-(NSString *) getDebugInfo;
//获取预支付订单信息(核心是一个prepayID)
- (NSMutableDictionary*)getPrepayWithOrderName:(NSString*)name
                     price:(NSString*)price
                    device:(NSString*)device;
@end
</foundation></code>
<code class="hljs" objectivec="">//
// WechatPayManager.m
//
// Created by HuangCharlie on 5/24/15.
//
//
#import WechatPayManager.h
@implementation WechatPayManager
//初始化函数
-(id)initWithAppID:(NSString*)appID mchID:(NSString*)mchID spKey:(NSString*)key
{
  self = [super init];
  if(self)
  {
    //初始化私有参数,主要是一些和商户有关的参数
    self.payUrl  = @https://api.mch.weixin.qq.com/pay/unifiedorder;
    if (self.debugInfo == nil){
      self.debugInfo = [NSMutableString string];
    }
    [self.debugInfo setString:@];
    self.appId = appID;//微信分配给商户的appID
    self.mchId = mchID;//
    self.spKey = key;//商户的密钥
  }
  return self;
}
//获取debug信息
-(NSString*) getDebugInfo
{
  NSString *res = [NSString stringWithString:self.debugInfo];
  [self.debugInfo setString:@];
  return res;
}
//创建package签名
-(NSString*) createMd5Sign:(NSMutableDictionary*)dict
{
  NSMutableString *contentString =[NSMutableString string];
  NSArray *keys = [dict allKeys];
  //按字母顺序排序
  NSArray *sortedArray = [keys sortedArrayUsingComparator:^NSComparisonResult(id obj1, id obj2) {
    return [obj1 compare:obj2 options:NSNumericSearch];
  }];
  //拼接字符串
  for (NSString *categoryId in sortedArray) {
    if (  ![[dict objectForKey:categoryId] isEqualToString:@]
      && ![categoryId isEqualToString:@sign]
      && ![categoryId isEqualToString:@key]
      )
    {
      [contentString appendFormat:@%@=%@&, categoryId, [dict objectForKey:categoryId]];
    }
  }
  //添加key字段
  [contentString appendFormat:@key=%@, self.spKey];
  //得到MD5 sign签名
  NSString *md5Sign =[WXUtil md5:contentString];
  //输出Debug Info
  [self.debugInfo appendFormat:@MD5签名字符串:
%@
,contentString];
  return md5Sign;
}
//获取package带参数的签名包
-(NSString *)genPackage:(NSMutableDictionary*)packageParams
{
  NSString *sign;
  NSMutableString *reqPars=[NSMutableString string];
  //生成签名
  sign    = [self createMd5Sign:packageParams];
  //生成xml的package
  NSArray *keys = [packageParams allKeys];
  [reqPars appendString:@<xml>
];
  for (NSString *categoryId in keys) {
    [reqPars appendFormat:@<%@>%@<!--%@-->
, categoryId, [packageParams objectForKey:categoryId],categoryId];
  }
  [reqPars appendFormat:@<sign>%@</sign>
</xml>, sign];
  return [NSString stringWithString:reqPars];
}
//提交预支付
-(NSString *)sendPrepay:(NSMutableDictionary *)prePayParams
{
  NSString *prepayid = nil;
  //获取提交支付
  NSString *send   = [self genPackage:prePayParams];
  //输出Debug Info
  [self.debugInfo appendFormat:@API链接:%@
, self.payUrl];
  [self.debugInfo appendFormat:@发送的xml:%@
, send];
  //发送请求post xml数据
  NSData *res = [WXUtil httpSend:self.payUrl method:@POST data:send];
  //输出Debug Info
  [self.debugInfo appendFormat:@服务器返回:
%@
,[[NSString alloc] initWithData:res encoding:NSUTF8StringEncoding]];
  XMLHelper *xml = [[XMLHelper alloc] autorelease];
  //开始解析
  [xml startParse:res];
  NSMutableDictionary *resParams = [xml getDict];
  //判断返回
  NSString *return_code  = [resParams objectForKey:@return_code];
  NSString *result_code  = [resParams objectForKey:@result_code];
  if ( [return_code isEqualToString:@SUCCESS] )
  {
    //生成返回数据的签名
    NSString *sign   = [self createMd5Sign:resParams ];
    NSString *send_sign =[resParams objectForKey:@sign] ;
    //验证签名正确性
    if( [sign isEqualToString:send_sign]){
      if( [result_code isEqualToString:@SUCCESS]) {
        //验证业务处理状态
        prepayid  = [resParams objectForKey:@prepay_id];
        return_code = 0;
        [self.debugInfo appendFormat:@获取预支付交易标示成功!
];
      }
    }else{
      self.lastErrCode = 1;
      [self.debugInfo appendFormat:@gen_sign=%@
  _sign=%@
,sign,send_sign];
      [self.debugInfo appendFormat:@服务器返回签名验证错误!!!
];
    }
  }else{
    self.lastErrCode = 2;
    [self.debugInfo appendFormat:@接口返回错误!!!
];
  }
  return prepayid;
}
- (NSMutableDictionary*)getPrepayWithOrderName:(NSString*)name
                     price:(NSString*)price
                    device:(NSString*)device
{
  //订单标题,展示给用户
  NSString* orderName = name;
  //订单金额,单位(分)
  NSString* orderPrice = price;//以分为单位的整数
  //支付设备号或门店号
  NSString* orderDevice = device;
  //支付类型,固定为APP
  NSString* orderType = @APP;
  //发器支付的机器ip,暂时没有发现其作用
  NSString* orderIP = @196.168.1.1;
  //随机数串
  srand( (unsigned)time(0) );
  NSString *noncestr = [NSString stringWithFormat:@%d, rand()];
  NSString *orderNO  = [NSString stringWithFormat:@%ld,time(0)];
  //================================
  //预付单参数订单设置
  //================================
  NSMutableDictionary *packageParams = [NSMutableDictionary dictionary];
  [packageParams setObject: self.appId forKey:@appid];    //开放平台appid
  [packageParams setObject: self.mchId forKey:@mch_id];   //商户号
  [packageParams setObject: orderDevice forKey:@device_info]; //支付设备号或门店号
  [packageParams setObject: noncestr   forKey:@nonce_str];  //随机串
  [packageParams setObject: orderType  forKey:@trade_type]; //支付类型,固定为APP
  [packageParams setObject: orderName  forKey:@body];    //订单描述,展示给用户
  [packageParams setObject: NOTIFY_URL forKey:@notify_url]; //支付结果异步通知
  [packageParams setObject: orderNO   forKey:@out_trade_no];//商户订单号
  [packageParams setObject: orderIP   forKey:@spbill_create_ip];//发器支付的机器ip
  [packageParams setObject: orderPrice  forKey:@total_fee];    //订单金额,单位为分
  //获取prepayId(预支付交易会话标识)
  NSString *prePayid;
  prePayid = [self sendPrepay:packageParams];
  if(prePayid == nil)
  {
    [self.debugInfo appendFormat:@获取prepayid失败!
];
    return nil;
  }
  //获取到prepayid后进行第二次签名
  NSString  *package, *time_stamp, *nonce_str;
  //设置支付参数
  time_t now;
  time(&now);
  time_stamp = [NSString stringWithFormat:@%ld, now];
  nonce_str = [WXUtil md5:time_stamp];
  //重新按提交格式组包,微信客户端暂只支持package=Sign=WXPay格式,须考虑升级后支持携带package具体参数的情况
  //package    = [NSString stringWithFormat:@Sign=%@,package];
  package     = @Sign=WXPay;
  //第二次签名参数列表
  NSMutableDictionary *signParams = [NSMutableDictionary dictionary];
  [signParams setObject: self.appId forKey:@appid];
  [signParams setObject: self.mchId forKey:@partnerid];
  [signParams setObject: nonce_str  forKey:@noncestr];
  [signParams setObject: package   forKey:@package];
  [signParams setObject: time_stamp  forKey:@timestamp];
  [signParams setObject: prePayid   forKey:@prepayid];
  //生成签名
  NSString *sign = [self createMd5Sign:signParams];
  //添加签名
  [signParams setObject: sign     forKey:@sign];
  [self.debugInfo appendFormat:@第二步签名成功,sign=%@
,sign];
  //返回参数列表
  return signParams;
}
@end</code>

然后,在需要调用微信支付的Controller里面,新建一个方法。在合适的地方调用。这个方法里面利用WechatPayManager这个类进行了初始化和参数封装,然后把上述的核心代码(PayReq那一段)

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
<code class="hljs" objectivec="">- (void)wxPayWithOrderName:(NSString*)name price:(NSString*)price
{
  //创建支付签名对象 && 初始化支付签名对象
  WechatPayManager* wxpayManager = [[[WechatPayManager alloc]initWithAppID:APP_ID mchID:MCH_ID spKey:PARTNER_ID] autorelease];
 
  //获取到实际调起微信支付的参数后,在app端调起支付
  //生成预支付订单,实际上就是把关键参数进行第一次加密。
  NSString* device = [[UserManager defaultManager]userId];
  NSMutableDictionary *dict = [wxpayManager getPrepayWithOrderName:name
                                price:price
                             device:device];
  if(dict == nil){
    //错误提示
    NSString *debug = [wxpayManager getDebugInfo];
    return;
  }
 
  NSMutableString *stamp = [dict objectForKey:@timestamp];
 
  //调起微信支付
  PayReq* req       = [[[PayReq alloc] init]autorelease];
  req.openID       = [dict objectForKey:@appid];
  req.partnerId     = [dict objectForKey:@partnerid];
  req.prepayId      = [dict objectForKey:@prepayid];
  req.nonceStr      = [dict objectForKey:@noncestr];
  req.timeStamp     = stamp.intValue;
  req.package      = [dict objectForKey:@package];
  req.sign        = [dict objectForKey:@sign];
 
//    BOOL flag = [WXApi sendReq:req];
  BOOL flag = [WXApi safeSendReq:req];
}</code>

再者,支付完成了需要调用一个delegate,这个delegate方便个性化显示支付结果。一般直接把这两个delegate放在AppDelegate就好了。因为有一些其他内容也是需要在AppDelegate里面实现,省的分开找不到。

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
<code class="hljs" objectivec="">-(void) onResp:(BaseResp*)resp
{
  //启动微信支付的response
  NSString *strMsg = [NSString stringWithFormat:@errcode:%d, resp.errCode];
  if([resp isKindOfClass:[PayResp class]]){
    //支付返回结果,实际支付结果需要去微信服务器端查询
    switch (resp.errCode) {
      case 0:
        strMsg = @支付结果:成功!;
        break;
      case -1:
        strMsg = @支付结果:失败!;
        break;
      case -2:
        strMsg = @用户已经退出支付!;
        break;
      default:
        strMsg = [NSString stringWithFormat:@支付结果:失败!retcode = %d, retstr = %@, resp.errCode,resp.errStr];
        break;
    }
  }
}</code>

注意事项:

1)如果APP里面已经使用了ShareSDK,就有一些地方要注意。不要再重复导入微信的SDK,因为shareSDK里面的extend已经包括了微信的SDK。

2)微信本身是鼓励客户APP把签名算法放到服务器上面,这样信息就不容易被破解。但是如果客户APP本身没有服务器端,或者认为不需要放到服务器端,也可以直接把签名(加密)的部分直接放在APP端。Sample代码的注释有点乱,多次提到服务器云云,但是其实可以不这么做。

3)微信的price单位是分。注意下即可。

4)暂时想不到,以后想到了再记录。。

以上是本文给大家叙述的IOS客户端接入微信支付的全部内容,希望大家喜欢。