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

iOS 客戶端接入微信支付的完整實踐

編輯:iOS 開發綜合

從代碼角度看,調起支付 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 並重構為 Manager

微信官方 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;
        }
    }
}

五、實踐中容易踩的坑

  1. 避免重複導入 SDK:若 APP 已使用 ShareSDK,其 extend 已內含微信 SDK,不要重複引入。
  2. 簽名算法的位置:微信官方鼓勵把簽名放在服務器端以防破解;但若 APP 沒有服務器端,也可以直接放在客戶端。
  3. 金額單位是分:total_fee 以「分」為單位,傳參時務必注意換算。
  4. 實際支付結果需二次查詢:客戶端回調只代表支付流程狀態,真正的支付結果應以微信服務器端查詢為準。
  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved