微信支付的整合眉角不少,但只要把流程理清楚,剩下的都是照表操課。強烈建議先看懂流程再動手寫程式。
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 端真正要負責的只有兩件事:拉起微信完成支付、顯示支付結果。
建議把標頭檔與範例都下載下來讀一遍,官方範例的註解偏少,但仍是理解參數用途最直接的素材。
把 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 Schemes,微信才能正確回跳:
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// AppID 建議寫成巨集,日後好維護
[WXApi registerApp:@"你的AppID" withDescription:@"測試demo"];
return YES;
}
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;
}
}
}
支付前必須先完成下單與簽名,這些動作應該放在後台執行,避免參數在客戶端被攔截竄改。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. 微信支付的金額單位是「分」。這點很多人被坑過,串接前務必和後台對齊單位。
若整合過程中遇到其他狀況,歡迎一起討論;本文若有錯誤之處也請不吝指正。