您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 端接入微信支付:從 PayReq 到自訂 WechatPayManager

編輯:iOS 開發綜合

App 內若要販售虛擬商品或服務,主流路線有兩條:跳支付寶,或跳微信支付。兩者的本質其實一樣——把關鍵參數打包成訂單,送到支付平台伺服器換回一組憑證,再交由平台 App 完成付款。本文記錄如何在 iOS 端把微信支付接起來,並把官方 Sample 重構為自己專案用的 Manager 類別。

先讀文件,再下載 SDK

動手前務必把微信的開發文件看完,理解整體流程。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 之類的加解密邏輯,值得讀過一遍。

重構為 WechatPayManager

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

在 Controller 中跳起支付

- (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 回傳的只是「使用者完成操作」,真正的支付結果務必以伺服器查單為準,不能拿來直接發貨。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved