微信H5网页公众号外支付接入攻略demo

最近在某C论坛中发现有很多的网友在提问和求助自己的网站卖东西，希望可以接入一个支付接口，可以在用户购买后直接在网页上支付。

我在这里发表一下，网站如果希望用户通过在线付款的方式进行付款，就需要申请一种或多种用于进行人民币支付的支付接口。在线支付接口提供商可以是某个商业银行、银联在线支付或者支付宝、微信支付等第三方的支付机构。

这其中微信支付的申请是比较简单的

下面是对申请微信支付接口做简单介绍：

最常用的第三方支付机构如新浪支付微博钱包、支付宝、财付通、快钱、环迅支付、易宝支付等。他们拥有中国人民银行颁发的非金融机构第三方支付许可证。可以为用户提供支付业务服务，如果用第三方支付首选微信支付，简单易 *** 作。

网站接入微信支付实现在线支付功能，通常有两种方式，一种是在微信内部访问网站，然后下单支付；另一种是在微信外部访问网站，然后下单支付。

在微信内部，我们可以通过在公众号聊天窗口发送访问自己网站链接，或者将网站链接发在自己的朋友圈，微信用户都可以在进入下单，点击下单就会唤起微信H5支付，确认金额，输入支付密码即可完成交易。这个是公众号支付申请，之前就已经开放申请了。针对微信内场景支付

在微信外部，我们可以通过触屏手机上自带的浏览器进入网站，唤起微信支付。这个是微信H5支付申请，是在近期开放的。针对的是企业公司的商城网站场景支付。

所以想获得微信支付H5支付接口：

1首先要有公司资质例如营业执照、公司对公账户、网站备案域名、合法居民身份z；

2这些都需要自申请中上传给微信人工审核；

3审核通过后就可以获得微信支付商户平台的账户和密码

4在商户平台里找到申请入口

5进入申请界面填入H5相关设置信息，注意填入的信息一定要和自己的销售商品情况保持一致。

6提交，等待审核，2个工作日左右，审核通过马上获得支付接口

7再将接口和网站接入即可。

对新接触微信支付的企业来说，申请微信支付还是一个比较头疼的事情，遇到申请失败或被驳回、没有备案的公司网站网址域名、需要网站授权函、类目不会选择导致未通过，都可以通过黑河马进行协助解决，代申请包通过。

1、用户在商户侧完成下单，使用微信支付进行支付

2、由商户后台向微信支付发起下单请求（ 调用统一下单接口 ）注：交易类型trade_type=MWEB

3、统一下单接口返回支付相关参数给商户后台，如支付跳转url（参数名“mweb_url”），商户通过mweb_url调起微信支付中间页

4、中间页进行H5权限的校验，安全性检查（此处常见错误请见下文）

5、如支付成功，商户后台会接收到微信侧的异步通知

6、用户在微信支付收银台完成支付或取消支付,返回商户页面（默认为返回支付发起页面）

7、商户在展示页面，引导用户主动发起支付结果的查询

8,9、商户后台判断是否接收到微信侧的支付结果通知，如没有，后台调用我们的 订单查询接口 确认订单状态（查单实现可参考： 支付回调和查单实现指引 ）

10、展示最终的订单支付结果给用户

常见问题

一、回调页面

正常流程用户支付完成后会返回至发起支付的页面，如需返回至指定页面，则可以在MWEB_URL后拼接上redirect_url参数，来指定回调页面。

如，您希望用户支付完成后跳转至 https://www.wechatpay.com.cn ，则可以做如下处理：

假设您通过统一下单接口获到的MWEB_URL= https://wx.tenpay.com/cgi-bin/mmpayweb-bin/checkmweb?prepay_id=wx20161110163838f231619da20804912345&package=1037687096

则拼接后的地址为MWEB_URL= https://wx.tenpay.com/cgi-bin/mmpayweb-bin/checkmweb?prepay_id=wx20161110163838f231619da20804912345&package=1037687096&redirect_url=https%3A%2F%2Fwww.wechatpay.com.cn

注意：

1.需对redirect_url进行urlencode处理

2.由于设置redirect_url后,回跳指定页面的 *** 作可能发生在：

a、微信支付中间页调起微信收银台后超过5秒

b、用户点击“取消支付”或支付完成后点击“完成”按钮。因此无法保证页面回跳时，支付流程已结束，所以商户设置的redirect_url地址不能自动执行查单 *** 作，应让用户去点击按钮触发查单 *** 作。回跳页面展示效果可参考下图

二、其它常见错误

| 网络环境未能通过安全验证，请稍后再试 | 1. 商户侧统一下单传的终端IP(spbill_create_ip)与用户实际调起支付时微信侧检测到的终端IP不一致导致的，这个问题一般是商户在统一下单时没有传递正确的终端IP到spbill_create_ip导致，详细可参见 客户端ip获取指引

2. 统一下单与调起支付时的网络有变动，如统一下单时是WIFI网络，下单成功后切换成4G网络再调起支付，这样可能会引发我们的正常拦截，请保持网络环境一致的情况下重新发起支付流程

|

| 2 |

| 商家参数格式有误，请联系商家解决 |

1. 当前调起H5支付的referer为空导致，一般是因为直接访问页面调起H5支付，请按正常流程进行页面跳转后发起支付，或自行抓包确认referer值是否为空

2. 如果是APP里调起H5支付，需要在webview中手动设置referer，如(

Map<string>extraHeaders = new HashMap<string>()

extraHeaders.put("Referer", "商户申请H5时提交的授权域名")//例如 http://www.baidu.com )</string></string>

|

| 3 |

| 商家存在未配置的参数，请联系商家解决 | 1，当前调起H5支付的域名（微信侧从referer中获取）与申请H5支付时提交的授权域名不一致，如需添加或修改授权域名，请登录商户号对应的【商户平台->产品中心->开发配置】自行配置

2，如果设置了回跳地址redirect_url，请确认设置的回跳地址的域名与申请H5支付时提交的授权域名是否一致 |

| 4 |

| 支付请求已失效，请重新发起支付 | 统一下单返回的MWEB_URL生成后，有效期为5分钟，如超时请重新生成MWEB_URL后再发起支付 |

| 5 |

| 请在微信外打开订单，进行支付 | H5支付不能直接在微信客户端内调起，请在外部浏览器调起 |

| 6 |

| IOS：签名验证失败

安卓：系统繁忙，请稍后再试 | 1，请确认同一个MWEB_URL只被一个微信号调起，如果不同微信号调起请重新下单生成新的MWEB_URL

2，如MWEB_URL有添加redirect_url，请确认参数拼接格式是否有误，是否有对redirect_url的值做urlencode,可对比以下例子格式：

https://wx.tenpay.com/cgi-bin/mmpayweb-bin/checkmweb?prepay_id=wx20161110163838f231619da20804912345&package=1037687096&redirect_url=https%3A%2F%2Fwww.wechatpay.com.cn |

|

|

| 7 |

| 由于商家传入的H5交易参数有误，该笔交易暂时无法完成,请联系商家解决 | 统一下单中 spbill_create_ip 字段必须为客户端IP地址 |

三、QA

Q1：

1、传递redirect_url safari浏览器时支付完成后会新开一个页面；

2、还有就是有些ios手机使用其他浏览器支付完成后默认会回到safari浏览器。

A1：

1、目前逻辑就是这样设计的，防止商户无限循环调用微信客户端

2、对的，返回需要浏览器的schema信息，部分浏览器隐藏了这个信息，在无法拿到schema信息的情况下，就会回到safari浏览器

---