前陣子忙了一段時間,博客擱置了。最近這一期專案又碰上了第三方支付——支付寶。其實 iOS 8 時代就已經跑通過一次,結果換到 iOS 9 直接「不回調」,怎麼點都沒反應。既然要折騰,不如把整個接入流程從頭梳理一遍,於是有了這篇記錄。
我用的 SDK 是支付寶 2.0 標準版。下載包裡除了 Demo,還有一份《移動支付接口 SDK 2.0 標準版接入和使用規則》PDF。整體可以拆成三步:
第一步:商戶簽約與密鑰配置;
第二步:SDK 集成與 Xcode 相關配置;
第三步:參數設置與調試。
公司業務一般由公司申請企業支付寶賬號,完成簽約與各項業務申請。開發者拿到的通常就是一組賬號密碼,登入後可以看到簽約管理。注意:我們要看的是「支付寶-商家服務」,不是「支付寶-開放平台」。商家服務放的是你為公司簽約的服務配置信息,開放平台則是開發者自己用的,那裡只能看到商家服務中已配置好的內容。

進入「商戶服務 → 簽約管理 → 查看更多簽約信息」後,需要輸入支付寶支付密碼才能看到 PID 與 Key 等內容。提醒一句:支付密碼是單獨設置的,和登入密碼不一定相同,而且連續輸錯三次會被鎖定,最好提前跟相關同事確認好。
這個界面就是獲取 PID、設置密鑰的地方。按圖中標註,需要把 RSA 加密的公鑰添加進去,作為支付寶公鑰使用。
密鑰怎麼生成?在 SDK Demo 裡有個 openssl 文件夾,裡面帶了 Windows 下的密鑰生成工具。我這邊是 Mac,直接在終端敲命令就行,根目錄下會生成一組 .pem 格式的密鑰,一個私鑰一個公鑰;再用命令導出 PKCS8 格式的私鑰,內容會直接打印在終端上,複製下來存好。這樣手裡就有三樣東西:
rsa_private_key.pem;
rsa_public_key.pem;
PKCS8 編碼後的私鑰字符串。
其中 PKCS8 私鑰會作為 app 中的 privateKey 參數傳入,RSA 公鑰則是前面要粘到支付寶後台的那個。第一步完成。
文檔寫得很細,我的習慣是把 Demo 裡的那幾個文件直接拖進工程:


那個 order 類也是從 Demo 裡拷出來的。導入 SDK 之後,還需要:在 Header Search Paths 中添加頭文件路徑;引入依賴的系統庫;在 Info 的 URL Types 中增加 URL Schemes;同時做 iOS 9 適配,在 Info.plist 裡加上 LSApplicationQueriesSchemes 數組,並寫入 alipay 與 alipayshare 兩個值。
做完這些直接 run,結果編譯失敗:
Undefined symbols for architecture armv7:
"_OBJC_CLASS_$_UTDevice", referenced from: objc-class-ref in AlipaySDK
ld: symbol(s) not found for architecture armv7
clang: error: linker command failed with exit code 1 (use -v to see invocation)
折騰過程略過,結論是在「鏈接的系統庫」裡補上 CoreMotion.framework 即可通過。第二步完成。
照著 Demo 拼參數,需要這麼幾項:
partner:合作身份者 ID,以 2088 開頭,也就是前面提到的 PID。
seller:商戶的支付寶收款賬號。
privateKey:那個 PKCS8 格式的私鑰。
order.tradeNO:訂單內容編碼,最終要傳給服務端,按業務需要可能帶上訂單 ID、用戶 ID、優惠券 ID 等,支付寶回調服務端後入庫。
order.productName:產品業務名。
order.productionDescription:產品業務描述。
order.amount:金額,千萬別算錯,出問題就是大事。
order.notifyURL:支付寶異步通知服務端的地址,找服務端要。
appScheme:前面配置的 URL Schemes 字符串。
參數齊了,接著處理回調。回調要處理兩個地方:一個是調起支付時 block 形式的 callback(設備上沒裝支付寶時走這條);另一個是 AppDelegate 中的:
- (BOOL)application:(UIApplication *)application
openURL:(NSURL *)url
sourceApplication:(NSString *)sourceApplication
annotation:(id)annotation
在裡面加上:
/**
* 9000 訂單支付成功
* 8000 正在處理中
* 4000 訂單支付失敗
* 6001 用戶中途取消
* 6002 網絡連接出錯
*/
// 支付寶:極簡 SDK 不可用時會跳轉支付寶錢包支付,
// 需要把錢包的支付結果回傳給 SDK
if ([url.host isEqualToString:@"safepay"]) {
[[AlipaySDK defaultService] processAuth_V2Result:url
standbyCallback:^(NSDictionary *resultDic) {
[[NSNotificationCenter defaultCenter] postNotificationName:k_Noti_transeAlipayCallBackResault
object:resultDic];
}];
[[AlipaySDK defaultService] processOrderWithPaymentResult:url
standbyCallback:^(NSDictionary *resultDic) {
NSLog(@"result = %@", resultDic);
[[NSNotificationCenter defaultCenter] postNotificationName:k_Noti_transeAlipayCallBackResault
object:resultDic];
}];
}
// 支付寶錢包快登授權返回 authCode
if ([url.host isEqualToString:@"platformapi"]) {
[[AlipaySDK defaultService] processAuthResult:url
standbyCallback:^(NSDictionary *resultDic) {
NSLog(@"result = %@", resultDic);
[[NSNotificationCenter defaultCenter] postNotificationName:k_Noti_transeAlipayCallBackResault
object:resultDic];
}];
}
這三段判斷對應三種情況。正常情況下只有第二段會走到;第三段從 url.host 就能看出是處理登入授權的(大家都在寫,先留著);至於第一段,印象中用於 App 被殺掉後的回調,但由於我把結果統一用通知拋回發起支付的頁面,這段判斷實際意義不大。
具體頁面裡接收通知,按不同狀態碼分別處理即可。第三步到此完成。
照著流程付了款,等著華麗收場,結果一動不動——控制檯只孤零零地打出一行 retryHandleOpenURL。折騰半天,翻了不少資料,最後在簡書上找到有人踩過同一個坑。
結論很樸素:iOS 9 之後,真正可靠的是帶 options 參數的新版方法:
- (BOOL)application:(UIApplication *)app
openURL:(NSURL *)url
options:(NSDictionary *)options
把上面那段回調處理代碼在這個方法裡再抄一份,問題就解決了。iOS 9 引入了新的 openURL 回調簽名,舊方法不再被系統優先調用,這也是為什麼前面的配置全都正確卻遲遲等不到回調。
感謝朋友的關鍵提示,讓這篇記錄得以成形,也希望幫到同樣卡住的你。