常见问题
更新时间：2025.10.15Q：调起H5支付报"商家参数格式有误，请联系商家解决"
A：请按以下几点进行排查：
1、当前调起H5支付的referer为空导致，一般是因为直接访问h5_url调起H5支付导致的，请按正常流程进行页面跳转后发起支付，或自行抓包确认referer值是否为空。
2、如果是App里调起H5支付，需要在webview中手动设置referer，如(Map extraHeaders = new HashMap();extraHeaders.put("Referer", "商户申请H5时提交的授权域名");//例如 https://pay.wechatpay.cn )
Q：调起H5支付时出现 “商家存在未配置的参数，请联系商家解决”报错，该如何排查？
A：出现「图1」错误时，请登录商户平台，进入【产品中心】>【开发配置】中查看“H5支付”栏目下当前商户号配置的H5支付域名，可参考查看和配置H5支付域名指引。
获取已配置的域名后，请逐一检查以下两项是否与该域名完全一致：
1、检查支付发起页面的域名
确认您当前集成并调起H5支付的网页，其地址栏中的域名（不含http://或https://）是否与商户平台中配置的H5支付域名完全一致，可以参考「图 2」来查看地址栏的域名。
示例：若配置的域名为pay.example.com，则调起H5支付的页面域名也必须是pay.example.com，而不能是www.example.com或其他子域名。
2、检查支付成功后的回跳地址域名（如已设置）
调起H5支付时，若在
h5_url参数后拼接了redirect_url回跳地址参数（用于指定支付成功后返回的页面），需确保该回跳地址的域名与商户平台配置的H5支付域名完全一致。
如果检查发现不一致，请将相关域名修改为与商户平台配置完全一致的域名后重试。
图1：报错场景示例 | 图2：查看调起H5支付页面的地址栏域名 |
|---|---|
|
|
Q：调起H5支付报"支付请求已失效，请重新发起支付"
A：下单获取的支付跳转链接有效期为5分钟，超过有效期后需要重入下单接口获取新的支付跳转链接。
Q：调起H5支付报" 请在微信外打开订单，进行支付"
A：H5支付不能直接在微信客户端内调起，请在外部浏览器调起，如需在微信内部浏览器拉起支付，请使用JSAPI支付。
Q：调起H5支付报" 签名验证失败"或“系统繁忙，请稍后再试”
A：请按以下几点进行排查：
1、请确认同一个h5_url只被一个微信号调起，如果不同微信号调起请重新下单生成新的H5_URL。
2、如h5_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
3、请确认h5_url链接是否完整，是否与下单接口返回的h5_url一致
IOS：签名验证失败 安卓：系统繁忙，请稍后再试
Q：调起H5支付报" 由于商家传入的H5交易参数有误，该笔交易暂时无法完成，请联系商家解决”
A：下单参数中 payer_client_ip 字段必须为客户端IP地址，不能填127.0.0.1
Q：H5支付场景中，用户不安装微信客户端也可以完成支付么？
A：不能，必须安装微信客户端。
Q：申请H5支付权限被驳回，驳回原因：目前该类业务形态不支持暂不支持开通 H5 支付进行收款，请使用其他支付方式。
A：不支持业务形态包括但不限于微信支付商户不支持的经营场景。
