Skip to content
开发者工具
使用AI助手和工具加速开发

技术问题 ​

1. 全球收单 ​

1.1 如何在WebView内跳转打开三方钱包进行支付? ​

解答:

查看文档:WebView打开钱包

1.2 打开DANA支付时,页面显示空白或"The network connection is unstable. Please try again later." ​

问题:

API标准入款接入方式, 打开DANA支付方式, 页面提示错误, 看到的现象是空白,实际页面比较大, 移动页面可以看到页面错误:“The network connection is unstable. Please try again later."

解答:

如果打开PaySDK的容器是Android 的WebView,需要设置webView的WebSettings属性,代码如下

webSettings.setDomStorageEnabled(true);
webSettings.setTextZoom(100);
webSettings.setUseWideViewPort(true);

1.3 支付成功后想返回自己的APP的方法 ​

解答:

在自己APP内部打开收银台url,在支付完成打开跳转地址(前端回调地址frontCallBackUrl)也是在App内部。 如果用外部浏览器打开收银台URL,在支付完成打开跳转地址(前端回调地址frontCallBackUrl)时是在外部浏览器中打开的,这时如果要跳转到App内部,需要通过(schema DeepLink)跳转。

1.4 异步回调通知注意事项 ​

解答:

1、回调地址必须真实存在; 2、协议格式: application/json; 3、协议返回内容:请查看【异步通知】 地址不通的问题(如果商户服务器对外部 IP 地址访问有限制,需要将payermax服务器IP地址添加到商户服务器的白名单中。

1.5 点击"确认支付"按钮后,没有打开后续支付页面 ​

问题:

API标准入款接入方式,点击”确认支付”按钮后,没有打开后续支付页面

解答:

如果打开API的容器是Android的WebView,需要对WebView做如下处理,下面是示例代码:

mWebView.setWebViewClient(new WebViewClient());

1.6 进入收银台,页面提示“请求参数格式错误” ​

问题:

商户使用String.format(Locale.default(), "%.2f", price)格式化金额,造成金额格式为乱码

解答:

由于Locale.getDefault()是获取当前设备的所在地区的locale,不同地区格式后的字符串不一样。建议使用 String.format(Locale.ENGLISH, "%.2f", price)

1.7 使用UPI支付时,出现界面没有办法退出 ​

问题:

使用UPI支付进入到渠道页,操作然后点击返回键没有办法回到上个页面或者退出后,再次进入打不开收银台

解答:

如果商户在离开webView时,使用“webView.loadDataWithBaseURL(null, "", "text/html", "utf-8", null);"关闭当前JS线程。需要修改为“webView.loadUrl("about:blank");”

1.8 收银台页面支付方式展示不全或者样式混乱等适配问题 ​

问题:

如果遇到收银台页面支付方式展示不全或者样式混乱,例如:示例.png

解答:

商户需要设置webView的下面参数:
mWebView.getSettings().setTextZoom(100);

1.9 支付时软键盘覆盖输入框 ​

问题:

在支付时,有些输入方式需要输入手机号或邮箱,这时候点击输入框,软键盘会覆盖输入框。

解答:

出现上面问题,需要对容器做如下检查:

  1. 不要设置全屏模式
  2. windowSoftInputMode可以不设置或者设置为adjustResize, 不要设置为adjustPan
  3. 如果是沉浸式状态栏,需要在布局中设置fitSystemWindows=true

1.10 商户传给PayerMax的URI是大写的APP://开头,为什么我方在跳转的时候变成了app://开头的? ​

因为浏览器和webview自动转换的,cheme在浏览器里是不分大小写的,会统一转为小写。 在manifest中配置时,scheme 和 host 都要全为小写

1.11 页面报这类错误'X-Frame-Options' 是什么原因 ​

一般是渠道侧页面不支持iframe嵌套,请检查下 web服务中是否设置 X-Frame-Options。

1.12 如果打开收银台链接地址的容器是Android WebView,请参考下面代码设置 ​

java
        WebSettings webSettings = mWebView.getSettings();
        webSettings.setJavaScriptEnabled(true);

        webSettings.setSupportMultipleWindows(true);
        webSettings.setJavaScriptCanOpenWindowsAutomatically(true);

        webSettings.setPluginState(WebSettings.PluginState.ON); //enable plugin. Ex: flash. deprecated on API 18
        //whether the zoom controls display on screen.
        webSettings.setBuiltInZoomControls(true);
        webSettings.setSupportZoom(true);
        webSettings.setDisplayZoomControls(false);

        //disable the webview font size changes according the phone font size.
        webSettings.setTextZoom(100);
        webSettings.setSaveFormData(true);
        webSettings.setUseWideViewPort(true);
        webSettings.setLoadWithOverviewMode(true);
        webSettings.setAllowFileAccess(true);

        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
            webSettings.setMixedContentMode(WebSettings.MIXED_CONTENT_ALWAYS_ALLOW);
            CookieManager.getInstance().setAcceptThirdPartyCookies(this, true);
        }
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN) {
            webSettings.setAllowUniversalAccessFromFileURLs(true);
        }

        webSettings.setAppCacheEnabled(true);
        String appCacheDir = getDir("cache", Context.MODE_PRIVATE).getPath();
        webSettings.setAppCachePath(appCacheDir);
        webSettings.setAppCacheMaxSize(1024*1024*20);
        webSettings.setDomStorageEnabled(true);
        webSettings.setDatabaseEnabled(true);
        webSettings.setCacheMode(WebSettings.LOAD_DEFAULT);

        try {
            mWebView.removeJavascriptInterface("searchBoxJavaBridge_");
            mWebView.removeJavascriptInterface("accessibility");
            mWebView.removeJavascriptInterface("accessibilityTraversal");
        } catch (Exception e) {}

        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
            mWebView.enableSlowWholeDocumentDraw();
        }

