微信支付API
产品介绍
开发指引
API列表
JSAPI/小程序下单
POST
JSAPI调起支付
微信支付订单号查询订单
GET
商户订单号查询订单
GET
关闭订单
POST
支付成功回调通知
退款申请
POST
查询单笔退款(通过商户退款单号)
GET
发起异常退款
POST
常见问题
附录
管理商户号绑定的APPID账号
配置JSAPI支付授权目录
配置JSAPI支付授权目录
创建时间: 2025-05-31 23:51

商户使用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.htmlhttps://www.weixin.com/不通过域名大小写不一致
http://www.Weixin.com/abc.htmlhttps://www.weixin.com/123/不通过HTTP协议、域名、目录都不一致
http://www.weixin.com/123/abc.htmlhttps://www.weixin.com/不通过配置到域名,域名与配置的一致,但HTTP协议不一致。配置的是 https:// ,实际支付页面的HTTP协议是 http://
https://www.weixin.com/123/456/abc.htmlhttps://www.weixin.com/123/不通过配置到最后一级目录,实际支付页面的HTTP协议、域名与配置的目录一致,但目录不一致。配置的是 123/,实际支付页面的HTTP协议是 123/456/
https://www.weixin.com/123/abc.htmlhttps://www.weixin.com/123/通过配置到最后一级目录,实际支付页面的HTTP协议、域名、目录与配置的目录完全一致
https://www.weixin.com/123/abc.htmlhttps://www.weixin.com/通过配置到域名,实际支付页面的HTTP协议、域名与配置的完全一致
最后更新: 2 个月前