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

>更新时间：2024.12.20

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

支付授权目录两种配置方式：

1、服务商为全体子商户设置支付授权目录，设置路径：登录【[微信支付服务商平台](https://pay.wechatpay.cn/index.php/partner/public/home)—>产品中心—>开发配置】，设置后一般5分钟内生效。

2、服务商为某一子商户单独设置支付授权目录，设置路径：登录【[微信支付服务商平台](https://pay.wechatpay.cn/index.php/partner/public/home)—>合作伙伴功能—>商户基础服务->开发配置参数->搜索子商户号->点击“开发配置”】，设置后一般5分钟内生效。

| 服务商为全体子商户设置支付授权目录 | 服务商为某一子商户单独设置支付授权目录 |
| --- | --- |
| ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/ebe096c61f6018948b489601e66d1905.png) | ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/52bf8dfe352e205487e415aea7c23323.png) |

支付授权目录校验规则说明：

支付授权目录有两种配置形式，根据不同的配置形式，调起支付时的校验规则也会不同，具体区别如下：

| 配置形式 | 校验规则 | 建议配置场景 |
| --- | --- | --- |
| 只配置到域名 | 只校验实际支付页面的HTTP协议和域名是否与配置的一致，不校验域名后面的多级目录。 | 有多个支付页面的HTTP协议、域名相同，但多级目录不同时，建议只配置到域名，可缩减配置数量 |
| 配置到最后一级目录 | 会完整校验实际支付页面的HTTP协议、域名、多级目录是否与配置的一致 | 支付页面数量不多、对支付页面的目录有明确要求时（例如只允许该目录下的页面进行支付），建议配置到最后一级目录 |

注意事项：

1、在校验实际支付页面的目录与配置的支付授权目录是否匹配时，需区分大小写，大小写不一致的会判断为不匹配。

2、服务商最多为全体子商户设置配置5个支付授权目录，服务商也可为每个子商户单独设置5个支付授权目录。

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

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

配置示例：

| 实际支付页面的url | 建议的配置形式 | 配置示例 |
| --- | --- | --- |
| https://www.weixin.com/123/abc.html | 配置到域名 | https://www.weixin.com/ |
| https://www.weixin.com/123/abc.html | 配置到最后一级目录 | https://www.weixin.com/123/ |

支付授权目录校验结果相关示例：

| 实际支付页面的url | 配置的支付授权目录 | 校验结果 | 说明 |
| --- | --- | --- | --- |
| https://www.Weixin.com/abc.html | https://www.weixin.com/ | 不通过 | 域名大小写不一致 |
| http://www.Weixin.com/abc.html | https://www.weixin.com/123/ | 不通过 | HTTP协议、域名、目录都不一致 |
| http://www.weixin.com/123/abc.html | https://www.weixin.com/ | 不通过 | 配置到域名，域名与配置的一致，但HTTP协议不一致。<br>配置的是 https:// ，实际支付页面的HTTP协议是 http:// |
| https://www.weixin.com/123/456/abc.html | https://www.weixin.com/123/ | 不通过 | 配置到最后一级目录，实际支付页面的HTTP协议、域名与配置的目录一致，但目录不一致。<br>配置的是 123/，实际支付页面的HTTP协议是 123/456/ |
| https://www.weixin.com/123/abc.html | https://www.weixin.com/123/ | 通过 | 配置到最后一级目录，实际支付页面的HTTP协议、域名、目录与配置的目录完全一致 |
| https://www.weixin.com/123/abc.html | https://www.weixin.com/ | 通过 | 配置到域名，实际支付页面的HTTP协议、域名与配置的完全一致 |