您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 快速接入支付寶支付:封裝之後一行程式碼完成付款

編輯:iOS 開發綜合

移動支付幾乎是每一款商業 App 的標配,而在 iOS 端接入支付寶,很多同學第一次做會被密鑰、ATS、bitcode 這幾個關卡絆住。本文把整個流程梳理成一條清晰的線路:先做一次性封裝,之後業務程式碼裡真正觸發支付只需要一行呼叫。

一、開始之前:準備工作

所謂「封裝」,其實並不是發明新東西,而是在官方 SDK 的外面套一層自己的介面,把夥伴 ID、賣家帳號、回調地址、URL Scheme 這些固定資訊集中管理,讓呼叫端不必關心細節。

真正動手之前,你需要先完成兩件無法跳過的事:

1. 以公司名義與支付寶完成簽約,取得商戶身份;
2. 按照支付寶開放平台的文件生成 RSA 金鑰對,並把公鑰上傳、保存好私鑰。

金鑰生成環節官方文件寫得非常細,這裡不再重複。如果專案時間很緊,先把這一步照著官方說明跑通即可,其餘配置本文會逐一討論。

二、導入工程與配置頭文件路徑

把作者整理好的 IntegratedAlipay 資料夾拖進工程,記得勾選 Copy(複製一份),避免以後原始目錄移動導致引用斷裂。

接著點選專案名稱,進入 Build Settings 標頁,在搜尋框輸入 search,找到 Header Search Paths,新增一條路徑:

$(SRCROOT)/專案名稱/IntegratedAlipay/AlipayFiles

注意兩點:不要帶引號;如果檔案沒有放在專案根目錄,需要在專案名稱後面補上對應的子目錄名。

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

三、引入依賴庫與 ATS 例外配置

支付寶 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 編譯一次。順利的話可以直接跳到下一節;如果不順利,下面幾個問題覆蓋了大多數情況。

1. bitcode 相關警告

報錯資訊類似:

URGENT: all bitcode will be dropped because 'xxxx' was built without bitcode...

原因很直白:工程開啟了 ENABLE_BITCODE(很多專案是升級 Xcode 後被自動打開的),而某個第三方庫在打包時並未開啟 bitcode,兩者不匹配。

解決思路有兩條:換成支援 bitcode 的庫版本,或者把當前 target 的 ENABLE_BITCODE 設為 NO。若暫時不方便更換依賴,關掉這個開關是最省事的選擇。

2. 巨集命名衝突

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

3. MRC 與 ARC 混用

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

五、參數配置與 URL Scheme

編譯通過後,找到封裝層的 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

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved