您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 使用技巧 >> iOS 技巧大全

iOS 開發整合微信支付:完整流程、必要參數與踩坑清單

編輯:iOS 技巧大全

微信支付的整合眉角不少,但只要把流程理清楚,剩下的都是照表操課。強烈建議先看懂流程再動手寫程式。

一、先搞清楚整個支付流程

1. 使用者在 App 內選好商品、按下下單
2. App 把商品資料傳給商戶伺服器,請求建立支付訂單
3. 商戶後台呼叫微信「統一下單 API」,微信產生預支付單並回傳 prepay_id
4. 商戶後台把 prepay_id 回傳給 App
5. 使用者確認支付,App 呼叫 SDK 拉起微信
6. 微信用戶端向微信伺服器發起支付請求(雙方以 prepay_id 核對)
7. 使用者輸入密碼,完成支付授權
8. 微信伺服器向微信用戶端回傳結果,並「非同步」通知商戶伺服器
9. App 主動查詢支付結果,並向後台確認金額與狀態無誤
10. App 顯示結果、完成訂單、出貨

看起來步驟多,本質上和手機購物沒有兩樣。App 端真正要負責的只有兩件事:拉起微信完成支付、顯示支付結果。


二、整合步驟

1. 下載 SDK

建議把標頭檔與範例都下載下來讀一遍,官方範例的註解偏少,但仍是理解參數用途最直接的素材。

2. 導入 SDK 與相依函式庫

把 SDK 包內的標頭與函式庫加入專案(本文以 1.6.2 版為例),並到 Target → Build Phases → Link Binary With Libraries 補上系統相依庫:

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

3. 設定 URL Scheme

在微信開放平台註冊 App 時會拿到唯一的 AppID,必須填進 URL Schemes,微信才能正確回跳:

4. 在 AppDelegate 註冊 AppID

- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // AppID 建議寫成巨集,日後好維護
    [WXApi registerApp:@"你的AppID" withDescription:@"測試demo"];
    return YES;
}

5. 處理微信回跳與支付回呼

iOS 9 之後的 openURL:options: 為主要入口,但為了相容舊版本,建議把舊的兩個方法一併保留,否則在部分環境下會收不到 onResp 回呼:

// 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 {
    // url 中 ://pay 之前的那段字串就是 AppID
    return [WXApi handleOpenURL:url delegate:self];
}

// 微信 SDK 的回呼:支付完成返回 App 後顯示結果
- (void)onResp:(BaseResp *)resp {
    if ([resp isKindOfClass:[PayResp class]]) {
        NSString *payResult;
        switch (resp.errCode) {
            case 0:  payResult = @"支付結果:成功!"; break;
            case -1: payResult = @"支付結果:失敗!"; break;
            case -2: payResult = @"使用者已取消支付!"; break;
            default:
                payResult = [NSString stringWithFormat:@"支付結果:失敗!retcode = %d, retstr = %@",
                             resp.errCode, resp.errStr];
                break;
        }
    }
}

6. 拉起微信支付(最關鍵的一步)

支付前必須先完成下單與簽名,這些動作應該放在後台執行,避免參數在客戶端被攔截竄改。App 端只需要拿後台給的六個參數:

appid、partnerid(商戶號)、prepayid(預支付訂單)、noncestr(隨機字串)、timestamp(時間戳)、sign(簽名字串)。

- (void)WXPay {
    PayReq *req = [[PayReq alloc] init];

    req.openID    = @"";            // 微信 App 使用者與 AppID 組成的唯一識別
    req.partnerId = @"";            // 商戶號
    req.prepayId  = @"";            // 預支付訂單 ID,由後台與微信互動後取得
    req.package   = @"Sign=WXPay";  // 固定值
    req.nonceStr  = @"";            // 隨機字串,後台產生
    req.timeStamp = [@"你的時間戳" intValue];
    req.sign      = @"";            // 簽名,後台計算

    [WXApi sendReq:req];            // 送出請求,等待 onResp 回呼
}

後台回傳的 JSON 大致長這樣:

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

相關文件可參考微信的「統一下單 API」與「調起支付接口」。


三、常見問題排查

1. 支付完一直停留在微信,沒回到 App。檢查 URL Types 中的 Scheme 是否與 AppID 一致。

2. 能拉起微信,但畫面只有一個白色「確定」鈕,點了會跳回 App。這是 prepayid 的問題:過期或不是真實有效的訂單。程式碼本身通常沒錯。另外特別提醒,微信需要兩次簽名,是兩次。

3. 若專案已用友盟或 ShareSDK 做分享,就不要再重複導入微信 SDK。這類分享 SDK 多半已內含微信 SDK,重複導入會導致無法拉起微信、網頁閃退等各種怪現象。

4. 微信支付的金額單位是「分」。這點很多人被坑過,串接前務必和後台對齊單位。

若整合過程中遇到其他狀況,歡迎一起討論;本文若有錯誤之處也請不吝指正。

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