微信支付开发本地接收异步通知回调【实战】

访问我的博客

前言

最近在调试微信相关的接口,但是由于微信官方出于安全的考虑,对于调用接口的域名有限制。微信授权与微信支付统一下单接口在本地可以通过更改 host 的方式来调试,微信服务器也能跳转回来,但是微信支付异步通知这里;微信官方强制让设置支付授权目录,且是通过 ICP 备案的域名,因此不采取特殊手段,本地是无法接收到微信的异步通知回调请求的,只能部署到线上环境测试

前置条件

为了解决这个问题,折腾了好几天,才搞出来了,究其根本原因,还是对于 Nginx 不太熟悉。所以在此记录一下。

内网转发

如果想本地进行调试,并且想让微信服务器请求回调回来,则本地必须要有一个外网域名,这里我们是用 Ngrok内网转发 来实现;Ngrok 的配置就是将本地项目的端口映射到分配的外网域名,具体配置参考官网教程文档,此处不再赘述。

我的配置是:

http://topn.free.ngrok.cc -> 127.0.0.1:8080

配置测试支付目录

前面提到了,微信支付异步通知会对支付域名目录有要求,因此,支付时的域名必须要在设置的支付域名目录下。

首先需要在 微信商户平台 中配置 商户秘钥,支付授权目录。

微信支付开发本地接收异步通知回调【实战】

这里支付授权目录配置的是以后线上的支付授权目录

http://pay.domain.com/wechat/public/

然后再加一条本地测试支付的临时授权目录,这个目录最好在本地测试完成后,进行删除。

http://pay.domain.com/testpay/

必知的 Nginx 语法

proxy_pass 后的 url 加不加 / 的区别

这里列举 nginx 的 proxy_pass 语法,是为了下一步针对 nginx 的配置进行修改。

这里访问 http://127.0.0.1/proxy/test.html 测试 proxy_pass 后面的 url 加与不加 / 的区别

server {
    listen       80;
    server_name 127.0.0.1;

    location  /proxy/ {
          proxy_pass http://192.168.0.100/;
    }
}

以上 location 会代理到 http://192.168.0.100/test.html 即相当于是绝对根路径,则 Nginx 不会把 location 中的路径部分代理走。

server {
    listen       80;
    server_name 127.0.0.1;

    location  /proxy/ {
          proxy_pass http://192.168.0.100;
    }
}

以上 location 会代理到 http://192.168.0.100/proxy/test.html 即相当于相对路径。


代理支付域名到第三方域名

知道上一步 proxy_pass 后 / 的作用后,就开始来配置支付域名指向的服务器上的 nginx 的配置文件。

server {
    listen       80;
    server_name pay.domain.com;

    location /testpay/ {
        proxy_set_header Host vcmq.free.ngrok.cc;
        proxy_pass http://vcmq.free.ngrok.cc/wide/;
    }
    
    location / {
        proxy_pass http://payServer;
    }
}

配置中的 wide 是我项目的名称;
注意:这里的 proxy_set_header Host 必须配置,否则进入 location 块后,会提示 tunnel pay.domain.com not found

当访问 pay.domain.com/testpay/create 微信统一下单接口时, 会代理到 http://vcmq.free.ngrok.cc/wide/create

需要注意的是,在统一下单接口,设置 notify_url 的值要为配置的支付授权目录,比如我的 http://pay.domain.com/testpay/notify,这个异步通知回调 URL 限定是 POST 请求,可以在异步回调方法打断点,然后通过 postman 工具发送 post 请求到 http://pay.domain.com/testpay/notify,看是否可以正常进入断点,如果正常进入断点,恭喜你配置好了 Nginx 回调这一块。

注意: 统一下单接口参数中提交的参数 notify_url ,如果链接无法访问,商户将无法接收到微信通知。
通知 url 必须为直接可访问的 url ,不能携带参数。示例:notify_url:“https://pay.weixin.qq.com/wxpay/pay.action

另外要注意,如果支付目录中配置的是 https 的,那么 notify_url 也一定要保持一致是 https 的。

统一下单并完成支付完成后,微信服务器会请求统一下单接口中的 notify_url,经过服务器 nginx 进行代理后,会代理到 本地的内网转发域名异步通知回调接口 http://vcmq.free.ngrok.cc/wide/notify, 从而达到了本地接收微信支付异步通知回调请求的目的。

如果地址不在支付授权目录下,会提示当前 Url 未注册。因为是代理过去,因此地址栏的地址不会改变,这也是不能简单使用 nginx 的 rewrite 的原因。

如有疑问,可以联系我。

参考

微信支付开发本地接收异步通知回调【实战】

上一篇:C++ Primer Plus学习笔记之静态成员


下一篇:Java 方法调用