Skip to content
Intally

快速开始

快速开始

WHMCS Antom Alipay+ Gateway 让你的 WHMCS 站点接入蚂蚁国际 Antom（Alipay+）支付，覆盖东南亚 16 个本地支付方式：Alipay HK、GCash、KakaoPay、TrueMoney、DANA、AlipayCN、BPI、Maya、BillEase、JKOPAY、BNK Tap & Go、ShopeePay、Touch'n Go、RabbitLINE Pay、MOMO Pay、Boost。本指南覆盖申请商户、配置网关、第一笔交易。

适用对象：东南亚 / 港台日韩业务的 WHMCS 主机商；需要给客户用本地钱包付款。

1. 申请 Antom 商户

  1. 进 Antom Console 注册商户账户
  2. KYC + 业务资料审批（一般 1-3 个工作日）
  3. 通过后控制台拿到： - Client ID - Merchant Private Key (RSA2048) - Antom Public Key

2. 安装与配置

  1. 下载与 PHP 版本匹配的 ZIP 解压到 WHMCS 根目录。
  2. WHMCS 后台 → Setup → Payment Gateways → All Payment Gateways → 找到 "Antom Alipay+ (Direct QR)" → Activate。
  3. 在 Antom 网关配置页填写： - License Key - Antom Client ID - Merchant Private Key（直接粘贴 PEM） - Antom Public Key - Sandbox / Live 模式切换 - 默认支付方式（可选 Alipay+ / 单一方式）
  4. 保存。

3. 客户结账流程

  1. 客户在 WHMCS 选 Antom 网关支付
  2. 插件调 Antom API 创建支付会话
  3. 直接在 WHMCS 结账页内嵌渲染二维码（Direct QR 模式，免跳转上游）
  4. 客户扫描二维码用本地钱包付款
  5. Antom 异步回调 callback/antom.php 通知支付结果
  6. 插件验签后写 WHMCS 发票为已支付

4. 沙箱测试

切换到 Sandbox 模式： - API endpoint 自动切到 open-na.alipay.com - 用 Antom 提供的测试账号扫码 - 不发生真实扣款 - 完整跑通流程验证集成

5. 退款

  • WHMCS 后台 Invoice → Refund 按钮 → 走标准退款流程
  • 插件调 Antom refund API
  • Antom 异步回调返回退款结果

6. 常见问题

Q：支持自动续费吗？ A：当前版本仅一次性付款。Antom recurring 路线图中，待平台支持后跟进。

Q：HMAC 验签失败怎么办？ A：检查 Public Key 是否完整（含 -----BEGIN PUBLIC KEY----- / -----END PUBLIC KEY----- 头尾）。

Q：测试模式下能否切换到生产？ A：可。在网关配置页改 mode → Live + 替换为生产 key 即可，业务订单不受影响。

Q：如果 Antom 回调延迟到达，订单状态怎么处理？ A：Antom 异步回调有 SLA，插件每次回调到达自动幂等更新发票（按 reference_no 去重）。

更多深入文档（API endpoint、HMAC 算法、回调 payload）见商城内的「完整文档」。