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

iOS 接入微信支付的完整流程與踩坑清單

編輯:iOS 開發綜合

微信支付看起來步驟繁多,其實理解了角色分工就一點都不難。整件事跟我們平時用手機買東西完全一樣。

十步流程拆解

1. 使用者在 App 選好商品下單。
2. 商戶客戶端把商品資料傳給商戶伺服器,請求產生支付訂單。
3. 商戶後台呼叫「統一下單 API」向微信伺服器發請求,微信產生預支付單並回傳 prepay_id。
4. 商戶後台把 prepay_id 回傳給客戶端。
5. 使用者按下確認支付,客戶端呼叫 SDK 拉起微信。
6. 微信客戶端向微信伺服器發起支付(雙方靠 prepay_id 對帳,伺服器會驗證參數是否與第三步產生的一致)。
7. 使用者輸入密碼,微信客戶端提交授權,完成支付。
8. 微信伺服器給客戶端顯示結果,並非同步把結果通知商戶伺服器。
9. 商戶客戶端透過「支付結果查詢介面」再向後台確認一次。
10. 顯示結果、完成訂單、發貨。

看起來多,但客戶端真正要做的只有兩件事:拉起微信發起支付、顯示支付結果。所有簽名與下單都該在後台完成。

一、下載並導入 SDK

把 SDK 包的頭文件與庫拉進專案(示例中用的是 1.6.2),然後在 Target → Build Phases → Link Binary With Libraries 點 + 號補上依賴的系統庫:

SystemConfiguration.framework
libz.tbd
libsqlite3.0.tbd
CoreTelephony.framework
QuartzCore.framework

二、設定 URL Scheme 並在 AppDelegate 註冊

在微信平台註冊 App 時會拿到唯一的 AppID,需要填進 URL Types 的 URL Schemes。

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // 向微信終端注冊 ID,建議寫成宏以便維護
    [WXApi registerApp:@"wxd930ea5d5a258f4f" withDescription:@"測試demo"];
    return YES;
}

三、接收微信回跳與處理支付結果

// iOS 9 之前的方法,為適配低版本保留
- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url {
    return [WXApi handleOpenURL:url delegate:self];
}

- (BOOL)application:(UIApplication *)application
            openURL:(NSURL *)url
  sourceApplication:(NSString *)sourceApplication
         annotation:(id)annotation {
    return [WXApi handleOpenURL:url delegate:self];
}

// iOS 9 之後的方法
- (BOOL)application:(UIApplication *)app
            openURL:(NSURL *)url
            options:(NSDictionary<NSString *, id> *)options {
    return [WXApi handleOpenURL:url delegate:self];
}

// 微信 SDK 的回呼方法,用來顯示支付結果
- (void)onResp:(BaseResp *)resp {
    NSString *payResoult = [NSString stringWithFormat:@"errcode:%d", resp.errCode];
    if ([resp isKindOfClass:[PayResp class]]) {
        // 支付返回結果,實際結果仍需到微信伺服器端查詢
        switch (resp.errCode) {
            case 0:
                payResoult = @"支付結果:成功!";
                break;
            case -1:
                payResoult = @"支付結果:失敗!";
                break;
            case -2:
                payResoult = @"用戶已經退出支付!";
                break;
            default:
                payResoult = [NSString stringWithFormat:@"支付結果:失敗!retcode = %d, retstr = %@",
                              resp.errCode, resp.errStr];
                break;
        }
    }
    NSLog(@"%@", payResoult);
}

要留意的是,早期用 Xcode 7.2 時若沒寫 iOS 9 之前的舊方法,會出現 onResp 回呼進不來的情形,這也是官方範例仍保留那兩個已棄用方法的原因。

四、核心:調起支付

調起之前必須先完成下單與簽名,取得六個參數:appid、partnerid、prepayid、noncestr、timestamp、sign。這些全部由後台算好傳給你——放在前端等於把鑰匙插在門上。

#pragma mark 微信支付方法
- (void)WXPay {
    PayReq *req = [[PayReq alloc] init];

    // 由用戶微信號和 AppID 組成的唯一標識
    req.openID = @"";

    // 商戶 id
    req.partnerId = @"";

    // 預支付訂單,由後台與微信伺服器交互後取得
    req.prepayId = @"";

    // 固定值
    req.package = @"Sign=WXPay";

    // 隨機串,後台產生,防止重複
    req.nonceStr = @"";

    // 時間戳,後台產生
    NSString *stamp = @"";
    req.timeStamp = stamp.intValue;

    // 簽名,後台計算
    req.sign = @"";

    // 發送請求到微信,等待微信返回 onResp
    [WXApi sendReq:req];
}

後台丟過來的 JSON 長這樣:

{
    "appid": "wxb4ba3c02aa476ea1",
    "noncestr": "d1e6ecd5993ad2d06a9f50da607c971c",
    "package": "Sign=WXPay",
    "partnerid": "10000100",
    "prepayid": "wx20160218122935e3753eda1f0066087993",
    "timestamp": "1455769775",
    "sign": "F6DEE4ADD82217782919A1696500AF06"
}

這些欄位怎麼算,後台照微信的「統一下單 API」與「調起支付 API」文件實作即可。

五、常見問題清單

1. 支付完卡在微信跳不回來
檢查 URL Types 裡的 Scheme 是否與 AppID 完全一致。

2. 能拉起微信,但畫面只有一個白色「確定」鈕
幾乎都是 prepayid 的問題——過期了,或根本不是有效的 id。客戶端程式碼通常沒錯。另外特別注意:微信需要兩次簽名,下單一次、調起支付再一次。

3. 出現無法調起微信、或一閃而過等怪象
若專案已用友盟或 ShareSDK 做分享,那些 SDK 內部多半已經包了微信 SDK,重複引入會衝突。先把重複的部分去掉再試。

4. 金額單位是分
不是元。這個坑掉過一次就記一輩子。

整套流程裡最重要的是順序與責任邊界:簽名與下單在後台,客戶端只負責拉起與展示。把這條線畫清楚,剩下的都是細節。

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