配置JSAPI支付授权目录
更新时间:2025.06.27商户使用JSAPI支付,调起微信支付的商户网页地址路径,我们称之为“支付授权目录”,例如:商户支付页面https://www.weixin.com/123/456/abc.html
的支付授权目录为:https://www.weixin.com/123/456/
,该目录需要与商户在微信支付商户平台设置的一致。若不设置支付授权目录将无法调起支付。
支付授权目录配置对象:该权限只有超级管理员可配置,请商户技术人员联系超管配置。
支付授权目录配置规则说明:支付授权目录有两种配置形式,根据不同的配置形式,调起支付时的校验规则也会不同。
配置形式 | 配置示例 | 校验规则 | 建议配置场景 |
---|---|---|---|
只配置到域名 | https://www.weixin.com/ | 只校验实际支付页面协议(https/http)和域名是否与配置的一致,不校验域名后面的多级目录。 | 有多个拉起支付的页面、域名相同,但多级目录不同时,建议只配置到域名,可缩减配置数量 |
配置到最后一级目录 | https://www.weixin.com/123/456/ | 会完整校验实际支付页面的协议(https/http)、域名、多级目录是否与配置的一致 | 支付页面数量不多、对支付页面的目录有明确要求时(例如只允许该目录下的页面进行支付),建议配置到最后一级目录 |
|
支付授权目录配置指引:登录【商户平台—>产品中心—>开发配置】,设置后一般5分钟内生效。
步骤一:登录商户平台,点击“产品中心-开发配置-支付授权目录-添加” | 步骤二:输入支付目录,点击添加按钮 |
---|---|
|
|
附:常见错误配置示例
实际支付页面的url | 配置的支付授权目录 | 配置结论 | 说明 |
---|---|---|---|
https://www.weixin.com/123/456/abc.html | https://www.Weixin.com/ | 错误 | 域名大小写不一致,无法拉起支付,应该配置小写“w” |
http://www.weixin.com/ | 错误 | 协议不一致,无法拉起支付,应该配置https。 | |
https://www.weixin.com/abc/ | 错误 | 目录不一致,无法拉起支付。 | |
https://www.weixin.com/123/ | 错误 | 未配置到最后一级支付目录 | |
https://www.weixin.com/456/ | 错误 | 丢失了中间目录 | |
https://www.weixin.com/123 或者 https://www.weixin.com | 错误 | 配置的支付授权目录必须以“/”结尾 | |
https://192.168.1.1/ | 错误 | 配置的支付授权目录不支持IP格式 |