为什么做这个网关

做跨境生意的主机商都遇到过同一件事：客户在海外，手里是支付宝，账单却是美元或港币。 WHMCS 自带的支付方式里没有境外支付宝，第三方聚合支付要抽成、要过账、到账还慢， 而自己对接又要处理签名、汇率、回调去重这些琐碎又容易出错的细节。

退款更麻烦。钱收的是外币，退的时候要按原始交易退回，很多网关干脆不做退款， 只能让财务登录支付宝后台手工操作，再回 WHMCS 手工改账单状态——两边对不上是常事。

境外支付宝网关把这条链路补齐：直连支付宝跨境收款，多币种、自动换汇，退款在 WHMCS 账单页一键完成。

它能做什么

装好后，客户结账时多出一个「支付宝」选项，扫码或跳转支付页付款，到账后订单自动标记已付。 整个过程不经过任何第三方中转。

10 种收款币种，汇率由你掌控

支持美元、港币、欧元、英镑、澳元、新币、纽币、日元、泰铢、韩元共 10 种收款币种。 你在网关设置里维护汇率，下单金额自动按它换算——你在 WHMCS 里按本币定价， 客户按自己熟悉的币种付款，不需要为每个币种单独维护一张价目表。 汇率完全由你自己设定，插件不向任何外部站点请求汇率，发票页零第三方网络请求。

扫码与跳转两种收款方式

PC 端展示收款二维码，客户用手机支付宝扫码即可；也可以直接跳转到支付宝的收银台完成支付。 支付页用当前客户区主题渲染，风格统一；二维码有内置兜底方案，网络异常时也不会开天窗。

后台一键退款，精确匹配原始交易

管理员在 WHMCS 账单页点一下就能发起外汇退款。下单时的关键信息会持久化保存， 退款请求按原始交易精确匹配，不会退错单；失败时给出可读的原因提示，不是一串错误码。 客户用于账户充值的款项被退回时，余额会同步扣减，账目自然对得上。

到账不重复、不遗漏

支付宝的异步通知和客户付款后的同步跳转都会触发入账，插件对两条路径做去重， 同一笔款只入账一次；客户中途关掉浏览器，异步通知照样把订单结清。

双验签模式，兼容新版 PHP

同时支持 MD5 与 RSA 两种验签方式，按你在支付宝侧开通的模式选择即可， 在 PHP 8.x 上验证通过。另有沙盒模式，正式收款前可以先跑通全流程。

适用场景

• 面向海外华人客户的主机商：客户习惯用支付宝，但你的产品用美元或港币定价
• 跨境电商、SaaS、订阅制服务：需要多币种收款，又不想被聚合支付抽一道成
• 有退款需求的业务：售后频繁，需要让客服在 WHMCS 里直接退款而不是登录支付宝手工操作
• 允许客户预充值的站点：充值退款要能自动扣回余额，避免人工调账出错
• 正在做支付合规改造的团队：需要直连官方接口、款项直接进自己的商户账户

安装与使用

1. 从商城下载安装包，解压后把网关目录上传到 WHMCS 站点根目录的 modules/gateways/ 下，保持目录结构不变
2. 进入 WHMCS 管理后台 → 设置 → 支付方式，在「所有支付网关」里找到本网关并激活
3. 填写支付宝跨境商户的合作伙伴身份与密钥，选择验签模式与收款币种，保存
4. 先开启沙盒模式下一笔测试单，确认扫码、回调、订单状态三步都正常
5. 关闭沙盒模式正式启用；退款按钮出现在管理后台的账单详情页

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

常见问题

问：钱会经过你们吗？

答：不会。这是直连支付宝官方接口的网关，款项直接进入你自己的商户账户，我们不参与资金流转，也不抽成。

问：客户付款后网络断了，订单会不会一直挂着未付？

答：不会。支付宝的异步通知会独立把订单结清，与客户是否回到你的网站无关；两条入账路径之间做了去重，不会重复入账。

问：退款需要登录支付宝后台吗？

答：不需要。管理员在 WHMCS 账单页即可发起退款，插件按原始交易精确匹配；失败时会给出可读的原因说明。

问：汇率是怎么算的？

答：你在网关设置里维护「USD to HKD」「HKD to CNY」两个汇率，下单金额按它自动换算。汇率完全由你掌控，插件不向任何外部站点请求汇率；建议定期核对，保持与市场汇率一致。

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

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