1.13 页面报"net::ERR_CACHE_MISS" ​

这是因为网络权限配置异常。可以更改 AndroidManifest.xml 中的权限配置尝试。 old: new: 参考:https://stackoverflow.com/questions/30637654/android-webview-gives-neterr-cache-miss-message

1.14 系统浏览器正常,用 iOS 的 wkwebview 跳转会失败,无法正常打开页面 ​

这个可能原因是wkwebview 更改 url 编码,导致链接异常,链接中 # 被 urlEncode 为 %23。可以webview 增加代码逻辑,避免 url 被异常编码

OC
-(NSString *)WM_FUNC_urlEncode:(NSString *)urlStr{
NSMutableCharacterSet *set  = [[NSCharacterSet URLQueryAllowedCharacterSet] mutableCopy];
[set addCharactersInString:@"#"];
return [urlStr stringByAddingPercentEncodingWithAllowedCharacters:set];
}
swift
swift 4.0
func WM_FUNC_urlEncode(_ urlStr:String) -> String {
if urlStr.isEmpty {
   return ""
}
var charSet = CharacterSet.urlQueryAllowed
charSet.insert(charactersIn: "#")
let encodingURLStr = urlStr.addingPercentEncoding(withAllowedCharacters: charSet)
return encodingURLStr ?? ""
}

下面模仿oc写法: CharacterSet 转换 NSMutableCharacterSet 来操作

func WM_FUNC_urlEncode(_ urlStr:String) -> String {
if urlStr.isEmpty {
   return ""
}
let charSet = CharacterSet.urlQueryAllowed as NSCharacterSet
let mutSet = charSet.mutableCopy() as! NSMutableCharacterSet
mutSet.addCharacters(in: "#")
let encodingURLStr = urlStr.addingPercentEncoding(withAllowedCharacters: mutSet as CharacterSet)
return encodingURLStr ?? ""
}

func WM_FUNC_urlEncode(_ urlStr:String) -> String {
if urlStr.isEmpty {
return ""
}
let charSet = NSMutableCharacterSet()
charSet.formUnion(with: CharacterSet.urlQueryAllowed)
charSet.addCharacters(in: "#")
let encodingURLStr = urlStr.addingPercentEncoding(withAllowedCharacters: charSet as CharacterSet)
return encodingURLStr ?? ""
}

参考: https://www.jianshu.com/p/e4938ada31e6

1.15 安卓9.0 以上手机打不开页面,协议改成 https,9.0 以下的都好了,以上的不行。 ​

这个原因可能是Android P 限制了 http 协议的明文流量的网络请求,非加密的流量请求都会被系统禁止掉。您可以将相关 api / 页面更换成 https 协议 若仍需使用 http,可通过下列方法使 Android webview 支持 http 协议:

方法一: 1.res 目录下新建 xml 目录,xml 目录下新建 network_security_config.xml文件:

xml
<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
  <base-config cleartextTrafficPermitted="true" />
</network-security-config>

2.AndroidManifest.xml

xml
<application android:networkSecurityConfig="@xml/network_security_config">
  <!--android9.0适配-->
  <uses-library android:name="org.apache.http.legacy" android:required="false" />
</application>

方法二: AndroidManifest.xml添加:

xml
<application android:usesCleartextTraffic="true">

参考 https://juejin.cn/post/6844903813929762824

1.16 webview 加载页面报错,net::ERR_BLOCKED_BY_RESPONSE。 ​

这个原因是该地址不支持在 iframe 中使用。建议您将页面地址直接打开,不在 iframe 中使用。

1.17 WebView布局宽高未设置MATCH_PARENT导致白屏 ​

问题:

在Android App中集成WebView打开PayerMax收银台时,页面出现白屏,无任何内容展示。

解答:

这种情况通常是因为WebView在添加到父容器时,LayoutParams的宽高没有正确设置为MATCH_PARENT。如果WebView的宽高为0或使用了WRAP_CONTENT,WebView没有足够的渲染空间,收银台页面内容无法正常绘制,从而表现为白屏。 请确保在将WebView添加到父布局时,显式指定宽高均为MATCH_PARENT,参考代码如下:

Java
web_container_ll.addView(
    mWebView,
    new LinearLayout.LayoutParams(
        ViewGroup.LayoutParams.MATCH_PARENT,
        ViewGroup.LayoutParams.MATCH_PARENT
    )
);

2. 全球付款 ​

2.1 误认为出款接口响应码APPLY_SUCCESS为支付成功 ​

问题:

收到出款接口响应码是APPLY_SUCCESS, 以为支付成功

解答:

响应码APPLY_SUCCESS只是说明当前协议响应是成功的;如果要查询是否支付成功,以服务端回调结果为准(商户传入或配置服务端回调地址)或以主动查询为准。

3. 参数配置 ​

3.1 如何生成密钥? ​

您可登录商户平台,通过「开发参数」频道生成和重置密钥。配置时,需注意区分测试环境和正式环境。

3.2 如何添加回调地址? ​

PayerMax支持两种方式设置回调地址:

  1. 拥有开发参数权限的操作员或超级管理员可在商户平台中的「开发参数」频道生成和修改回调地址。
  2. 在下单时传入回调地址。 注意:若您传入的回调地址和商户平台配置的回调地址有冲突,以您传入的回调地址为准。

3.3 为何没收到回调通知? ​

  1. 请确认是否设置回调地址。
  2. 请确认回调地址是否填写正确,若仍有问题,请联系PayerMax平台查明原因。

Released under the MIT License.