Skip to content
Intally

Quick start

Quick start

WHMCS Antom Alipay+ Gateway brings Ant International's Antom (Alipay+) payments to WHMCS, covering 16 local payment methods across South-East Asia and Greater China: Alipay HK, GCash, KakaoPay, TrueMoney, DANA, AlipayCN, BPI, Maya, BillEase, JKOPAY, BNK Tap & Go, ShopeePay, Touch'n Go, RabbitLINE Pay, MOMO Pay, Boost. This guide covers merchant onboarding, gateway config, and the first transaction.

For WHMCS hosts running SEA / Greater China / Japan / Korea businesses needing local-wallet payment.

1. Antom merchant onboarding

  1. Sign up at the Antom Console
  2. KYC + business docs (typically 1–3 business days)
  3. After approval, the console gives you: - Client ID - Merchant Private Key (RSA2048) - Antom Public Key

2. Install and configure

  1. Download the ZIP matching your PHP version and extract into your WHMCS root.
  2. WHMCS admin → Setup → Payment Gateways → All Payment Gateways → find "Antom Alipay+ (Direct QR)" → Activate.
  3. Fill on the Antom gateway config page: - License Key - Antom Client ID - Merchant Private Key (paste PEM directly) - Antom Public Key - Sandbox / Live mode toggle - Default payment method (Alipay+ aggregated or specific method)
  4. Save.

3. Customer checkout flow

  1. Customer picks Antom gateway in WHMCS checkout
  2. Plugin calls Antom API to create a payment session
  3. QR code renders inline on the WHMCS checkout page (Direct QR mode — no upstream redirect)
  4. Customer scans the QR with their local wallet
  5. Antom posts an async callback to callback/antom.php with payment result
  6. Plugin verifies the signature and marks the WHMCS invoice paid

4. Sandbox testing

Switch to Sandbox mode: - API endpoint auto-switches to open-na.alipay.com - Use Antom-provided test account to scan - No real charge - Full end-to-end integration verification

5. Refunds

  • WHMCS admin → Invoice → Refund button → standard flow
  • Plugin calls the Antom refund API
  • Antom posts an async callback with the refund outcome

6. FAQ

Q: Recurring billing? A: This version handles one-time payments only. Antom recurring is on the roadmap; supported once the platform exposes it.

Q: HMAC verification fails — what now? A: Make sure the Public Key is complete (with -----BEGIN PUBLIC KEY----- / -----END PUBLIC KEY----- markers).

Q: Switch from sandbox to production? A: Change mode → Live + swap in production keys on the gateway config page. Business orders unaffected.

Q: Late Antom callbacks — how does the plugin handle order state? A: Antom callbacks come with an SLA. The plugin idempotently updates the invoice on every callback (deduplicated by reference_no).

For deeper docs (API endpoints, HMAC algorithm, callback payload) see the "Full documentation" link on your store dashboard card.