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.
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).
| Option | How it connects to WHMCS | Who holds the funds | Fee at the time of writing | Coins |
|---|---|---|---|---|
| NOWPayments | WHMCSPilot module, $89 | Non-custodial: paid out to your wallet | 1% without exchange; 1.5% for multi-currency, fixed-rate or fee-paid-by-customer payments; plus network fees | 100+ cryptocurrencies, including BTC, ETH and USDT |
| BitPay | Built into WHMCS | BitPay, then settled to you | 2% + 25¢ below $500,000 a month; 1.5% + 25¢ up to $999,999; 1% + 25¢ above; higher for high-risk industries | Bitcoin and the other coins BitPay supports |
| BTCPay Server | Free plugin from the BTCPay Server project | You, straight to your wallet | 0% processing fee; you pay for the server and network fees | Bitcoin |
| CoinGate | CoinGate's WHMCS plugin | CoinGate balance, then payout | 1% per transaction, no monthly fee; payouts and some withdrawals cost extra | Multiple coins |
| Helium | WHMCSPilot module, $149 | You, straight to your HNT wallet | No processor fee; network fees only | HNT |
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:
- Open a merchant account with the processor, or install BTCPay Server and create a store. Complete any merchant verification the provider asks for.
- Set your payout wallet or settlement currency. Decide whether you keep coins, receive stablecoins, or convert to fiat.
- Upload the module to
/modules/gateways/, unless you use BitPay, which is already there. - Activate it at
Configuration > Apps & Integrationsin the Payments category. Paste the API key, tick Show on Order Form, and use a clear Display Name such as "Crypto (BTC, ETH, USDT)". - Register the callback or webhook URL in the provider's dashboard, so WHMCS hears about confirmed payments.
- Set Convert To For Processing if your invoices use a currency the gateway doesn't accept.
- 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.
- 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.
| Approach | How it works | Trade-off |
|---|---|---|
| Price in fiat, quote at payment | The gateway converts the invoice total at the current rate when the customer pays | The customer carries rate risk only during the payment window |
| Rate lock | The quote is held for a short window, such as the Helium module's 30 minutes | Late payments need a new quote |
| Fixed-rate payments | NOWPayments' fixed-rate option guarantees the quoted amount | Costs 1.5% instead of 1% |
| Stablecoins | Accept USDT or USDC, which track the US dollar | Choose networks with low fees, and check which networks your processor supports |
| Convert to fiat | The processor settles in your bank currency | Extra 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.
Tagged with: