Skip to content
Payment Gateway

How to Accept Cryptocurrency Payments in WHMCS: Gateways and Fees

WHMCS takes crypto through BitPay, which is built in, or through modules for NOWPayments, BTCPay Server, CoinGate and Helium. Compare fees, custody and setup, and plan for manual renewals.

WHMCSPilot Team Published Updated 9 min read
How to Accept Cryptocurrency Payments in WHMCS: Gateways and Fees

You can accept cryptocurrency in WHMCS with the built-in BitPay gateway, or with an add-on gateway for NOWPayments, BTCPay Server, CoinGate or Helium. Pick a hosted processor if you want quick setup and many coins, or a self-hosted, direct-to-wallet option if you want no processor fees and full custody. This guide is for hosting, VPN and IPTV businesses on self-hosted WHMCS, and every fee below comes from the provider's own page at the time of writing (November 2026).

Key takeaways

  • BitPay ships with WHMCS. NOWPayments, BTCPay Server, CoinGate and Helium need a gateway module in /modules/gateways/.
  • Fees range from nothing for self-hosted BTCPay Server to 2% + 25¢ for BitPay below $500,000 a month, plus network fees.
  • Crypto gateways can't charge renewals automatically, so the client pays every invoice. Plan reminders and payment links around that.
  • Price in fiat and let the gateway quote the coin amount at payment time, or accept stablecoins, to avoid volatility.
  • In the US, the IRS treats crypto received for services as income at its fair market value in US dollars when received.

Which crypto payment gateways work with WHMCS?

Crypto payment options for WHMCS fall into two groups: hosted processors, which handle rates, addresses and confirmations for a fee, and direct-to-wallet tools, where payments land in a wallet you control. This table compares the main options at the time of writing (November 2026).

OptionHow it connects to WHMCSWho holds the fundsFee at the time of writingCoins
NOWPaymentsWHMCSPilot module, $89Non-custodial: paid out to your wallet1% without exchange; 1.5% for multi-currency, fixed-rate or fee-paid-by-customer payments; plus network fees100+ cryptocurrencies, including BTC, ETH and USDT
BitPayBuilt into WHMCSBitPay, then settled to you2% + 25¢ below $500,000 a month; 1.5% + 25¢ up to $999,999; 1% + 25¢ above; higher for high-risk industriesBitcoin and the other coins BitPay supports
BTCPay ServerFree plugin from the BTCPay Server projectYou, straight to your wallet0% processing fee; you pay for the server and network feesBitcoin
CoinGateCoinGate's WHMCS pluginCoinGate balance, then payout1% per transaction, no monthly fee; payouts and some withdrawals cost extraMultiple coins
HeliumWHMCSPilot module, $149You, straight to your HNT walletNo processor fee; network fees onlyHNT

Two large card processors now take crypto too. Stripe's US pricing lists stablecoin payments at 1.5%, and PayPal lists Pay with Crypto at 1.5% from August 1, 2026. Neither appears in WHMCS's documentation for its Stripe Dynamic Payments or PayPal Payments modules, so test with your own account before you promise it to customers. For card and bank options alongside crypto, see our WHMCS payment gateways comparison.

How do the main crypto options differ?

NOWPayments

NOWPayments is a non-custodial processor: according to its help center, it doesn't store your funds or hold your wallets' private keys, and sends payments to the payout wallet you set. WHMCSPilot's NOWPayments Gateway adds it to WHMCS with automatic payment verification, real-time exchange rates, instant payment notifications, refund support, multi-currency invoicing and payment status tracking. Choose it when customers want to pay in many different coins.

BitPay

BitPay is the only crypto gateway bundled with WHMCS, and it's also available on WHMCS Cloud's Growth and Expansion plans. The WHMCS BitPay module handles one-time payments only. It doesn't process refunds from WHMCS and needs the GMP or BCMath PHP extension. BitPay's tiered fees are the highest in this list, but there's nothing to install.

BTCPay Server

BTCPay Server is free, open-source software that you run yourself or on a shared host, and payments go directly to your connected wallet. The BTCPay Server WHMCS plugin version 4 uses BTCPay's Greenfield API with signed webhooks and needs PHP 8.1 or later with bcmath, curl, json and mbstring. Its README says WHMCS 9.0.6 was tested with version 3 and asks you to validate version 4 on staging. The older legacy integration doesn't work with BTCPay Server 2.4.4 or later.

CoinGate

CoinGate charges 1% per transaction with no monthly fee and publishes a WHMCS plugin. Funds settle to your CoinGate balance. On its Standard plan, crypto payouts cost €0.50 + 0.5%, and SEPA withdrawals are free with a €50 minimum, which suits European businesses that want euros in the bank.

Helium

WHMCSPilot's Helium Payment Gateway takes HNT wallet to wallet with no third-party processor. It fetches the HNT rate from the Helium oracle, locks it for 30 minutes when the customer clicks pay, and marks the invoice paid after a configurable number of confirmations, three by default. It also offers QR codes, testnet mode and refund tooling. It costs $149, or $449 for the unencrypted open-source version.

How do I set up crypto payments in WHMCS?

