微信支付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.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协议、域名与配置的完全一致 |
最后更新: 2 个月前