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

iOS App 接入微信支付的完整實作筆記

編輯:iOS 開發綜合

要在 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 等演算法,讀一遍收穫不小。

重構為 Manager

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 只代表使用者操作結果,發貨前一定要走伺服器查單。

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