技术问题
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 支付时软键盘覆盖输入框
问题:
在支付时,有些输入方式需要输入手机号或邮箱,这时候点击输入框,软键盘会覆盖输入框。
解答:
出现上面问题,需要对容器做如下检查:
- 不要设置全屏模式
- windowSoftInputMode可以不设置或者设置为adjustResize, 不要设置为adjustPan
- 如果是沉浸式状态栏,需要在布局中设置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,请参考下面代码设置
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 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 version="1.0" encoding="utf-8"?>
<network-security-config>
<base-config cleartextTrafficPermitted="true" />
</network-security-config>2.AndroidManifest.xml
<application android:networkSecurityConfig="@xml/network_security_config">
<!--android9.0适配-->
<uses-library android:name="org.apache.http.legacy" android:required="false" />
</application>方法二: AndroidManifest.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,参考代码如下:
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支持两种方式设置回调地址:
- 拥有开发参数权限的操作员或超级管理员可在商户平台中的「开发参数」频道生成和修改回调地址。
- 在下单时传入回调地址。 注意:若您传入的回调地址和商户平台配置的回调地址有冲突,以您传入的回调地址为准。
3.3 为何没收到回调通知?
- 请确认是否设置回调地址。
- 请确认回调地址是否填写正确,若仍有问题,请联系PayerMax平台查明原因。
