---
url: "https://pay.weixin.qq.com/doc/v3/merchant/4013287088.md"
title: "配置JSAPI支付授权目录"
doc_id: 4013287088
---

>更新时间：2025.07.15

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

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

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

| 配置形式 | 配置示例 | 校验规则 | 建议配置场景 |
| --- | --- | --- | --- |
| 只配置到域名 | 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备案的域名，并以“/”结尾，若需配置多级目录，配置到最后一级目录也需以“/”结尾。

支付授权目录配置指引：登录【[商户平台](https://pay.wechatpay.cn/)—>产品中心—>开发配置】，设置后一般5分钟内生效。

| 步骤一：登录商户平台，点击“产品中心-开发配置-支付授权目录-添加” | 步骤二：输入支付目录，点击添加按钮 |
| --- | --- |
| ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/6a372fbeeaddd5ec618914140b75f126.png) | ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/bde07c579c7043e9b78ab1a404f862a4.png) |

附：常见错误配置示例

| 实际支付页面的url | 配置的支付授权目录 | 配置结论 | 说明 |
| --- | --- | --- | --- |
| https://www.weixin.com/123/456/abc.html | https://www.Weixin.com/ | 错误 | 域名大小写不一致，无法拉起支付，应该配置小写“w” |
| https://www.weixin.com/123/456/abc.html | http://www.weixin.com/ | 错误 | 协议不一致，无法拉起支付，应该配置https。 |
| https://www.weixin.com/123/456/abc.html | https://www.weixin.com/abc/ | 错误 | 目录不一致，无法拉起支付。 |
| https://www.weixin.com/123/456/abc.html | https://www.weixin.com/123/ | 错误 | 未配置到最后一级支付目录 |
| https://www.weixin.com/123/456/abc.html | https://www.weixin.com/456/ | 错误 | 丢失了中间目录 |
| https://www.weixin.com/123/456/abc.html | https://www.weixin.com/123 或者<br>https://www.weixin.com | 错误 | 配置的支付授权目录必须以“/”结尾 |
| https://www.weixin.com/123/456/abc.html | https://192.168.1.1/ | 错误 | 配置的支付授权目录不支持IP格式 |