拉端参数
本文说明巴基斯坦收银台在拉起 Easypaisa / Jazzcash 钱包 App 时涉及的 URL 形态,以及 H5 系统浏览器、商户 App 内原生、商户 App 内 WebView 三种场景下应如何处理(含 iOS / Android)。
尼日 Pay With Wallet 拉 PalmPay 使用
pay://等协议,端内兼容方式见:Android 端内拉起收银台、iOS 端内拉起收银台。巴基斯坦 Pay with MoMo 端内逻辑与下文 WebView 章节一致,可对照实现。
拉端场景总览
巴基斯坦 — 各端 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 与原生)
- 必须让系统处理非 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 交给系统调起钱包。
- 识别
- 可选:
canOpenURL与声明查询
若需先判断能否打开,请在 Info.plist 的LSApplicationQueriesSchemes中加入easypaisa、jazzcash(及业务所需其它 scheme),否则 iOS 会限制查询结果。 - 原生页直接拉端
无 WebView 时,直接使用上述easypaisa:///jazzcash://字符串构造URL,同样通过UIApplication.shared.open打开即可。
Android:App 内(WebView 与原生)
- 拦截 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 在内部加载无效页面。
- 原生页直接拉端
- 对
intent://...:同样Intent.parseUri(..., Intent.URI_INTENT_SCHEME)+startActivity。 - 对
easypaisa:///jazzcash://:ACTION_VIEW+Uri.parse。
- 对
- 参考实现
Android 端内协议处理(含多类 scheme)可参考官方 Demo:
PalmpayDemoAndroid - WebViewActivity.kt - 系统限制说明
Android 11 起对包可见性有约束;若需resolveActivity或显式拉起指定包名,请按官方文档配置queries/intent-filter,避免误判「未安装」。
端内 Demo 代码
以下为最小可运行思路示例:端内原生在任意界面调用;端内 WebView 在加载收银台 H5 的 WKWebView / WebView 上挂代理。生产环境请补全错误提示、埋点与尼日 pay:// 等其它 scheme。
iOS(Swift)
1)端内原生:直接打开拉端 URL
2)端内 WebView:WKNavigationDelegate 拦截后交给系统
如需 canOpenURL,请在 Info.plist 的 LSApplicationQueriesSchemes 中声明 easypaisa、jazzcash 等。
Android(Kotlin)
1)端内原生:intent:// 与自定义 scheme 统一入口
2)端内 WebView:WebViewClient 拦截非 http(s) 链接
更完整的协议分支可参考 PalmpayDemoAndroid - WebViewActivity.kt。
系统浏览器 H5(对照)
在 Safari / 系统 Chrome 中打开收银台时,页面发起的上述 URL 一般由系统直接处理,商户无需在网页侧再包一层,只需保证收银台域名、HTTPS 与业务配置正确。
小结
- H5 浏览器:使用上表中的 iOS scheme 与 Android
intent://(或回退 scheme)。 - App WebView:不要让 WebView 独自加载拉端 URL;拦截后用系统 API 打开(iOS
UIApplication.open;AndroidIntent.parseUri/ACTION_VIEW)。 - App 原生:与 WebView 拦截成功后打开的 URL 与 API 完全一致。