要在 iOS App 裡賣虛擬商品,最常見的兩條路是跳支付寶或跳微信。從程式碼角度看,兩者都是同一件事:把關鍵參數組成一張訂單,送到平台伺服器換回支付憑證,再交給平台 App 完成付款。本篇把微信支付的接法從頭到尾記錄下來。
第一步是把官方 SDK 讀懂、下載、匯入並完成專案設定。SDK 內容很精簡:一個靜態庫加兩個標頭檔。官方文件網址:
https://pay.weixin.qq.com/wiki/doc/api/app.php?chapter=8_5
從文件看,跳起微信支付真正必要的就這一段:
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 的命名偏 C++ 風格,不符合 Objective-C 的駝峰慣例。我把它重構成 WechatPayManager,並把對外接口簡化成「商品名稱 + 價格」兩個參數。ApiXml 與 WXUtil 保持原樣不動。
#import <Foundation/Foundation.h>
#import "WXUtil.h"
#import "ApiXml.h"
#import "WXApi.h"
#define APP_ID @"wx427a2f57bc4456d1"
#define APP_SECRET @""
#define MCH_ID @"1242316102"
#define PARTNER_ID @"12345678901234567890123456789020"
#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;
- (NSMutableDictionary *)getPrepayWithOrderName:(NSString *)name
price:(NSString *)price
device:(NSString *)device;
@end
整個流程可以拆成三段:組包 → 第一次簽名換 prepay_id → 第二次簽名產生 PayReq 用的 sign。
#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;
self.mchId = mchID;
self.spKey = key;
}
return self;
}
- (NSString *)getDebugInfo {
NSString *res = [NSString stringWithString:self.debugInfo];
[self.debugInfo setString:@""];
return res;
}
// 依字母序拼接並做 MD5
- (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]];
}
}
[contentString appendFormat:@"key=%@", self.spKey];
NSString *md5Sign = [WXUtil md5:contentString];
[self.debugInfo appendFormat:@"MD5 簽名字串:\n%@\n\n", contentString];
return md5Sign;
}
// 組出 XML 格式的 package
- (NSString *)genPackage:(NSMutableDictionary *)packageParams {
NSString *sign = [self createMd5Sign:packageParams];
NSMutableString *reqPars = [NSMutableString string];
[reqPars appendString:@"<xml>\n"];
for (NSString *categoryId in [packageParams allKeys]) {
[reqPars appendFormat:@"<%@>%@<!--%@-->\n", categoryId,
[packageParams objectForKey:categoryId], categoryId];
}
[reqPars appendFormat:@"<sign>%@</sign>\n</xml>", sign];
return [NSString stringWithString:reqPars];
}
// 送出預支付請求
- (NSString *)sendPrepay:(NSMutableDictionary *)prePayParams {
NSString *prepayid = nil;
NSString *send = [self genPackage:prePayParams];
[self.debugInfo appendFormat:@"API 鏈接:%@\n", self.payUrl];
[self.debugInfo appendFormat:@"發送的 xml:%@\n", send];
NSData *res = [WXUtil httpSend:self.payUrl method:@"POST" data:send];
[self.debugInfo appendFormat:@"伺服器返回:\n%@\n\n",
[[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"];
[self.debugInfo appendFormat:@"取得預支付交易標識成功!\n"];
}
} else {
self.lastErrCode = 1;
[self.debugInfo appendFormat:@"gen_sign=%@\n_sign=%@\n", sign, send_sign];
[self.debugInfo appendFormat:@"伺服器返回簽名驗證錯誤!!!\n"];
}
} else {
self.lastErrCode = 2;
[self.debugInfo appendFormat:@"接口返回錯誤!!!\n"];
}
return prepayid;
}
- (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[@"appid"] = self.appId;
packageParams[@"mch_id"] = self.mchId;
packageParams[@"device_info"] = orderDevice;
packageParams[@"nonce_str"] = noncestr;
packageParams[@"trade_type"] = orderType;
packageParams[@"body"] = orderName;
packageParams[@"notify_url"] = NOTIFY_URL;
packageParams[@"out_trade_no"] = orderNO;
packageParams[@"spbill_create_ip"] = orderIP;
packageParams[@"total_fee"] = orderPrice;
NSString *prePayid = [self sendPrepay:packageParams];
if (prePayid == nil) {
[self.debugInfo appendFormat:@"取得 prepayid 失敗!\n"];
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;
[self.debugInfo appendFormat:@"第二步簽名成功,sign=%@\n", sign];
return signParams;
}
@end
- (void)wxPayWithOrderName:(NSString *)name price:(NSString *)price {
WechatPayManager *wxpayManager =
[[[WechatPayManager alloc] initWithAppID:APP_ID mchID:MCH_ID spKey:PARTNER_ID] autorelease];
NSString *device = [[UserManager defaultManager] userId];
NSMutableDictionary *dict = [wxpayManager getPrepayWithOrderName:name price:price device:device];
if (dict == nil) {
NSString *debug = [wxpayManager getDebugInfo];
NSLog(@"%@", debug);
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 safeSendReq:req];
}
把 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)若 App 已整合 ShareSDK,不要重複匯入微信 SDK,ShareSDK 的 extend 已內含。
2)微信建議把簽名演算法放到伺服器端較安全;若沒有後端,放客戶端也能正常運作。
3)total_fee 的單位是「分」,別寫成元。
4)客户端收到的 errCode 只代表使用者操作結果,發貨前一定要走伺服器查單。