移動支付幾乎是每一款商業 App 的標配,而在 iOS 端接入支付寶,很多同學第一次做會被密鑰、ATS、bitcode 這幾個關卡絆住。本文把整個流程梳理成一條清晰的線路:先做一次性封裝,之後業務程式碼裡真正觸發支付只需要一行呼叫。
所謂「封裝」,其實並不是發明新東西,而是在官方 SDK 的外面套一層自己的介面,把夥伴 ID、賣家帳號、回調地址、URL Scheme 這些固定資訊集中管理,讓呼叫端不必關心細節。
真正動手之前,你需要先完成兩件無法跳過的事:
1. 以公司名義與支付寶完成簽約,取得商戶身份;
2. 按照支付寶開放平台的文件生成 RSA 金鑰對,並把公鑰上傳、保存好私鑰。
金鑰生成環節官方文件寫得非常細,這裡不再重複。如果專案時間很緊,先把這一步照著官方說明跑通即可,其餘配置本文會逐一討論。
把作者整理好的 IntegratedAlipay 資料夾拖進工程,記得勾選 Copy(複製一份),避免以後原始目錄移動導致引用斷裂。

接著點選專案名稱,進入 Build Settings 標頁,在搜尋框輸入 search,找到 Header Search Paths,新增一條路徑:
$(SRCROOT)/專案名稱/IntegratedAlipay/AlipayFiles
注意兩點:不要帶引號;如果檔案沒有放在專案根目錄,需要在專案名稱後面補上對應的子目錄名。

填寫後的樣子如下圖,小細節往往決定能不能編譯通過。

支付寶 SDK 依賴一系列系統框架與第三方庫,需要在 Build Phases → Link Binary With Libraries 中一次加齊。

在需要呼叫 AlipaySDK 的檔案裡加入頭文件引用(#import 對應的 AlipaySDK 標頭)。
如果你的 App 以 iOS 9.0 及以上為 Base SDK,就必須處理 App Transport Security 的限制。做法是在 Info.plist 中為 alipay.com 與 alipayobjects.com 兩個網域開例外,允許 insecure HTTP 載入並放寬 TLS 版本要求:
<key>NSAppTransportSecurity</key>
<dict>
<key>NSExceptionDomains</key>
<dict>
<key>alipay.com</key>
<dict>
<key>NSIncludesSubdomains</key><true/>
<key>NSTemporaryExceptionAllowsInsecureHTTPLoads</key><true/>
<key>NSTemporaryExceptionMinimumTLSVersion</key><string>TLSv1.0</string>
<key>NSTemporaryExceptionRequiresForwardSecrecy</key><false/>
</dict>
<key>alipayobjects.com</key>
<dict>
<key>NSIncludesSubdomains</key><true/>
<key>NSTemporaryExceptionAllowsInsecureHTTPLoads</key><true/>
<key>NSTemporaryExceptionMinimumTLSVersion</key><string>TLSv1.0</string>
<key>NSTemporaryExceptionRequiresForwardSecrecy</key><false/>
</dict>
</dict>
</dict>
補充一點:若商戶已在 plist 中開啟 NSAppTransportSecurity → NSAllowsArbitraryLoads(允許所有明文載入),那麼上面這段例外配置可以省略。當然,從安全角度出發,逐網域開放永遠比一刀切更值得推薦。
依賴導入完成後按 Command + B 編譯一次。順利的話可以直接跳到下一節;如果不順利,下面幾個問題覆蓋了大多數情況。
報錯資訊類似:
URGENT: all bitcode will be dropped because 'xxxx' was built without bitcode...
原因很直白:工程開啟了 ENABLE_BITCODE(很多專案是升級 Xcode 後被自動打開的),而某個第三方庫在打包時並未開啟 bitcode,兩者不匹配。
解決思路有兩條:換成支援 bitcode 的庫版本,或者把當前 target 的 ENABLE_BITCODE 設為 NO。若暫時不方便更換依賴,關掉這個開關是最省事的選擇。

OpenSSL 內部定義了一批巨集,如果你自己的專案裡也有同名定義,就會直接衝突。筆者當年就踩過:專案裡原本有 STORE,改成 STORe 之後才恢復正常。


SDK 中的 Order.m 是以 MRC 記憶體管理模型編寫的,裡面存在 release 呼叫。如果你的專案整體開啟了 ARC,就需要把這個檔案單獨切回 MRC,或者改寫為 ARC 寫法。支付寶只需要改一個檔案,微信支付則要改兩個,這點值得記一下。

編譯通過後,找到封裝層的 AlipayHeader.h,把商戶資訊填進去,主要包括:
kPartnerID(合作者身份)、kSellerAccount(賣家 email)、kNotifyURL(非同步通知地址)、kAppScheme(回跳標識)等。
其中 kAppScheme 尤其重要:支付完成後要靠它把使用者從支付寶客戶端拉回你的 App,所以必須在 Targets → Info → URL Types 中註冊一個對應的 Scheme,並且保證這裡填寫的字串與頭文件中定義的完全一致。

配置妥當後,業務側只需要在需要跳轉支付的位置呼叫封裝好的那個方法,一行即可發起支付。

在 AppDelegate 中實作 URL 回調方法,把支付寶客戶端帶回的結果交給 SDK 解析:
- (BOOL)application:(UIApplication *)application
openURL:(NSURL *)url
sourceApplication:(NSString *)sourceApplication
annotation:(id)annotation {
// 極簡開發包不可用時會跳轉支付寶錢包,需要把結果回傳給開發包
if ([url.host isEqualToString:@"safepay"]) {
[[AlipaySDK defaultService] processOrderWithPaymentResult:url
standbyCallback:^(NSDictionary *resultDic) {
NSLog(@"result = %@", resultDic);
}];
}
// 支付寶錢包快登授權返回 authCode
if ([url.host isEqualToString:@"platformapi"]) {
[[AlipaySDK defaultService] processAuthResult:url
standbyCallback:^(NSDictionary *resultDic) {
NSLog(@"result = %@", resultDic);
}];
}
return YES;
}
這裡有個容易被忽略的細節:跳轉到支付寶客戶端的過程中,商戶 App 很可能被系統回收掉,此時 pay 介面的 callback 就會失效。因此 standbyCallback 中必須處理與 callback 完全一致的业务邏輯,作為「兜底」路徑。
完成上述配置後,支付結果會在封裝層的 AlipayRequestConfig.m 中列印出來,方便除錯。

官方文件給出的錯誤碼含義如下圖,遇到非 9000 的回執時可以對照排查。

如果金鑰尚未申請下來,或者私鑰與上傳的公鑰不匹配,模擬器上通常會直接提示參數錯誤。

真機測試則會表現為支付參數校驗失敗一類的錯誤頁。


等金鑰申請完畢、所有資訊填寫正確,再跑一次,一切就正常了。
支付寶的 iOS 接入本身並不複雜,真正耗時間的是環境配置與各種邊角問題。把封裝層做好,後續新增支付渠道時也能沿用同一套思路,業務程式碼保持乾淨。
支付寶官方文件連結:
https://doc.open.alipay.com/doc2/detail.htm?spm=a219a.7629140.0.0.3AADE5&treeId=59&articleId=104352&docType=1