配置JSAPI支付授权目录

更新时间:2024.12.17

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

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

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

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

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

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

配置形式

校验规则

建议配置场景

只配置到域名

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

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

配置到最后一级目录

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

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

注意事项:

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

2、一个商户号下,最多配置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/

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

实际支付页面的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协议不一致。

配置的是 https:// ,实际支付页面的HTTP协议是 http://

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

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

不通过

配置到最后一级目录,实际支付页面的HTTP协议、域名与配置的目录一致,但目录不一致。

配置的是 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协议、域名与配置的完全一致

 

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