H5调用微信支付常见问题：如何正确配置支付域名？

Question

**H5调用微信支付时，如何正确配置支付域名？常见问题有哪些？** 在H5页面中调用微信支付时，需在微信公众平台或微信商户平台正确配置“支付域名”，否则会报错“当前页面的URL未注册”。常见问题包括： 1. **域名未备案**：支付域名必须已完成ICP备案。 2. **协议或路径不匹配**：微信校验时严格要求请求URL与配置域名完全一致（包括http/https、端口和路径）。 3. **跨域跳转问题**：用户需直接在配置域名下发起支付，中间跳转可能导致校验失败。 4. **多级子域名未单独配置**：如 `pay.example.com` 与 `m.example.com` 需分别添加。 5. **缓存问题**：修改配置后未及时清除浏览器或服务器缓存导致依旧报错。 建议开发者在配置完成后使用微信官方工具检测域名有效性，确保支付流程顺利。

Answer 1

一、H5调用微信支付时，如何正确配置支付域名？

在H5页面中调用微信支付时，开发者需要在微信商户平台配置“支付域名”，否则会遇到“当前页面的URL未注册”的错误提示。该配置是微信支付安全机制的一部分，用于防止非法页面调用支付接口。

1. 配置步骤

1. 登录微信商户平台：https://pay.weixin.qq.com
2. 进入【产品中心】-【开发配置】-【H5支付】
3. 在“支付域名”栏填写完整的域名，如：https://pay.example.com
4. 保存后等待微信审核生效

2. 注意事项

• 域名必须已完成ICP备案
• 必须使用http或https协议，不能是IP地址或localhost
• 微信支付校验时严格匹配协议、端口和路径

二、常见问题与解决方案

1. 域名未备案

微信要求所有支付域名必须完成ICP备案。若未备案，即使域名已解析，也会被拒绝。

问题	解决方案
域名未备案	联系域名服务商进行备案，备案成功后再配置支付域名

2. 协议或路径不匹配

微信支付校验时对URL要求非常严格，包括协议（http/https）、端口、路径都必须一致。

错误示例：
https://pay.example.com/pay.html
实际调用地址为：
http://pay.example.com/pay.html

3. 跨域跳转问题

如果用户通过跳转链接进入支付页面，而非直接访问配置域名下的页面，微信支付会拒绝请求。

graph TD A[用户点击跳转] --> B[跳转至非配置域名] B --> C[调用微信支付失败] D[用户直接访问配置域名] --> E[调用微信支付成功]

4. 多级子域名未单独配置

不同子域名需要分别配置。例如：pay.example.com 与 m.example.com 是两个不同的域名，需分别添加。

配置域名	允许的调用页面	不允许的调用页面
https://pay.example.com	https://pay.example.com/order/123	https://m.example.com/order/123

5. 缓存问题

修改支付域名配置后，需清除浏览器缓存、CDN缓存或服务器缓存，否则可能仍报错。

解决方案：
- 清除浏览器缓存
- 刷新CDN缓存
- 重启服务或刷新服务器配置

三、验证与调试建议

微信官方提供了支付域名检测工具，开发者可在商户平台使用该工具验证域名是否配置正确。

• 工具入口：商户平台 → 产品中心 → H5支付 → 域名检测
• 建议在正式上线前多次测试不同页面路径