您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 教學 >> iOS 相關教學

iOS 客戶端接入微信支付的完整思路與實作拆解

編輯:iOS 相關教學

從程式碼的角度看,所謂「調起支付」其實就是把一組關鍵參數按約定格式打包成訂單,簽名之後交給支付平台。只要把參數含義與 SDK 的幾個關鍵 API 弄清楚,接入任何一家支付渠道都不算難事。本文記錄 iOS 端接入微信支付的完整過程,包含一次簽名、二次簽名,以及最容易忽略的幾個細節。

一、開始之前:讀文件、拿 SDK、配工程

第一步永遠是翻開發者文件,先掌握整體流程。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];

注意這裡全是寫死的假資料,實作時每一個欄位都要由程式動態產生。

二、官方 Sample 的可讀性問題

要搞清楚 API 怎麼用,最快的路是下載 Sample 專案讀一遍。不過官方範例的程式風格頗有 C++ 的味道,命名也不完全符合 Cocoa 慣例,讀起來需要一點耐心。它包含 ApiXml、WXUtil、payRequestHandler 等幾個檔案——其中除了 API 呼叫,還實作了 MD5 與 XML 處理等基礎設施。

實務上通常會看懂之後自行重構,收攏成自己 App 裡的一個 Manager 類。由於一般的商城場景只需要「商品名稱」與「價格」兩個參數,重構後的對外介面也可以簡化到只剩這兩項。

三、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;
        }
    }
}

七、實務上最容易翻車的幾點

  1. 不要重複匯入微信 SDK。若專案已使用 ShareSDK,其 extend 目錄內已包含微信的庫,重複加入會造成符號衝突。
  2. 簽名演算法的擺放位置。微信官方鼓勵把簽名放到伺服器,以降低被逆向的風險;但若 App 沒有後端,直接放在客戶端也能跑通,只是安全性較弱。Sample 的註解在這一點上寫得有些混亂,實際上兩種做法都可行。
  3. 金額單位是分,total_fee 必須是不帶小數的整數,這一點寫錯會直接被介面擋下。
  4. 千萬不要把「回呼成功」當成「交易成功」。客户端 onResp 只反映請求狀態,最終帳務結果一定要由後端透過 notify_url 接收異步通知,並主動向微信查單確認,這才是唯一可信的依據。
  5. 回呼收不到時先查 URL Scheme。App 必須在 Info.plist 註冊微信的 scheme,否則支付完成後跳不回來。
  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved