行動支付接入向來是環節最多、最容易出錯的一塊。本文以官方 SDK 為例,從跑起範例到搬進自己的專案,再整理常見的編譯錯誤與回跳問題。
SDK 資源可至支付寶開放平台,在行動支付功能處下載。
需要設定一組基本資訊:打開 APViewController.m,編輯其中的三個參數。


1. 複製檔案。把解壓包裡的 AlipaySDK.bundle 與 AlipaySDK.framework,連同 Demo 中的下列檔案一起拷進專案資料夾並加入專案。

2. 加入相依的動態庫與框架。在 Build Phases 的 Link Binary With Libraries 中補上:

3. 處理 ATS。若 App 以 9.0 以上版本編譯,為了繞過 App Transport Security 對 http 的限制,需要在 Info.plist 中為 alipay.com、alipayobjects.com 開例外。

4. 在需要支付的 .m 檔中引入標頭。
#import "Order.h" #import "DataSigner.h" #import <AlipaySDK/AlipaySDK.h> #import "APAuthV2Info.h"
接著依自己的 App 狀況調整下列參數即可:





1. 缺少標頭檔


在該檔案上方補上基礎標頭即可:
#import <Foundation/Foundation.h> #import <UIKit/UIKit.h>
2. 'openssl/asn1.h' file not found

解法:在 Xcode 的 Header Search Paths 中加上支付寶 SDK 裡 openssl 的路徑,通常設定為 $(SRCROOT)/專案名稱。
3. 從支付寶客戶端跳不回自己的 App
先在 AppDelegate.m 引入 SDK:
#import <AlipaySDK/AlipaySDK.h>
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<NSString*, id> *)options {
[[AlipaySDK defaultService] processOrderWithPaymentResult:url standbyCallback:^(NSDictionary *resultDic) {
NSLog(@"result = %@", resultDic); // 返回的支付結果
// 【在跳轉支付寶客戶端的過程中,商戶 App 很可能已被系統回收,
// 此時 pay 介面的 callback 會失效,因此務必在 standbyCallback
// 中處理與 callback 相同的邏輯】
}];
return YES;
}
接著點選專案名稱,進入 Info 頁籤,在 URL Types 中按「+」,於 URL Schemes 填入自己的 App 標識,例如 alisdkdemo。這個字串來自支付程式碼中的設定:

這裡的 alisdkdemo 只是範例。正式環境請填寫獨一無二的 scheme,建議帶上自家 App 的可辨識特徵,並確認不與其他 App 重複,否則支付結果可能跳不回正確的 App。

4. 常見錯誤碼
「支付寶交易訂單處理失敗 AL159」:金額只能精確到分,請勿使用小數超過兩位的浮點數,格式字串應為 %.2f。
「支付寶支付失敗:4000」:檢查訂單各項參數,常見原因是訂單 ID 被寫成浮點數。
其他錯誤:逐一核對參數、公鑰與私鑰是否正確配對。