微信支付看起來步驟繁多,其實理解了角色分工就一點都不難。整件事跟我們平時用手機買東西完全一樣。
1. 使用者在 App 選好商品下單。
2. 商戶客戶端把商品資料傳給商戶伺服器,請求產生支付訂單。
3. 商戶後台呼叫「統一下單 API」向微信伺服器發請求,微信產生預支付單並回傳 prepay_id。
4. 商戶後台把 prepay_id 回傳給客戶端。
5. 使用者按下確認支付,客戶端呼叫 SDK 拉起微信。
6. 微信客戶端向微信伺服器發起支付(雙方靠 prepay_id 對帳,伺服器會驗證參數是否與第三步產生的一致)。
7. 使用者輸入密碼,微信客戶端提交授權,完成支付。
8. 微信伺服器給客戶端顯示結果,並非同步把結果通知商戶伺服器。
9. 商戶客戶端透過「支付結果查詢介面」再向後台確認一次。
10. 顯示結果、完成訂單、發貨。
看起來多,但客戶端真正要做的只有兩件事:拉起微信發起支付、顯示支付結果。所有簽名與下單都該在後台完成。

把 SDK 包的頭文件與庫拉進專案(示例中用的是 1.6.2),然後在 Target → Build Phases → Link Binary With Libraries 點 + 號補上依賴的系統庫:
SystemConfiguration.framework libz.tbd libsqlite3.0.tbd CoreTelephony.framework QuartzCore.framework
在微信平台註冊 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. 金額單位是分
不是元。這個坑掉過一次就記一輩子。
整套流程裡最重要的是順序與責任邊界:簽名與下單在後台,客戶端只負責拉起與展示。把這條線畫清楚,剩下的都是細節。