官方文档
普通商户版-微信H5支付
服务商版-微信H5支付
微信h5得单独去商户号申请开通,加上对应的正式域名(该域名在微信商户号上面添加)。
详细支付流程介绍
1、用户在商户侧完成下单,使用微信支付进行支付
2、由商户后台向微信支付发起下单请求(调用统一下单接口)注:交易类型trade_type=MWEB
3、统一下单接口返回支付相关参数给商户后台,如支付跳转url(参数名“mweb_url”),商户通过mweb_url调起微信支付中间页
4、中间页进行H5权限的校验,安全性检查(此处常见错误请见下文)
5、如支付成功,商户后台会接收到微信侧的异步通知
6、用户在微信支付收银台完成支付或取消支付,返回商户页面(默认为返回支付发起页面)
7、商户在展示页面,引导用户主动发起支付结果的查询
8,9、商户后台判断是否接到收微信侧的支付结果通知,如没有,后台定时调用我们的订单查询接口确认订单状态
10、展示最终的订单支付结果给用户
常见错误:
1、网络环境未能通过安全验证,请稍后再试(IP改变导致的)
2、商家参数格式有误,请联系商家解决(H5支付的referer为空导致)
3、商家存在未配置的参数,请联系商家解决(H5支付的域名问题)
4、支付请求已失效,请重新发起支付(有效期为5分钟)
5、请在微信外打开订单,进行支付(H5支付不能直接在微信客户端内调起)
详细错误问题讲解:
1.1. :用户统一下单的spbill_create_ip,一定要是正式域名下获取的然后进行统一下单,且在正式站去换起微信客户端去支付。IP(spbill_create_ip)与用户实际调起支付时微信侧检测到的终端IP要一致。
2.1. 当前调起H5支付的referer
为空导致,一般是因为直接访问页面调起H5支付,请按正常流程进行页面跳转后发起支付,或自行抓包确认referer
值是否为空
2.1.1. APP里调起H5支付,需要在webview中手动设置referer,如
(Map extraHeaders = new HashMap();
extraHeaders.put(“Referer”, “商户申请H5时提交的授权域名”);
//例如 http://www.baidu.com ) )
– 需要注意,如果使用微信官方提供的示例H5:
https://wxpay.wxutil.com/mch/pay/h5.v2.php
得配置与之相对应的域名: wxpay.wxutil.com
2.1.2. 网页调取支付H5支付,统一下单返回的mweb_url ,必须要获取h5支付页面自带的referer才行(问题是当前调起H5支付的referer为空导致),得用到生成mweb_url 的页面直接提交或者form的自动提交
PHP页面代码:
- 2种错误原因,1是mweb_url 跳转提交到对应域名不是商户申请H5时提交的授权域名
2.是 返回mweb_url 请求过程中被截取了一部分可能会有下面的错误
3.1.1. 因为跳转的mweb_url不完整,会出现微信h5支付 安卓系统能支付,ios换起不了微信
(1.package为空时,Android可调用微信支付,但IOS不行
2.package参数必需不能为空
如: https://wx.tenpay.com/cgi-bin/mmpayweb-bin/checkmweb?prepay_id=wx20171017112849d63fcc65920397083586&package=1586452094)
此处的问题解决方案:网页跳转换起微信客户端有中间页(跳转换起时间一般是2-3s),可复制浏览器上面的url可发现mweb_url 没有后面的&package=1586452094,后面的&已经被转义,保证跳转前mweb_url有&package=1586452094就好,若被转义就替换或者用urlencode(mweb_url)
3.1.2. 若支付完成要跳转到页面页面对应页面 则在统一下单返回的mweb_url.'&redirect_url'.urlencode('www.wechatpay.com.cn')(redirect_url要用urlencode包括起来进去跳转)拼接后格式: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
追加的redirect_url的 网址 ,一是支付成功后点击微信页面 ‘完成’,跳转到对应页面,若没跳转则刷新一下页面即可。二是网页成功换起微信后,支付过程中(未支付成功)直接点击微信客户端左上角 返回
页面也会跳转到redirect_url
4.1.1.和 5.1.2. 微信统一下单返回的mweb_url 有效期为5分钟且要在微信外浏览器打开即可。