Setting up any crypto gateway in self-hosted WHMCS follows the same steps:

  1. Open a merchant account with the processor, or install BTCPay Server and create a store. Complete any merchant verification the provider asks for.
  2. Set your payout wallet or settlement currency. Decide whether you keep coins, receive stablecoins, or convert to fiat.
  3. Upload the module to /modules/gateways/, unless you use BitPay, which is already there.
  4. Activate it at Configuration > Apps & Integrations in the Payments category. Paste the API key, tick Show on Order Form, and use a clear Display Name such as "Crypto (BTC, ETH, USDT)".
  5. Register the callback or webhook URL in the provider's dashboard, so WHMCS hears about confirmed payments.
  6. Set Convert To For Processing if your invoices use a currency the gateway doesn't accept.
  7. Test on testnet or sandbox, then pay a small live invoice. Check that WHMCS marks it Paid, records the transaction ID and runs the module's provisioning.
  8. Update your invoice emails and terms to explain the payment window, required confirmations, and how you handle underpayments and refunds.

For BitPay, the WHMCS documentation adds specific steps: in BitPay, go to Payment Tools > API Tokens, create a token with Require Authentication unchecked, and paste it into the POS Token field in WHMCS. Choose a transaction speed, which sets how quickly a payment counts as confirmed. Test mode needs a separate token from test.bitpay.com.

For BTCPay Server, enter your Greenfield API key and store ID, save, then click Set up / repair webhook. Saving the settings alone doesn't register the webhook, and without it WHMCS never learns that invoices were paid.

How do I handle crypto price volatility in WHMCS?

Volatility is manageable if WHMCS invoices stay in your normal currency and the crypto amount is worked out at payment time.

ApproachHow it worksTrade-off
Price in fiat, quote at paymentThe gateway converts the invoice total at the current rate when the customer paysThe customer carries rate risk only during the payment window
Rate lockThe quote is held for a short window, such as the Helium module's 30 minutesLate payments need a new quote
Fixed-rate paymentsNOWPayments' fixed-rate option guarantees the quoted amountCosts 1.5% instead of 1%
StablecoinsAccept USDT or USDC, which track the US dollarChoose networks with low fees, and check which networks your processor supports
Convert to fiatThe processor settles in your bank currencyExtra conversion or withdrawal fees

Write an underpayment rule as well. Customers often send slightly less than the quote after wallet or exchange fees. WHMCS can record a partial payment and leave the balance due, but decide in advance whether you'll accept small shortfalls, ask for the rest, or refund.

How do renewals and refunds work with crypto?

Crypto gateways are push payments: the customer sends funds each time, so WHMCS can't capture a renewal the way it charges a stored card. To keep renewals on time:

  • Set Invoice Unpaid Reminder and up to three Overdue Reminder emails under Configuration > System Settings > Automation Settings.
  • Generate renewal invoices early enough for customers to buy coins, using Invoice Generation days.
  • Cut payment friction with the Auto Login Invoice module, which lets clients pay an invoice through a secure link without logging in.
  • Offer a card or PayPal option next to crypto for customers who want automatic renewals.

Crypto transactions can't be reversed by the sender, so there are no chargebacks. Refunds are manual: you send coins to an address the customer gives you, at an agreed amount. WHMCS's BitPay module can't refund from WHMCS, while modules.json lists refund support for WHMCSPilot's NOWPayments and Helium modules. No chargebacks doesn't mean no fraud, so for expensive servers or reseller plans, add identity checks such as the WHMCS KYC Verification Module.

How should I record crypto payments for tax?

In the US, the IRS virtual currency FAQs say crypto received for services is ordinary income, measured at its fair market value in US dollars when received. That value becomes your basis in the coins. If you sell or exchange them later, the difference between that basis and what you receive is a capital gain or loss.

Because WHMCS records each invoice and payment in your fiat currency, its transaction list already shows the dollar value at payment, which helps. Keep the gateway's exports with the coin, amount, rate and transaction hash, and if you hold coins after payment, track their later sale separately. The QuickBooks Integration module syncs WHMCS invoices and payments to QuickBooks Online. Outside the US, rules differ, so check with an accountant who knows crypto.

Frequently asked questions

Does WHMCS support Bitcoin payments natively?

Yes. WHMCS includes a BitPay gateway for one-time crypto payments on self-hosted installs and on WHMCS Cloud's Growth and Expansion plans. Other crypto gateways need a third-party module.

What is the cheapest way to accept crypto in WHMCS?

BTCPay Server has no processing fee because you run it yourself, though you pay for its server and for network fees. Among hosted processors at the time of writing (November 2026), NOWPayments and CoinGate charge 1%.

Can WHMCS charge crypto renewals automatically?

No. Crypto is a push payment, so the customer has to pay each renewal invoice. Use reminder emails and payment links, or offer a card gateway for automatic renewals.

Which cryptocurrencies should a hosting company accept?

Bitcoin, Ethereum and a US dollar stablecoin such as USDT or USDC cover most crypto buyers. Stablecoins also remove price volatility between invoice and settlement.

Can I use third-party crypto modules on WHMCS Cloud?

Usually not. WHMCS Cloud runs its included modules and a curated set of pre-approved add-ons, not custom modules, so the bundled BitPay gateway on the Growth or Expansion plans is the dependable crypto option there.

To add crypto alongside your card gateways, browse the WHMCS payment gateway modules, or ask our payment gateway integration service to set up and test a processor for you.