微信无法连接支付服务器,App接入微信H5支付常见错误及原因

在App上接入微信H5支付一般都会遇到一些错误。本文讨论了这些错误的解决方案和背后的原因&＃xff0c;希望能让读者能少踩些坑。

错误可以分为两类&＃xff1a;一是H5支付域名设置错误&＃xff0c;二是URL Scheme跳转App错误。

第一类&＃xff0c;H5支付域名设置错误

此类错误一般发生在安卓机器上(网上有人说iOS也遇到类似错误)&＃xff0c;在微信官方文档里有对这类现象的详细描述。

一般情况下&＃xff0c;检查下面两点就能排除这类错误&＃xff1a;

登录商户号对应的商户平台—“产品中心”—“开发配置”&＃xff0c;查看设置的H5支付域名是否包含商家发起支付的网页所在的域名。

在商家发起支付的网页&＃xff0c;在发起支付的时候&＃xff0c;浏览器会重定向到一个微信的页面(页面地址类似于&＃xff1a;https://wx.tenpay.com/cgi-bin/mmpayweb-bin/checkmweb?prepay_id&＃61;wx20161110163838f231619da20804912345&package&＃61;1037687096)&＃xff0c;这个页面会校验权限和安全性&＃xff0c;我们暂且把它叫做微信校验页面。

为了校验发起支付的域名是否合法&＃xff0c;在请求微信校验页面的HTTP请求里&＃xff0c;头部(HTTP Header)需要有“Referer”这个字段。了解HTTP的同学可能知道&＃xff0c;Referer字段会告诉服务器请求的原始资源的URI。也就是说&＃xff0c;Referer会告诉腾讯的服务器&＃xff0c;是谁在请求微信校验页面。所以Referer的值应该是商家发起支付的页面的域名。

通常情况下&＃xff0c;浏览器或者WebView会为我们自动加上Referer&＃xff0c;但是在安卓的自定义WebView中&＃xff0c;无法自动加上Referer。需要在WebView中手动设置Referer&＃xff0c;如&＃xff1a;

Map extraHeaders &＃61; new HashMap();

extraHeaders.put("Referer", "商户申请H5时提交的授权域名"

第二类&＃xff0c;URL Scheme跳转错误

1、无法跳转到微信App

在完成了上述校验后&＃xff0c;浏览器或者WebView会被重定向到一个URL Scheme(类似于&＃xff1a;weixin://wap/pay?prepayid%3Dwx261541599457545c6f11d41a1106566432&package&＃61;1888940394&noncestr&＃61;1564126923&sign&＃61;1ba23428a32b17d5d03cf032b283379f)。

对于安卓或者iOS的浏览器来说&＃xff0c;这种URL Scheme一般可以成功跳转。但是对于安卓自定义WebView和iOS的WKWebView来说&＃xff0c;无法使用URL Scheme跳转。

1)安卓自定义WebView

往往我们的app中使用自定义的WebView&＃xff0c;会设置很多参数&＃xff0c;经测试发现如果为WebView设置了WebViewClient&＃xff0c;如下&＃xff1a;

webView.setWebViewClient(new WebViewClient() {

// some logic

}

那么就不能唤起微信支付了&＃xff0c;errorCode返回-10&＃xff0c;提示“不支持该协议”。我们需要手动调起微信&＃xff1a;

&＃64;Override

public boolean shouldOverrideUrlLoading(WebView view, String url) {

// 如下方案可在非微信内部WebView的H5页面中调出微信支付

if (url.startsWith("weixin://")) {

Intent intent &＃61; new Intent();

intent.setAction(Intent.ACTION_VIEW);

intent.setData(Uri.parse(url));

startActivity(intent);

return true;

}

return super.shouldOverrideUrlLoading(view, url);

}

2) iOS UIWebView

如果iOS端使用的是UIWebView&＃xff0c;是可以支持URL Scheme的。但是自iOS 9之后&＃xff0c;URL Scheme必须在Info.plist中列为白名单才有效。

打开Info.plist&＃xff0c;增加“LSApplicationQueriesSchemes”一行&＃xff0c;类型设置为Array&＃xff0c;并在这个数组中加入一个条目&＃xff1a;“weixin”。

image

3)iOS WKWebView

WKWebView不支持URL Scheme&＃xff0c;或者叫默认不支持URL Scheme&＃xff0c;需要我们手动调起微信。参考解决方法&＃xff1a;

- (void)webView:(WKWebView *)webView decidePolicyForNavigationAction:(WKNavigationAction *)navigationAction decisionHandler:(void (^)(WKNavigationActionPolicy))decisionHandler {

NSURL *url &＃61; navigationAction.request.URL;

NSString *urlString &＃61; (url) ? url.absoluteString : &＃64;"";

if ([urlString containsString:&＃64;"weixin://"]) {

[[UIApplication sharedApplication] openURL:url];

decisionHandler(WKNavigationActionPolicyCancel);

}

}

如果你使用UIApplication的openURL方法打开URL Scheme&＃xff0c;你就不需要在Info.plist中把对应的URL Scheme列为白名单。

因为&＃xff0c;UIApplication的canOpenURL会查询Info.plist中LSApplicationQueriesSchemes中的Scheme&＃xff0c;如果没有对应的Scheme就返回NO。而当你使用UIApplication的openURL方法打开一个URL Scheme的时候&＃xff0c;并不会调用canOpenURL。

2、支付完成后无法从微信App跳转回到我们的App

在调用微信支付的时候&＃xff0c;微信允许你设置一个回调URL。在iOS上&＃xff0c;支付完成后&＃xff0c;微信会调起手机上的Safari浏览器加载这个回调URL。

这个回调URL的逻辑我们无法改变&＃xff0c;但是我们可以在回调URL指向的HTML页面里&＃xff0c;判断是否是iOS Safari浏览器。如果是Safari&＃xff0c;就可以调用我们App自己的URL Scheme。

我们可以在Info.plist里增加一个URL Types:

image

然后在回调页面里合适的时机调用window.location &＃61; "testappdemo",注意"testappdemo"是你在Info.plist里设置的URL Scheme。

这样Safari就会调起你的App。但是在调起你的App之前&＃xff0c;会询问用户“是否在xxx里打开”

image

总结

不论iOS还是安卓&＃xff0c;在浏览器中完成微信H5支付一般是没有问题的&＃xff0c;这也是微信H5支付设计的应用场景。

不论在iOS还是安卓App上&＃xff0c;接入微信H5支付都可能遇到各种各样的问题&＃xff0c;所以微信官方文档提醒&＃xff1a;

H5支付不建议在APP端使用&＃xff0c;如需要在APP中使用微信支付&＃xff0c;请接APP支付