App 內若要販售虛擬商品或服務,主流路線有兩條:跳支付寶,或跳微信支付。兩者的本質其實一樣——把關鍵參數打包成訂單,送到支付平台伺服器換回一組憑證,再交由平台 App 完成付款。本文記錄如何在 iOS 端把微信支付接起來,並把官方 Sample 重構為自己專案用的 Manager 類別。
動手前務必把微信的開發文件看完,理解整體流程。SDK 本身很輕,就是一個連結庫加兩個標頭檔,匯入專案並依文件完成 build settings 設定即可。
從文件可以看到,真正「跳起微信支付」的核心就這麼幾行:
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];
文件裡這段是寫死的示例值,實作時每一個欄位都必須由程式動態產生。要搞清楚怎麼產生,就得看官方 Sample。Sample 中主要包含 ApiXml、WXUtil、payRequestHandler 等檔案,除了 API 呼叫,還實作了 MD5 之類的加解密邏輯,值得讀過一遍。
payloadRequestHandler 這個命名不太符合 Objective-C 駝峰慣例,handler 也更像 C++ 風格。我把它重構成一個 Manager,並開一個只吃「商品名稱、價格」兩個參數的方法,讓 App 端呼叫起來乾淨俐落。ApiXml 與 WXUtil 兩個檔案維持不動。
#import <Foundation/Foundation.h>
#import "WXUtil.h"
#import "ApiXml.h"
#import "WXApi.h"
#define APP_ID @"wxXXXXXXXXXXXXXXXX"
#define MCH_ID @"XXXXXXXXXXXX"
#define PARTNER_ID @"XXXXXXXXXXXXXXXXXXXXXXXXXXXX"
#define NOTIFY_URL @"https://wxpay.weixin.qq.com/pub_v2/pay/notify.v2.php"
@interface WechatPayManager : NSObject
@property (nonatomic, strong) NSString *payUrl; // 預支付網關
@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;
- (NSString *)getDebugInfo;
- (NSMutableDictionary *)getPrepayWithOrderName:(NSString *)name
price:(NSString *)price
device:(NSString *)device;
@end
整個流程其實是兩次簽名。第一次把下單參數按字母排序、去掉空值與 sign,加上 key 後做 MD5,換回 prepay_id;第二次用 appid、partnerid、noncestr、package、timestamp、prepayid 再簽一次,才是 PayReq 真正需要的 sign。
- (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 *key in sortedArray) {
id value = dict[key];
if (![value isEqualToString:@""] && ![key isEqualToString:@"sign"]) {
[contentString appendFormat:@"%@=%@&", key, value];
}
}
[contentString appendFormat:@"key=%@", self.spKey];
NSString *md5Sign = [WXUtil md5:contentString];
[self.debugInfo appendFormat:@"MD5 簽名字串:\n%@\n", contentString];
return md5Sign;
}
- (NSMutableDictionary *)getPrepayWithOrderName:(NSString *)name
price:(NSString *)price
device:(NSString *)device {
srand((unsigned)time(0));
NSString *noncestr = [NSString stringWithFormat:@"%d", rand()];
NSString *orderNO = [NSString stringWithFormat:@"%ld", time(0)];
NSMutableDictionary *packageParams = [NSMutableDictionary dictionary];
packageParams[@"appid"] = self.appId;
packageParams[@"mch_id"] = self.mchId;
packageParams[@"device_info"] = device;
packageParams[@"nonce_str"] = noncestr;
packageParams[@"trade_type"] = @"APP";
packageParams[@"body"] = name;
packageParams[@"notify_url"] = NOTIFY_URL;
packageParams[@"out_trade_no"] = orderNO;
packageParams[@"spbill_create_ip"] = @"196.168.1.1";
packageParams[@"total_fee"] = price; // 單位:分
NSString *prePayid = [self sendPrepay:packageParams];
if (prePayid == nil) {
[self.debugInfo appendFormat:@"取得 prepayid 失敗!"];
return nil;
}
time_t now; time(&now);
NSString *time_stamp = [NSString stringWithFormat:@"%ld", now];
NSString *nonce_str = [WXUtil md5:time_stamp];
NSMutableDictionary *signParams = [NSMutableDictionary dictionary];
signParams[@"appid"] = self.appId;
signParams[@"partnerid"] = self.mchId;
signParams[@"noncestr"] = nonce_str;
signParams[@"package"] = @"Sign=WXPay";
signParams[@"timestamp"] = time_stamp;
signParams[@"prepayid"] = prePayid;
NSString *sign = [self createMd5Sign:signParams];
signParams[@"sign"] = sign;
return signParams;
}
- (void)wxPayWithOrderName:(NSString *)name price:(NSString *)price {
WechatPayManager *wxpayManager =
[[WechatPayManager alloc] initWithAppID:APP_ID mchID:MCH_ID spKey:PARTNER_ID];
NSString *device = [[UserManager defaultManager] userId];
NSMutableDictionary *dict = [wxpayManager getPrepayWithOrderName:name price:price device:device];
if (dict == nil) {
NSString *debug = [wxpayManager getDebugInfo];
NSLog(@"%@", debug);
return;
}
PayReq *req = [[[PayReq alloc] init] autorelease];
req.openID = dict[@"appid"];
req.partnerId = dict[@"partnerid"];
req.prepayId = dict[@"prepayid"];
req.nonceStr = dict[@"noncestr"];
req.timeStamp = [dict[@"timestamp"] intValue];
req.package = dict[@"package"];
req.sign = dict[@"sign"];
[WXApi sendReq:req];
}
把 onResp: 這個 delegate 放在 AppDelegate 裡最方便,因為通常還有其他回呼要一起處理,集中管理比較不容易找不到。
- (void)onResp:(BaseResp *)resp {
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;
}
}
}
1)若專案已使用 ShareSDK,不要再重複匯入微信 SDK,因為 ShareSDK 的 extend 已經內含微信。
2)微信官方建議把簽名演算法放在伺服器端以降低風險,但若 App 沒有後端,直接放在客戶端也能跑通。
3)微信的 total_fee 單位是「分」,不是元,這個最常出錯。
4)onResp 回傳的只是「使用者完成操作」,真正的支付結果務必以伺服器查單為準,不能拿來直接發貨。