资讯 / 文章页

网页里调不起微信支付,是业务域名没配好吗?先看官方对支付授权目录的说明

微信外链
2026-11-20

网页里调不起微信支付时,有人会先去改业务域名,以为一定是这一项没配好。官方对「支付授权目录」的说明,并不把这项配置放在公众号或服务号的业务域名表里。2026年11月20日(北京时间)阅读的微信支付商户文档《配置JSAPI支付授权目录》,页标为「更新时间:2025.07.15」。该页写明:商户使用JSAPI支付,调起微信支付的商户网页地址路径称为「支付授权目录」,该目录需要与商户在微信支付商户平台设置的一致;若不设置支付授权目录将无法调起支付。同一天对照阅读的微信开放文档《域名管理》,页标为「最后一次编

https://cdn2.quma.cn/uploads/2/2026/11/20/FgzJW7MuzhAPdlDS7Tjp2chIalfr.jpg辑于 2026-07-04」,其中服务号列有JS接口安全域名、业务域名和网页授权域名,并不包含支付授权目录。下面按当场页面转述支付授权目录的对象、配置位置和校验规则;业务域名和网页授权域名只作分界,不重写成三类域名总论。


调不起支付,官方指向的是商户平台里的支付授权目录


《配置JSAPI支付授权目录》把配置位置写在微信支付商户平台,而不是公众号或服务号后台的业务域名项。配置指引写的是:登录「商户平台—>产品中心—>开发配置」,设置后一般5分钟内生效。步骤说明还写:登录商户平台,点击「产品中心-开发配置-支付授权目录-添加」,再输入支付目录并添加。该页同时写明「支付授权目录配置对象」:该权限只有超级管理员可配置,请商户技术人员联系超管配置。这些是文档中的配置位置和权限说明,本文未登录商户平台核验后台菜单,也不把「一般5分钟内生效」写成每一次都会在五分钟内完成。


作为对照,《域名管理》在服务号部分写的是另外三类对象。该页称:设置服务号业务域名后,在微信内访问该域名下页面时,不会被重新排版;其操作路径是「微信公众平台 - 设置与开发 - 账号设置 - 功能设置 - 业务域名」。同页对服务号网页授权域名的说明是:设置后,微信网页应用可在该域名下实现微信网页应用的授权登录功能。支付授权目录没有出现在这一页的公众号或服务号域名表里。因此,把「网页里调不起微信支付」直接理解成「一定是业务域名没配好」,并不符合这两份文档各自写下的对象。这不是说业务域名不可能另有问题,而是不能把两个配置对象当成同一件事。


支付授权目录指的是哪一层路径


文档给「支付授权目录」下的定义是:商户使用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个支付授权目录。第三,支付授权目录不支持IP格式,并举例不能设置一个「https://192.168.1.1/」的支付授权目录。第四,支付授权目录必须以「https://」或「http://」开头,后面拼接已通过ICP备案的域名,并以「/」结尾;若需配置多级目录,配置到最后一级目录也需以「/」结尾。


该页「常见错误配置示例」以实际支付页面https://www.weixin.com/123/456/abc.html为例,把若干写法标为错误,并说明了原因:域名大小写不一致(例如把weixin写成Weixin),无法拉起支付;协议不一致,例如页面是https却配置成http;目录不一致,或未配置到最后一级支付目录,或丢失了中间目录;配置写成https://www.weixin.com/123或者https://www.weixin.com,不以「/」结尾;以及使用IP格式。这些示例是文档对错误写法的说明,未在本环境按各条实际调起支付做复现。


报「当前页面的URL未注册」时,应先核支付目录


同一产品线下的《常见问题》页,页标为「更新时间:2026.08.05」,把「当前页面的URL未注册」单独列为JSAPI调起支付的报错。其中一问的解答是:「请参考配置JSAPI支付目录。」另一问在「当前页面的URL未注册」后还带了示例地址,解答为:「请检查下单接口中使用的商户号是否在商户平台配置了对应的支付目录。」两处都把核对应放到支付目录或商户平台中的配置,而不是业务域名。本文未复现该报错,也不把文档中的提示写成「改完支付授权目录后一定恢复」。


如果问题出在获取openid这一层,对象又不同。上述常见问题页另有一问:「JSAPI调起支付报错:redirect_url域名与后台配置不一致,错误码:10003」。解答写明:本错误是公众号获取openid接口报的错误;并提示检查下单接口所传appid与获取openid接口的appid是否为同一个,以及appid对应的公众号后台里,配置的授权域名是否和获取openid的域名一致。该页给出的授权域名配置路径是「公众平台--设置--公众号设置--功能设置--网页授权域名」。《域名管理》页对服务号网页授权域名的操作路径则写为「微信公众平台 - 设置与开发 - 账号设置 - 功能设置 - 网页授权域名」。两页路径表述不完全相同,这里只并列记下,不自行合成一条,也不把10003改写成本篇的支付授权目录问题。获取openid可能涉及网页授权域名,那是另一层配置对象,应回到相应说明核对,而不要和支付授权目录、业务域名混成一项。


核对该类问题时,可以先分清:调起支付的页面路径是否已按商户平台的支付授权目录规则设置,并与实际页面的协议、域名、大小写和目录形式一致;业务域名管的是微信内访问时是否被重新排版,并不能代替支付授权目录;若提示的是10003或获取openid失败,再去看网页授权域名那一层。具体能否调起,以微信支付商户平台和当场有效的官方说明为准。本文不提供绕过校验的方法,也不把趣码写成具备微信支付能力的产品。


参考资料


[1] 微信支付商户文档:《配置JSAPI支付授权目录》 https://pay.weixin.qq.com/doc/v3/merchant/4013287088,页标「更新时间:2025.07.15」,访问日期2026年11月20日(北京时间)。本文主要转述支付授权目录的定义、配置对象、两种配置形式及校验规则、注意事项、配置指引和常见错误配置示例。


[2] 微信支付商户文档:JSAPI支付《常见问题》 https://pay.weixin.qq.com/doc/v3/merchant/4012791869,页标「更新时间:2026.08.05」,访问日期2026年11月20日(北京时间)。引用范围限于「当前页面的URL未注册」两处问答,以及「redirect_url域名与后台配置不一致,错误码:10003」的排查说明;不展开其他报错。


[3] 微信开放文档:《域名管理》 https://developers.weixin.qq.com/doc/oplatform/developers/basic_func/domain,页标「最后一次编辑于 2026-07-04」,访问日期2026年11月20日(北京时间)。仅对照服务号业务域名、网页授权域名与JS接口安全域名的对象和操作路径,说明支付授权目录不在该页域名表中;不重写三类域名总论。

购买咨询
微信扫码咨询
400-600-7511