客戶方APP嵌入拉卡拉提供的webview或者LKLWebObject方法類

拉卡拉2.0 4個月前 ( 11-09 ) 217

本文介紹客戶方APP嵌入拉卡拉提供的webview或者LKLWebObject方法類:

示例代碼

#pragma mark - WKScriptMessageHandler
/// 通過接收JS傳出消息的name進行捕捉的回調方法
- (void)userContentController:(WKUserContentController *)userContentController didReceiveScriptMessage:(WKScriptMessage *)message {
   if ([message.name isEqualToString: @"LKLWebObject"]) {
       NSDictionary *bodyInfo = message.body;
   NSString *methodName = bodyInfo[@"method"]?bodyInfo[@"method"]: @"";
   if ([methodName isEqualToString: @"jumpAlipay"]) {//跳轉支付寶
           NSString *url = bodyInfo[@"url"];
   [self jumpToAlipayWithUrl: url];
}

else if ([methodName isEqualToString:@"jumpWxApplet"]) {
   [self jumpToWechatMiniPrograme: bodyInfo];
}

else if ([methodName isEqualToString:@"closeWindow"]) {
   //做相關業務操作  例如:跳轉或返回到指定頁面
}
   }
}

/*
跳轉支付寶
注意:必須在info.plist中增加alipayqr白名單(LSApplicationQueriesSchemes下增加)
*/
-(void)jumpToAlipayWithUrl:(NSString *)url {
   if (![[UIApplication sharedApplication]canOpenURL: [NSURL URLWithString:url]]) {//未安裝
       [self.view makeToast:@"請先下載“支付寶”客戶端"];
   return;
}

if (@available(iOS 10.0, *)) {
   [[UIApplication sharedApplication] openURL: [NSURL URLWithString:url] options:@{
}

completionHandler:nil];
}

else {
// Fallback on earlier versions
       [[UIApplication sharedApplication]openURL: [NSURL URLWithString:url]];
}
}
//跳轉微信小程序
/*
dic中需要包含的數據
username
path
wxAppid
universalLink
programType
*/
-(void)jumpToWechatMiniPrograme:(NSDictionary *)dic {
NSString *userName = dic[@"userName"];
   NSString *path = dic[@"path"];
   NSString *universalLink = dic[@"universalLink"];
   int programType = [NSString stringWithFormat: @"%@",dic[@"programType"]].intValue;
[self jumpWxApplet: userName programPath:path universalLink:universalLink programType:programType];
}
//跳轉小程序Wechat_Applet
-(void)jumpWxApplet:(NSString *)userName programPath:(NSString *)path universalLink:(NSString *)universalLink programType:(int)programType {
if ([WXApi isWXAppInstalled]) {
       //微信注冊
       /*
        * @param appid 微信開發者ID
        * @param universalLink 微信開發者Universal Link
        */
       if ([WXApi registerApp: APP_ID universalLink:universalLink]) {
           WXLaunchMiniProgramReq *launchMiniProgramReq = [WXLaunchMiniProgramReq object];
//拉起的小程序的username
           launchMiniProgramReq.userName = userName;
           launchMiniProgramReq.path = path;
           //拉起小程序的類型
           launchMiniProgramReq.miniProgramType = programType;
           return [WXApi sendReq: launchMiniProgramReq completion:^(BOOL success) {
               NSLog(@"sendReq result %d",success);
}];
       }

else {
}
   }

else {
[self.view makeToast: @"請下載“微信”完成注冊"];
}
}

復制


closeWindoe方法觸發條件:

closeWindow方法觸發條件:

  1. 收銀臺模板配置支付完成頁標識直接跳至客戶上送的地址,且收銀臺下單接口不上送callback_url;收銀臺H5查詢到訂單狀態為終態時觸發;

    1. 訂單終態:付款成功、已過期、支付失敗等

注意:訂單支付狀態APP應以自行查詢后臺接口為準

收銀臺下單

  • webview打開收銀臺H5頁面

  • 收銀臺H5獲取商戶支付權限

  • 選擇支付寶支付

    • 收銀臺H5預下單

    • 收銀臺H5調用webview提供的jumpAlipay方法打開支付寶付款(scheme方式)

  • 選擇微信支付

    • 收銀臺H5調用webview提供的jumpWxApplet方法打開拉卡拉收款寶小程序 微信官方文檔

    • 收款寶小程序做預下單付款

代碼下載



銀聯統一收銀臺

使用銀聯統一收銀臺下單支付方式(銀聯支付, 手機Pay) 需接入如下SDK:

工程配置

  1. 在工程 info.plist 設置中添加一個 URL Types 回調協議,用于在支付完成后返回商戶客戶端。請注意 URL Schemes 需要是唯一的,與app對應。

fc06029992e643935d73a792305cb5a7_1693997651599225.png

也可在TARGETSinfo->URL Types進行配置

6b187d06a2fc6f1d74f4741cc9d3868b_1693997651103626.png

SDK使用

  1. 引入支付sdkcocoapods引入pod 'LKLPaymentSdk'

  2. 在需要調用支付控件接口的代碼文件內引用頭文件 import<LKLPaymentSdk/UPPaymentControl.h>

    注意:(注意:如果工程的 compile source as 選項的值不是 Objective–C++,則引用此頭文件的文件類型都要改為.mm)
    webview注冊協議,初始化LKLUnionCashier

4ccbd8818397859a7d23736bae6191df_1693997651186709.png

在代理方法中監聽對應方法:

  • startPay開始支付;

  • startSEPay手機支付(iOS目前Apple pay不支持);

  • tn為銀聯生成返回的參數;

  • serverMode 01為銀聯測試環境,00為銀聯生產環境;

  • mobileBrand 獲取手機品牌;

cac012bf0fc293f28602f387fe2ac2c2_1693997651644207.png

支付回調會在Appdelegate中的openURL方法中返回,可通過通知或代理等方法將支付結果回傳到支付頁面,然后回傳給js(這里用的是通知)

支付結果以收銀臺系統后臺回調結果為準

AppdelegateopenURL將支付結果url(如果之前有其他平臺,要區分開),傳給LKLUnionCashier

c7be06325cdb82bb9deb80526bdaede3_1693997651312984.png


The End