• 简体中文
  • 拉端参数

    本文说明巴基斯坦收银台在拉起 Easypaisa / Jazzcash 钱包 App 时涉及的 URL 形态,以及 H5 系统浏览器、商户 App 内原生、商户 App 内 WebView 三种场景下应如何处理(含 iOS / Android)。

    尼日 Pay With Wallet 拉 PalmPay 使用 pay:// 等协议,端内兼容方式见:Android 端内拉起收银台、iOS 端内拉起收银台。巴基斯坦 Pay with MoMo 端内逻辑与下文 WebView 章节一致,可对照实现。

    拉端场景总览

    场景说明
    系统浏览器 H5用户在 Safari / Chrome 等中打开收银台;页面通过 location.href 或 <a href> 跳转拉端,行为由系统处理。
    App 内 WebView商户用 WebView 加载收银台 H5;自定义 scheme(如 easypaisa://)和 Android intent:// 往往不会自动交给系统,需在客户端拦截导航并转交给系统打开。
    App 内原生若业务在原生页直接拼出拉端链接,用系统「打开 URL」能力即可,与 WebView 拦截后调用的 API 相同。

    巴基斯坦 — 各端 URL 形态

    H5 / 通用:收银台实际会发起的拉端链接

    以下与当前收银台行为一致,用于配置白名单、联调核对或原生侧直接打开。

    iOS(含系统浏览器与 App 内最终要交给系统的 URL)

    • Easypaisa: easypaisa://
    • Jazzcash: jazzcash://

    Android(H5 在 Chrome 等中常见为 intent:// 形式,由系统解析后调起应用)

    • Easypaisa: intent://easypaisa.onelink.me/miniapp#Intent;scheme=https;package=pk.com.telenor.phoenix;end
    • Jazzcash: intent://deeplink#Intent;scheme=jazzcash;package=com.techlogix.mobilinkcustomer;end

    若收银台在部分环境下回退为 纯 scheme(easypaisa:// / jazzcash://),Android 端处理方式与下述「自定义 scheme」相同。

    iOS:App 内(WebView 与原生)

    1. 必须让系统处理非 http(s) 链接
      WKWebView 对 easypaisa://、jazzcash:// 等导航,应在 webView(_:decidePolicyFor:navigationAction:)(或等价 API)中:
      • 识别 navigationAction.request.url 的 scheme 为 easypaisa、jazzcash(以及业务涉及的 pay 等);
      • 对该请求 return .cancel,避免 WebView 内报错页;
      • 使用 UIApplication.shared.open(url)(或 openURL 兼容写法)把完整 URL 交给系统调起钱包。
    2. 可选:canOpenURL 与声明查询
      若需先判断能否打开,请在 Info.plist 的 LSApplicationQueriesSchemes 中加入 easypaisa、jazzcash(及业务所需其它 scheme),否则 iOS 会限制查询结果。
    3. 原生页直接拉端
      无 WebView 时,直接使用上述 easypaisa:// / jazzcash:// 字符串构造 URL,同样通过 UIApplication.shared.open 打开即可。

    Android:App 内(WebView 与原生)

    1. 拦截 WebView 出站链接
      在 shouldOverrideUrlLoading(或 WebResourceRequest 回调)中判断 URL:
      • intent:// 开头:使用 Intent.parseUri(url, Intent.URI_INTENT_SCHEME) 得到 Intent,再 startActivity;若需兜底可再处理 getPackage() 或浏览器跳转(按产品要求)。
      • easypaisa://、jazzcash:// 等自定义 scheme:使用 Intent(Intent.ACTION_VIEW, Uri.parse(url)) 后 startActivity。
        拦截后应 return true(或消费该次加载),避免 WebView 在内部加载无效页面。
    2. 原生页直接拉端
      • 对 intent://...:同样 Intent.parseUri(..., Intent.URI_INTENT_SCHEME) + startActivity。
      • 对 easypaisa:// / jazzcash://:ACTION_VIEW + Uri.parse。
    3. 参考实现
      Android 端内协议处理(含多类 scheme)可参考官方 Demo:
      PalmpayDemoAndroid - WebViewActivity.kt
    4. 系统限制说明
      Android 11 起对包可见性有约束;若需 resolveActivity 或显式拉起指定包名,请按官方文档配置 queries / intent-filter,避免误判「未安装」。

    端内 Demo 代码

    以下为最小可运行思路示例:端内原生在任意界面调用;端内 WebView 在加载收银台 H5 的 WKWebView / WebView 上挂代理。生产环境请补全错误提示、埋点与尼日 pay:// 等其它 scheme。

    iOS(Swift)

    1)端内原生:直接打开拉端 URL

    import UIKit
    
    /// 在按钮点击或支付回调里调用,传入 easypaisa:// / jazzcash:// 等完整字符串
    func openWalletDeepLink(_ urlString: String) {
        guard let url = URL(string: urlString) else { return }
        UIApplication.shared.open(url, options: [:], completionHandler: nil)
    }
    
    // 示例:
    // openWalletDeepLink("easypaisa://")
    // openWalletDeepLink("jazzcash://")

    2)端内 WebView:WKNavigationDelegate 拦截后交给系统

    import UIKit
    import WebKit
    
    final class CashierWebViewController: UIViewController, WKNavigationDelegate {
    
        private lazy var webView: WKWebView = {
            let wv = WKWebView(frame: .zero, configuration: WKWebViewConfiguration())
            wv.navigationDelegate = self
            wv.translatesAutoresizingMaskIntoConstraints = false
            return wv
        }()
    
        override func viewDidLoad() {
            super.viewDidLoad()
            view.addSubview(webView)
            NSLayoutConstraint.activate([
                webView.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor),
                webView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
                webView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
                webView.bottomAnchor.constraint(equalTo: view.bottomAnchor),
            ])
            // 替换为预下单返回的 checkoutUrl
            if let url = URL(string: "https://example.com/your-checkout") {
                webView.load(URLRequest(url: url))
            }
        }
    
        func webView(
            _ webView: WKWebView,
            decidePolicyFor navigationAction: WKNavigationAction,
            decisionHandler: @escaping (WKNavigationActionPolicy) -> Void
        ) {
            guard let url = navigationAction.request.url,
                  let scheme = url.scheme?.lowercased() else {
                decisionHandler(.allow)
                return
            }
            // 正常页面走 WebView
            if scheme == "http" || scheme == "https" {
                decisionHandler(.allow)
                return
            }
            // javascript: 等仍需在 WebView 内执行
            if scheme == "javascript" {
                decisionHandler(.allow)
                return
            }
            // 钱包 / pay 等非 http(s):取消内置加载,用系统打开(与 FAQ 描述一致)
            decisionHandler(.cancel)
            UIApplication.shared.open(url, options: [:], completionHandler: nil)
        }
    }

    如需 canOpenURL,请在 Info.plist 的 LSApplicationQueriesSchemes 中声明 easypaisa、jazzcash 等。

    Android(Kotlin)

    1)端内原生:intent:// 与自定义 scheme 统一入口

    import android.content.ActivityNotFoundException
    import android.content.Context
    import android.content.Intent
    import android.net.Uri
    
    fun openWalletDeepLink(context: Context, urlString: String) {
        try {
            val intent = if (urlString.startsWith("intent:", ignoreCase = true)) {
                Intent.parseUri(urlString, Intent.URI_INTENT_SCHEME)
            } else {
                Intent(Intent.ACTION_VIEW, Uri.parse(urlString))
            }
            context.startActivity(intent)
        } catch (_: ActivityNotFoundException) {
            // 未安装目标 App 或未注册 scheme,按产品提示用户或走 H5 兜底
        }
    }
    
    // 示例:
    // openWalletDeepLink(context, "intent://easypaisa.onelink.me/miniapp#Intent;scheme=https;package=pk.com.telenor.phoenix;end")
    // openWalletDeepLink(context, "intent://deeplink#Intent;scheme=jazzcash;package=com.techlogix.mobilinkcustomer;end")
    // openWalletDeepLink(context, "easypaisa://")

    2)端内 WebView:WebViewClient 拦截非 http(s) 链接

    import android.content.Context
    import android.content.Intent
    import android.net.Uri
    import android.webkit.WebResourceRequest
    import android.webkit.WebView
    import android.webkit.WebViewClient
    
    class WalletAwareWebViewClient : WebViewClient() {
    
        override fun shouldOverrideUrlLoading(view: WebView, request: WebResourceRequest): Boolean {
            val url = request.url.toString()
            if (url.startsWith("http://", true) || url.startsWith("https://", true)) {
                return false
            }
            return openExternal(view.context, url)
        }
    
        @Deprecated("Deprecated in Java")
        override fun shouldOverrideUrlLoading(view: WebView, url: String?): Boolean {
            if (url.isNullOrBlank()) return false
            if (url.startsWith("http://", true) || url.startsWith("https://", true)) {
                return false
            }
            return openExternal(view.context, url)
        }
    
        private fun openExternal(context: Context, urlString: String): Boolean {
            return try {
                val intent = if (urlString.startsWith("intent:", ignoreCase = true)) {
                    Intent.parseUri(urlString, Intent.URI_INTENT_SCHEME)
                } else {
                    Intent(Intent.ACTION_VIEW, Uri.parse(urlString))
                }
                context.startActivity(intent)
                true
            } catch (_: Exception) {
                // 拉起失败仍返回 true,避免 WebView 把 intent:// 当网页加载出错误页
                true
            }
        }
    }
    
    // 使用:webView.webViewClient = WalletAwareWebViewClient()

    更完整的协议分支可参考 PalmpayDemoAndroid - WebViewActivity.kt。

    系统浏览器 H5(对照)

    在 Safari / 系统 Chrome 中打开收银台时,页面发起的上述 URL 一般由系统直接处理,商户无需在网页侧再包一层,只需保证收银台域名、HTTPS 与业务配置正确。

    小结

    • H5 浏览器:使用上表中的 iOS scheme 与 Android intent://(或回退 scheme)。
    • App WebView:不要让 WebView 独自加载拉端 URL;拦截后用系统 API 打开(iOS UIApplication.open;Android Intent.parseUri / ACTION_VIEW)。
    • App 原生:与 WebView 拦截成功后打开的 URL 与 API 完全一致。