Knowledge Base
  1. Home
  2. Knowledge Base
  3. Accept crypto payments
Accept crypto payments

Accept crypto payments on WHMCS (every coin)

Let WHMCS clients pay invoices in Bitcoin, USDT, USDC, Monero, XRP and more with the free PayGate.to module: Individual Coins or Multicoin, paid to your own wallets.

3 min readUpdated Intermediate
On this page
  1. Requirements
  2. Step 1: Upload the module
  3. Step 2: Activate the gateways
  4. Step 3: Enter wallets
  5. Step 4: Test with an invoice
  6. Good to know
  7. Troubleshooting
  8. Coin guides for WHMCS
  9. Frequently asked questions

Hosting companies and SaaS businesses use WHMCS to bill clients. The free PayGate.to module adds two crypto gateways to WHMCS: clients pay invoices in the coin of their choice and every payment is forwarded to your own wallet. Fees: 1% plus blockchain fees. Illustrated install guide: WHMCS crypto module page.

Requirements

  • WHMCS with admin access, and FTP/SFTP or your hosting file manager.
  • PHP with the curl and openssl extensions, and outbound HTTPS (the coin list loads live).
  • System URL set to your public https address.
  • A self-custodial wallet for each coin or network.

Step 1: Upload the module

Download the module ZIP from the WHMCS crypto module page, unzip it, and upload the modules folder into your WHMCS root (the folder with configuration.php), merging it with the existing modules folder:

text
<whmcs root>/modules/gateways/
├── paygatecrypto.php            (Individual Coins)
├── paygatecryptomulti.php       (Multicoin)
├── paygatecrypto/               (lib.php, keys, logo)
├── paygatecryptomulti/          (logo)
└── callback/
    ├── paygatecrypto.php
    └── paygatecryptomulti.php

Step 2: Activate the gateways

Configuration › System Settings › Payment Gateways › All Payment Gateways (WHMCS 7: Setup › Payments › Payment Gateways), then activate Crypto Payment Gateway — Individual Coins and/or Crypto Payment Gateway — Multicoin.

GatewayHow clients pay
Individual CoinsThey pick a coin and see the QR code, amount and address on the invoice
MulticoinThey click Pay with cryptocurrency and choose a coin on the hosted page

Step 3: Enter wallets

  • Individual Coins: one field per coin, loaded live. Fill the coins you want; leave others blank.
  • Multicoin: one field per network:
FieldAccepts
EVM Wallet AddressETH and tokens on Ethereum, BNB Smart Chain, Polygon, Optimism, Arbitrum, Base, Avalanche
Bitcoin, Bitcoin Cash, Litecoin, DogecoinOne field each
Solana (SOL)SOL and Solana tokens
TRC20TRX and USDT on TRON
Monero (XMR), Zcash (ZEC), TONOne field each
XRP Wallet Address (XRP Ledger)r…, r…?dt=TAG or an X-address

Optional: custom checkout domain, logo and colours for the hosted page.

Step 4: Test with an invoice

Create a small invoice and pay it with a low-minimum coin. When the payment is confirmed, the crypto is forwarded to your wallet and the invoice is marked paid.

PayGate.to hosted checkout payment details for XRP, one-time address and QR code
What a client sees in Multicoin mode after choosing a coin.

Good to know

  • The module stores payment data in the invoice Notes: don't edit them while a crypto payment is pending.
  • In Individual Coins mode, a payment in the wrong token is still forwarded to you, but the invoice isn't marked paid automatically: check it and mark it paid by hand.
  • If you used older per-coin PayGate.to modules, deactivate them.

Troubleshooting

  • "Coin list" error in the settings: allow outbound HTTPS to api.paygate.to.
  • "No cryptocurrencies are currently available": fill at least one wallet.
  • Invoice stays Unpaid: check the System URL and that /modules/gateways/callback/ is reachable; look for "Underpaid" in the Gateway Log. More in WHMCS troubleshooting.

Coin guides for WHMCS

Monero · XRP · Bitcoin · USDT · USDC

Frequently asked questions

Can I offer both gateways?

Yes. Clients see both as payment methods on the invoice.

Does it work with recurring invoices?

Each invoice is paid individually: clients pay each new invoice in crypto as it's generated.

Where's the module's log?

In WHMCS under the Gateway Log, which records each callback.

This guide is also available as Markdown for AI assistants and offline reading.