为什么做这个网关

在国内做主机、做 SaaS，客户第一反应就是微信支付。但 WHMCS 是国外产品， 自带的支付方式里没有微信；市面上的老插件大多还停留在早期接口， 新签约的商户根本申请不到那套参数，装上去也跑不通。

聚合支付是另一条路，但要多一层过账、要抽成，客户看到的收款方还不是你自己。

微信支付网关直接对接微信支付的现行接口：境内和跨境两种商户都支持，PC 扫码与手机 H5 两种场景都覆盖，退款也在 WHMCS 后台一键完成。

它能做什么

装好后，客户结账时多出「微信支付」选项。PC 上展示收款二维码，手机上直接唤起支付， 付款成功订单自动结清。

境内与跨境，一个插件都支持

同时支持境内人民币商户和跨境（香港）商户两种模式，在配置里切换即可。 主体在内地就收人民币，主体在境外就走跨境通道，不用为此换插件、换方案。

PC 扫码 + 手机 H5，两种场景都覆盖

客户在电脑上下单，收银台展示二维码，掏出手机扫一扫即可付款； 客户本来就在手机浏览器里，插件自动识别并走手机支付流程，不用再想办法把二维码传到手机上。 两种场景都由插件自动判断，客户端不需要做任何选择。

后台一键退款

管理员在 WHMCS 账单页直接发起退款，不必登录微信商户平台再回来手工改账单状态。 财务对账时两边是同一条记录。

到账通知经过严格校验

微信的付款结果通知会做签名校验与内容解密后才入账，伪造的通知进不来。 日志分两路记录，涉及密钥、证书的敏感字段自动打码，排查问题时可以放心把日志发给技术支持。

三语界面，凭授权自动更新

管理界面提供英文、简体中文、繁体中文，跟随 WHMCS 管理员的语言设置切换。 有新版本时后台会提示，凭授权直接更新，不用每次都去商城重新下载。

适用场景

• 面向国内客户的主机商 / IDC：客户默认用微信付款，支付宝之外必须再有一条
• 手机端下单占比高的站点：需要 H5 支付，而不是让客户自己截图二维码再转到手机
• 香港、新加坡等地的跨境主体：需要跨境商户通道，但不想为此单独找一套系统
• 售后退款频繁的业务：希望客服在 WHMCS 内闭环处理，不用在两个后台之间来回切
• 对资金链路有合规要求的团队：款项直接进自己的商户号，不经第三方过账

安装与使用

1. 从商城下载安装包，解压后把网关目录上传到 WHMCS 站点根目录的 modules/gateways/ 下，保持目录结构不变
2. 进入 WHMCS 管理后台 → 设置 → 支付方式，在「所有支付网关」里找到本网关并激活
3. 选择境内或跨境商户模式，填入商户号、商户证书与密钥，保存
4. 在微信支付商户平台把回调地址配置为插件给出的地址（注意不要带任何查询参数）
5. 下一笔小额测试单，确认二维码展示、付款到账、订单结清三步都正常

运行环境要求：PHP 8.1 及以上、WHMCS 8.10 及以上，服务器需安装 ionCube Loader。 多数主机面板（宝塔、cPanel、Plesk）都可以在 PHP 设置里一键安装， 也可以联系我们的技术支持协助配置。

常见问题

问：需要什么资质才能用？

答：需要你自己在微信支付申请下来的商户号（境内或跨境均可）。插件本身不提供收款资质，也不参与资金流转。

问：手机端客户怎么付款？

答：插件会自动识别手机浏览器并走手机支付流程，客户点一下就唤起微信，不需要扫码。

问：退款要去微信商户平台操作吗？

答：不用。管理员在 WHMCS 账单页即可发起退款，退款结果与账单状态在同一处可查。

问：付款通知安全吗？会不会被伪造？

答：所有到账通知都会先做签名校验与内容解密，校验不通过的通知直接丢弃，不会入账。

问：一份授权可以用在几个站点上？

答：一份授权对应一个站点域名。如果你有多个 WHMCS 站点，需要为每个站点单独获取授权。