
本文為投稿文章,作者:南栀傾寒。
當初集成支付寶時,看著那醜到不行的代碼、難找得要命的下載地址,再配上幾乎為零的文檔,寒哥差點就要當場吐血。
等到下午去集成銀聯,我才發現——血吐早了。
下載地址:https://open.unionpay.com/upload/download/Development_kit85427986.rar
老實說,我折騰了半個小時,也搞不清它究竟怎麼就下載好了,最後還是在 Chrome 的下載記錄裡把它翻了出來。
解壓後會得到這樣的目錄結構:

文檔放在下面,SDK 則在 upmp_iPhone 目錄裡。

1、SDK 說明
SDK 分為以下兩個版本:
1. 支援純無卡交易的靜態庫,以下簡稱 UPPayPlugin,包含文件:
UPPayPlugin.h、UPPayPluginDelegate.h、libUPPayPlugin.a
2. 同時支援純無卡交易與 VIPOS 音頻口支付的靜態庫,以下簡稱 UPPayPluginPro,包含文件:
UPPayPluginPro.h
UPPayPluginDelegate.h、libUPPayPluginPro.a
3、添加 SDK 包
a. 依據商戶選擇的 SDK 版本,把 sdk/inc 目錄與 sdk/libs 目錄下對應版本的三個文件加入 UPPayDemo 工程;
b. 若選擇的是 UPPayPlugin 版本,需添加 QuartzCore.framework、Security.framework 到工程;
c. 若選擇的是 UPPayPluginPro 版本,需添加 QuartzCore.framework、AudioToolbox.framework、CoreAudio.framework、MediaPlayer.framework、AVFoundation.framework 與 Security.framework 到工程;
d. 在工程的 Build Settings 中找到 Other Linker Flags,加入 -ObjC 宏(這可能是歷史遺留項,我沒加也不報錯)。
4、調用插件
a. 在需要調用支付控件的源文件裡引入頭文件 UPPayPlugin.h 或 UPPayPluginPro.h(注意:若工程的 compile source as 選項值不是 Objective-C++,則引用此頭文件的文件類型都要改為 .mm);
b. 透過調用以下方法來拉起控件:
(BOOL)startPay:(NSString)tn mode:(NSString)mode viewController:(UIViewController*)viewController delegate:(id<UPPayPluginDelegate>)delegate;
c. 處理支付結果。
銀聯手機支付控件有三個支付狀態返回值:success、fail、cancel,分別代表支付成功、支付失敗、使用者取消支付。這三個狀態以字符串形式作為回調函數參數(NSString)result 返回。只要在工程中引入頭文件「UPPayPluginDelegate.h」,在處理交易結果的界面實現 UPPayPluginDelegate 接口,並依該頭文件中的回調函數 -(void)UPPayPluginResult:(NSString)result 實現回調方法,就能針對不同的支付結果分別處理。
此外,若出現編譯問題,可依次排查:
a. 將 Xcode 工程 Build Setting → Apple LLVM compiler Language 標籤下的 C++ Language Dialect 與 C++ Standard Library 屬性值改為 Compiler Default;
b. 將所有引用 UPPayPlugin.h 的源文件後綴名都改為 .mm;
c. 參照 demo,檢查工程設置 Search Paths 中的 Framework Search Paths、Header Search Paths、Library Search Paths 路徑是否正確;
d. 添加 QuartzCore.framework、AudioToolbox.framework、CoreAudio.framework、MediaPlayer.framework、AVFoundation.framework 與 Security.framework;
e. 在 Build Settings 中找到 Other Linker Flags,加入 -ObjC 宏。
上面這幾點網上基本都能查到。如果已按上述設置卻仍編譯不通過,那就趕緊檢查一下項目 targets 對應的 SDK 版本,選擇 7.0 以下的即可——目前銀聯的 SDK 似乎還不支援 7.0。
注:
銀聯支付粗看只需要兩個參數:1)tn,其實就是訂單號;2)mode,用來區分測試環境還是線上環境。
與支付寶不同的是,支付寶要求本地先把訂單信息全部寫好,再調起 SDK 支付即可;而銀聯的做法是,我把付款方、收款方、訂單描述、金額等生成訂單所需的信息傳給服務器,由服務器生成一個訂單號,然後客戶端再調起 SDK 進入支付。
mode 竟然是個寫死的字符串,真讓人哭笑不得:「00」表示線上環境,「01」表示測試環境。
返回的代理結果就更坑了:success、fail、cancel,分別代表支付成功、支付失敗、使用者取消支付。
測試環境賬號
以下卡號、手機號僅供測試,不會發生正式交易。招商銀行預付費卡:卡號 6226 4401 2345 6785,密碼 111101。