配置JSAPI支付授权目录

更新时间:2025.06.27

商户使用JSAPI支付,调起微信支付的商户网页地址路径,我们称之为“支付授权目录”,例如:商户支付页面https://www.weixin.com/123/456/abc.html的支付授权目录为:https://www.weixin.com/123/456/,该目录需要与商户微信支付商户平台设置的一致。若不设置支付授权目录将无法调起支付。

支付授权目录配置对象:该权限只有超级管理员可配置,请商户技术人员联系超管配置。

支付授权目录配置规则说明支付授权目录有两种配置形式,根据不同的配置形式,调起支付时的校验规则也会不同。

配置形式

配置示例

校验规则

建议配置场景

只配置到域名

https://www.weixin.com/

只校验实际支付页面协议(https/http)和域名是否与配置的一致,不校验域名后面的多级目录。

有多个拉起支付的页面、域名相同,但多级目录不同时,建议只配置到域名,可缩减配置数量

配置到最后一级目录

https://www.weixin.com/123/456/

会完整校验实际支付页面的协议(https/http)、域名、多级目录是否与配置的一致

支付页面数量不多、对支付页面的目录有明确要求时(例如只允许该目录下的页面进行支付),建议配置到最后一级目录

注意事项:

1、配置的支付授权目录,需要与实际支付页面的目录大小写不一致。

2、一个商户号下,最多支持配置5个支付授权目录。

3、支付授权目录不支持IP格式,不能设置一个“https://192.168.1.1/” 的支付授权目录。

4、支付授权目录必须以“https://”或“http://”开头,后面拼接已通过ICP备案的域名,并以“/”结尾,若需配置多级目录,配置到最后一级目录也需以“/”结尾。

支付授权目录配置指引:登录【商户平台—>产品中心—>开发配置】,设置后一般5分钟内生效。

步骤一:登录商户平台,点击“产品中心-开发配置-支付授权目录-添加”

步骤二:输入支付目录,点击添加按钮

附:常见错误配置示例

实际支付页面的url

配置的支付授权目录

配置结论

说明

https://www.weixin.com/123/456/abc.html

https://www.Weixin.com/

错误

域名大小写不一致,无法拉起支付,应该配置小写“w”

http://www.weixin.com/

错误

协议不一致,无法拉起支付,应该配置https。

https://www.weixin.com/abc/

错误

目录不一致,无法拉起支付。

https://www.weixin.com/123/

错误

未配置到最后一级支付目录

https://www.weixin.com/456/

错误

丢失了中间目录

https://www.weixin.com/123 或者

https://www.weixin.com

错误

配置的支付授权目录必须以“/”结尾

https://192.168.1.1/

错误

配置的支付授权目录不支持IP格式

 

更多技术问题
技术咨询
反馈
咨询
目录
置顶