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 結帳頁內嵌渲染 QR Code（Direct QR 模式，免跳轉上游）
  4. 客戶掃描 QR Code 用本地錢包付款
  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）見商城內的「完整文件」。