從程式碼的角度看,所謂「調起支付」其實就是把一組關鍵參數按約定格式打包成訂單,簽名之後交給支付平台。只要把參數含義與 SDK 的幾個關鍵 API 弄清楚,接入任何一家支付渠道都不算難事。本文記錄 iOS 端接入微信支付的完整過程,包含一次簽名、二次簽名,以及最容易忽略的幾個細節。
第一步永遠是翻開發者文件,先掌握整體流程。SDK 本身很輕,就是一個靜態庫加兩個頭文件;下載後匯入工程並依文件完成 URL Scheme、白名單等配置即可,這部分各家文件都寫得很清楚,此處不再重複。
文件裡最核心的一段範例大致如下:
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];
注意這裡全是寫死的假資料,實作時每一個欄位都要由程式動態產生。
要搞清楚 API 怎麼用,最快的路是下載 Sample 專案讀一遍。不過官方範例的程式風格頗有 C++ 的味道,命名也不完全符合 Cocoa 慣例,讀起來需要一點耐心。它包含 ApiXml、WXUtil、payRequestHandler 等幾個檔案——其中除了 API 呼叫,還實作了 MD5 與 XML 處理等基礎設施。
實務上通常會看懂之後自行重構,收攏成自己 App 裡的一個 Manager 類。由於一般的商城場景只需要「商品名稱」與「價格」兩個參數,重構後的對外介面也可以簡化到只剩這兩項。
ApiXml 與 WXUtil 可以原封不動沿用,我們只包裝支付流程:
#import "WXUtil.h"
#import "ApiXml.h"
#import "WXApi.h"
// 帳戶與商戶參數,替換成自己的即可測試
#define APP_ID @"wx@@@@@@@@@@@@@@@@"
#define MCH_ID @"@@@@@@@@@@@"
#define PARTNER_ID @"12345678901234567890123456789012"
#define NOTIFY_URL @"https://wxpay.weixin.qq.com/pub_v2/pay/notify.v2.php"
#define SP_URL @"https://wxpay.weixin.qq.com/pub_v2/app/app_pay.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;
// 取得預支付訂單資訊,核心產物是一個 prepayId
- (NSMutableDictionary *)getPrepayWithOrderName:(NSString *)name
price:(NSString *)price
device:(NSString *)device;
@end
微信的簽名規則是:把參數按 key 的字母序排序、組成形如 k1=v1&k2=v2&...&key=商戶金鑰 的字串,再取 MD5。下面的 createMd5Sign: 就是這個規則的直接翻譯:
- (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) {
if (![[dict objectForKey:key] isEqualToString:@""] &&
![key isEqualToString:@"sign"] &&
![key isEqualToString:@"key"]) {
[contentString appendFormat:@"%@=%@&", key, [dict objectForKey:key]];
}
}
[contentString appendFormat:@"key=%@", self.spKey];
return [WXUtil md5:contentString];
}
// 組出送給微信介面的 XML
- (NSString *)genPackage:(NSMutableDictionary *)packageParams {
NSString *sign = [self createMd5Sign:packageParams];
NSMutableString *reqPars = [NSMutableString string];
[reqPars appendString:@"<xml>"];
for (NSString *key in [packageParams allKeys]) {
[reqPars appendFormat:@"<%@>%@</%@>", key, [packageParams objectForKey:key], key];
}
[reqPars appendFormat:@"<sign>%@</sign></xml>", sign];
return reqPars;
}
接著 POST 這段 XML 到 unifiedorder 介面,解析回傳的 XML,驗證回傳簽名,取出 prepay_id。這一步完成的是第一次簽名:
- (NSMutableDictionary *)getPrepayWithOrderName:(NSString *)name
price:(NSString *)price
device:(NSString *)device {
NSString *orderName = name; // 訂單標題,展示給使用者
NSString *orderPrice = price; // 金額,單位是分
NSString *orderDevice = device;
NSString *orderType = @"APP"; // 支付類型固定為 APP
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"];
[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"];
[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"];
[packageParams setObject:orderPrice forKey:@"total_fee"];
NSString *prePayid = [self sendPrepay:packageParams];
if (prePayid == nil) { return nil; }
// 拿到 prepayid 後進行第二次簽名
time_t now; time(&now);
NSString *time_stamp = [NSString stringWithFormat:@"%ld", now];
NSString *nonce_str = [WXUtil md5:time_stamp];
NSString *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"];
[signParams setObject:[self createMd5Sign:signParams] forKey:@"sign"];
return signParams;
}
需要留意的是:第二次簽名用的是同一套 createMd5Sign: 邏輯,只是參數集合換成 appid、partnerid、noncestr、package、timestamp、prepayid 這六項。兩次簽名混在一起是初學者最常搞錯的地方。
- (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];
req.openID = [dict objectForKey:@"appid"];
req.partnerId = [dict objectForKey:@"partnerid"];
req.prepayId = [dict objectForKey:@"prepayid"];
req.nonceStr = [dict objectForKey:@"noncestr"];
req.timeStamp = [[dict objectForKey:@"timestamp"] intValue];
req.package = [dict objectForKey:@"package"];
req.sign = [dict objectForKey:@"sign"];
[WXApi safeSendReq:req];
}
支付完成後由 AppDelegate 接收回呼。通常直接把這兩個 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;
}
}
}