從代碼角度看,調起支付 APP 的本質,就是把一批關鍵參數按約定方式打包成訂單,再發送到支付平台。只要弄清楚參數如何設置、每個支付平台 SDK 中關鍵 API 的用法,接入支付其實並不複雜。本文記錄在 iOS 客戶端接入微信支付的完整思路與實作。
先仔細閱讀微信 SDK 開發文檔,了解整體支付流程,再依提示下載 SDK(本質上就是一個鏈接庫加兩個頭文件),導入工程並完成配置。從文檔可以看到,調起微信支付最核心的就是構造一個 PayReq 對象並發送:
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 代碼中包含了 ApiXml、WXUtil、payRequestHandler 等文件,除了 API 調用外還實現了 MD5 等算法。看懂之後,通常會把它重構為自己 APP 中的一個 Manager 類。由於 APP 售賣商品時,關鍵參數主要就是「商品名稱」與「價格」,因此可以把整個流程封裝成只接收這兩個參數的方法。
以下為重構後的 WechatPayManager 頭文件:
#import <Foundation/Foundation.h> #import "WXUtil.h" #import "ApiXml.h" #import "WXApi.h" #define APP_ID @"wx@@@@@@@@@@@@@@@@" // 微信分配的 APPID #define MCH_ID @"@@@@@@@@@@@" // 商戶號 #define PARTNER_ID @"12345678901234567890123456789012" // 商戶 API 密鑰 #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; // 獲取預支付訂單信息,核心是一個 prepayID - (NSMutableDictionary *)getPrepayWithOrderName:(NSString *)name price:(NSString *)price device:(NSString *)device; @end
實現文件的核心邏輯分為三步:第一步簽名(把參數按字母序拼接後做 MD5,向微信統一下單接口提交並取回 prepay_id)、第二步簽名(用 prepay_id 等參數再次組包簽名,供客戶端調起支付使用)。以下為關鍵方法:
// 生成 MD5 簽名:參數按字母序排序拼接,末尾加上 key 字段
- (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];
return [WXUtil md5:contentString];
}
// 獲取預支付訂單,返回調起支付所需的完整簽名參數
- (NSMutableDictionary *)getPrepayWithOrderName:(NSString *)name price:(NSString *)price device:(NSString *)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:device forKey:@"device_info"];
[packageParams setObject:noncestr forKey:@"nonce_str"];
[packageParams setObject:orderType forKey:@"trade_type"];
[packageParams setObject:name 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:price forKey:@"total_fee"]; // 金額,單位為「分」
// 第一次簽名並提交,取回 prepay_id
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];
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"];
NSString *sign = [self createMd5Sign:signParams];
[signParams setObject:sign forKey:@"sign"];
return signParams;
}
在需要調用微信支付的 Controller 中新增方法,利用 WechatPayManager 完成初始化與參數封裝,再構造 PayReq 發送:
- (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]; // 失敗時可讀取調試信息
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"];
[WXApi safeSendReq:req];
}
支付完成後微信會回調 delegate,通常直接放在 AppDelegate 中,方便個性化展示結果:
- (void)onResp:(BaseResp *)resp {
if ([resp isKindOfClass:[PayResp class]]) {
switch (resp.errCode) {
case 0: /* 支付成功 */ break;
case -1: /* 支付失敗 */ break;
case -2: /* 用戶取消支付 */ break;
default: /* 其他錯誤,可讀取 resp.errStr */ break;
}
}
}