一:介紹
項(xiàng)目中要用到支付功能结窘,需要支付寶支付饼煞、支付寶網(wǎng)頁(yè)支付粱哼、微信支付酒朵、銀聯(lián)支付初斑、Apple_pay宪肖,所以打算總結(jié)一下,方便以后的查閱濒生,也方便大家埋泵, 用到的地方避免再次被坑。
今天我們就主要介紹一下銀聯(lián)控件支付罪治,其他支付也寫(xiě)了對(duì)應(yīng)教程秋泄,并且給出了連接。
集成前首先要看看文檔规阀,銀聯(lián)手機(jī)控件支付恒序,里面包含需要的庫(kù)文件和詳細(xì)的文檔。鑒于小伙伴們不容易找到谁撼,好事做到底歧胁,送上截圖方便下載偏化。
更多iOS干貨Demo源碼獲取方法
關(guān)注 【網(wǎng)羅開(kāi)發(fā)】微信公眾號(hào)静秆,選取需要的文章類(lèi)別,根據(jù)序號(hào)便可領(lǐng)取骡和。
網(wǎng)羅天下方法箍鼓,方便你我開(kāi)發(fā)崭参,所有文檔會(huì)持續(xù)更新,歡迎關(guān)注一起成長(zhǎng)款咖!
二:支付流程介紹
通過(guò)支付控件進(jìn)行交易的流程如下圖:
流程圖說(shuō)明:
(1)用戶(hù)在客戶(hù)端中點(diǎn)擊購(gòu)買(mǎi)商品何暮,客戶(hù)端發(fā)起訂單生成請(qǐng)求到商戶(hù)后臺(tái);
(2)商戶(hù)后臺(tái)收到訂單生成請(qǐng)求后,按照《手機(jī)控件支付產(chǎn)品接口規(guī)范》組織并推送訂單信息至銀聯(lián)后臺(tái);
(3)銀聯(lián)后臺(tái)接收訂單信息并檢查通過(guò)后铐殃,生成對(duì)應(yīng)交易流水號(hào)(即TN)海洼,并回復(fù)至商戶(hù)后臺(tái)(應(yīng)答要素:交易流水號(hào)等);
(4)商戶(hù)后臺(tái)接收到交易流水號(hào)(TN),將交易流水號(hào)返回至客戶(hù)端;
(5)客戶(hù)端通過(guò)交易流水號(hào)(TN)調(diào)用支付控件;
(6)用戶(hù)在支付控件中輸入相關(guān)支付信息后富腊,由支付控件向銀聯(lián)后臺(tái)發(fā)起支付請(qǐng)求;
(7)支付成功后坏逢,銀聯(lián)后臺(tái)將支付結(jié)果通知給商戶(hù)后臺(tái);
(8)銀聯(lián)后臺(tái)同時(shí)也將支付結(jié)果通知支付控件;
(9)支付控件顯示支付結(jié)果并將支付結(jié)果返回至客戶(hù)端;
此處備注:我們是通過(guò)后臺(tái)獲取訂單,我們可以根據(jù)商品id等信息通過(guò)后臺(tái)接口獲取訂單信息,對(duì)訂單支付流程的簽名加密過(guò)程后臺(tái)完成是整。
三:下載銀聯(lián)SDK
下載之后肖揣,找到.h文件和庫(kù)文件,使用UPPaymentControl需要將paymentcontrol/inc目錄下UPPaymentControl.h文件和paymentcontrol/libs目錄下的libPaymentControl.a文件添加到商戶(hù)應(yīng)用的工程中
四:工程配置
4.1 導(dǎo)入SDK庫(kù)
導(dǎo)入上面那個(gè)iOS頭文件和庫(kù)下載下載出來(lái)的SDK包的就行浮入,然后需要鏈接上依賴(lài)庫(kù)龙优,在Target —> BuildPhases —> Link Binary With Libraries— 點(diǎn)擊+號(hào) -> 搜索你需要的系統(tǒng)庫(kù)。
- CFNetwork.framework
- SystemConfiguration.framework
- libz
- libPaymentControl.a
4.2 設(shè)置URL Scheme
在工程info.plist設(shè)置中添加一個(gè)URL Types回調(diào)協(xié)議(在UPPayDemo工程中使用“UPPayDemo”作為協(xié)議)舵盈,用于在支付完成后返回商戶(hù)客戶(hù)端。
4.3 http請(qǐng)求設(shè)置
進(jìn)行http請(qǐng)求時(shí)球化,需要在工程對(duì)應(yīng)的plist文件中添加NSAppTransportSecurity Dictionary 并同時(shí)設(shè)置里面NSAllowsArbitraryLoads 屬性值為 YES
4.4 添加協(xié)議白名單
需要在工程對(duì)應(yīng)的plist文件中秽晚,添加LSApplicationQueriesSchemes Array并加入uppaysdk、uppaywallet筒愚、uppayx1赴蝇、uppayx2、uppayx3五個(gè)item巢掺,如下圖:
4.5 調(diào)用支付接口
在調(diào)用銀聯(lián)支付類(lèi)里面句伶,首先增加頭文件引用。
#import "UPPaymentControl.h"
在調(diào)起支付的方法中代碼如下:
//當(dāng)獲得的tn不為空時(shí)陆淀,調(diào)用支付接口
if (tn != nil && tn.length > 0) {
[[UPPaymentControl defaultControl]startPay:tn
fromScheme:@"URL Scheme"
mode:tnModel
viewController:self];
}
方法需要的幾個(gè)參數(shù)文檔上都寫(xiě)的有考余,tn是交易流水號(hào),服務(wù)器端傳回來(lái)的轧苫,客戶(hù)端只有憑借這個(gè)參數(shù)才能調(diào)用支付控件 進(jìn)行支付的楚堤。只需要調(diào)用一個(gè)方法就行啦!:谩身冬!
4.6 支付結(jié)果回調(diào)
在支付成功之后,支付結(jié)果返回岔乔,需要獲取url酥筝,需要在Appdelegate中完成
在Appdelegate里面,首先增加頭文件引用雏门。
#import "UPPaymentControl.h"
代碼如下:
- (BOOL)application:(UIApplication *)application
openURL:(NSURL *)url
sourceApplication:(NSString *)sourceApplication
annotation:(id)annotation {
if ([url.host isEqualToString:@"uppayresult"]){
//銀聯(lián)支付結(jié)果
[[UPPaymentControl defaultControl] handlePaymentResult:url completeBlock:^(NSString *code, NSDictionary *data) {
//結(jié)果code為成功時(shí)嘿歌,先校驗(yàn)簽名,校驗(yàn)成功后做后續(xù)處理
if([code isEqualToString:@"success"]) {
//交易成功
}else if([code isEqualToString:@"fail"]) {
//交易失敗
}else if([code isEqualToString:@"cancel"]) {
//交易取消
}
}];
}
return YES;
}
// NOTE: 9.0以后使用新API接口
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<NSString*, id> *)options
{
if ([url.host isEqualToString:@"uppayresult"]){
//銀聯(lián)支付結(jié)果
[[UPPaymentControl defaultControl] handlePaymentResult:url completeBlock:^(NSString *code, NSDictionary *data) {
//結(jié)果code為成功時(shí)茁影,先校驗(yàn)簽名搅幅,校驗(yàn)成功后做后續(xù)處理
if([code isEqualToString:@"success"]) {
//交易成功
}else if([code isEqualToString:@"fail"]) {
//交易失敗
}else if([code isEqualToString:@"cancel"]) {
//交易取消
}
}];
}
return YES;
}
4.7 常見(jiàn)問(wèn)題解決
1.由于支付控件使用到了C、C++和OC混編的情況呼胚,將涉及到引用UPPaymentControl.h的源文件的后綴名都改為.mm;
2.由于在UPPayDemo工程中添加了自定義的庫(kù)文件libPaymentControl.a茄唐,當(dāng)編譯Demo工程時(shí),應(yīng)該檢查工程設(shè)置Search Paths里的Framework Search Paths、Header Search Paths沪编、Library Search Paths的路徑設(shè)置呼盆,看設(shè)置路徑是否正確,另外還要注意里邊是否多余一些不確定的路徑蚁廓。
3.控件界面無(wú)限加載访圃,請(qǐng)參考控件使用指南iOS “添加SDK包“里“添加-ObjC宏”,特別注意大小寫(xiě)不要弄混相嵌。(此步驟操作有問(wèn)題時(shí)也可修改為 -force_load+空格+控件路徑腿时,如:-force_load (PROJECT_DIR)/ libPaymentControl.a徽鼎。
希望可以幫助大家
如果哪里有什么不對(duì)或者不足的地方,還望讀者多多提意見(jiàn)或建議