Skip to content
Payfim - Secure. Simple. Yours.
WHMCS logo WHMCS · v3.0.0

WHMCS Crypto Payment Gateway Module

Let your hosting, VPS and domain customers pay WHMCS invoices in Bitcoin, USDT, Litecoin, Monero and more. Payments are applied to invoices automatically and land directly in your own wallets.

  • Lifetime license, 0% fees
  • Pays straight to your wallet
  • 16 coins incl. USDT TRC20/ERC20
  • Illustrated PDF guide

Compatibility: WHMCS 7.10 - 8.x - 9.x · PHP 7.4 - 8.3

WHMCS client area invoice with a Pay with Crypto button powered by Payfim

Everything you need to accept crypto on WHMCS

Invoice pay button

A branded "Pay with Crypto" button on every unpaid invoice.

Automatic payment posting

Payments are added with the blockchain transaction ID.

Duplicate protection

WHMCS checkCbTransID stops any transaction being applied twice.

Gateway log

Every notification is logged in Billing > Gateway Log.

One-click redirect

Optionally send clients straight to the crypto checkout after ordering.

Server-side invoices

The amount is created server-to-server - clients cannot change it.

The Payfim WHMCS Crypto Payment Gateway Module empowers you to accept Bitcoin, Ethereum, USDT, and 12 other top cryptocurrencies directly on wallet, without any third-party involment or commission. Our self-hosted architecture ensures that funds go straight to your personal crypto wallets with zero middlemen, zero transaction fees, and absolutely no KYC requirements. Installation takes just few minutes, providing your clients with a seamless, white-labeled checkout experience complete with automatic payment confirmations and invoice status updates.

Crypto payments made for hosting companies

Hosting is a global, recurring business - and a large share of hosting customers live in countries where cards are unreliable or PayPal is unavailable. Crypto solves that, but hosted crypto processors bring back the same problems: application reviews, rolling reserves, payout delays and a fee on every renewal you bill for years.

The Payfim WHMCS module connects WHMCS to your own self-hosted Payfim gateway. Each unpaid invoice shows a clear Pay with Crypto button. Your client picks a coin, pays, and WHMCS records the payment against the invoice with the blockchain transaction ID - so services unsuspend and renewals process exactly as they do for card payments.

How the WHMCS module works

  1. WHMCS renders the invoice and calls the module's payfim_link() function.
  2. The module creates (or re-uses) a Payfim invoice for that WHMCS invoice server-to-server. The amount and currency come from WHMCS, never from the browser.
  3. Your client clicks Pay with Crypto, chooses from the coins you enabled and scans the QR code.
  4. Your gateway confirms the transaction and calls modules/gateways/callback/payfim.php with a signed webhook.
  5. The callback verifies the HMAC signature, re-reads the invoice from your gateway, runs WHMCS' own checkCbInvoiceID() and checkCbTransID() checks, then calls addInvoicePayment() and writes a Gateway Log entry.

Because WHMCS rejects duplicate transaction IDs, a payment can never be applied twice - even if a webhook is retried.

Why self-hosted beats a processor for WHMCS

  • No fees on recurring revenue. A 1% processor fee on a $10/month hosting plan costs you $1.20 per client per year, forever. Payfim costs one small one-time license.
  • No account to lose. Hosting is often flagged as "high risk". With Payfim there is no processor to approve or suspend you.
  • Stablecoins remove volatility. Offer USDT (TRC20) and USDC so you receive dollar-value payments instead of speculating on price moves.
  • Your branding. The crypto checkout uses your colours and logo; add the white-label option to remove Payfim branding entirely.

Requirements

WHMCS7.10 - 8.x - 9.x
PHP7.4 - 8.3 (as supported by your WHMCS version)
GatewayPayfim Gateway 3.0+ (included)
CurrenciesAny WHMCS currency with an ISO code (USD, EUR, GBP, ...)

How to install the WHMCS crypto payment module

  1. Install the Payfim gateway. Upload the payfim folder to your server (for example billing.yourhost.com/payfim), run the installer and add your wallet addresses.
  2. Upload the module. Upload the contents of the upload folder to your WHMCS root, so that modules/gateways/payfim.php and modules/gateways/callback/payfim.php exist.
  3. Activate. In WHMCS go to Setup → Payments → Payment Gateways → All Payment Gateways and click Payfim Crypto Payments.
  4. Connect. Paste your Payfim Gateway URL and API key, choose the display name and save.
  5. Test. Create a small test invoice for your own client account, pay it with crypto and watch WHMCS mark it paid.

WHMCS crypto payments FAQ

Does the module work with recurring invoices?

Yes. Every renewal invoice gets its own crypto payment link; when it is paid WHMCS processes the renewal and unsuspends services as usual.

Where do I see crypto payments in WHMCS?

In the invoice's transaction list (with the blockchain transaction hash as the transaction ID) and in Billing → Gateway Log.

Can a client pay the same invoice twice?

If they do, WHMCS' duplicate-transaction check prevents the same transaction being applied twice, and the second payment simply arrives in your wallet. Payfim does not match it to the paid invoice, so check your wallet and refund or credit the client in WHMCS.

Does it support multiple currencies?

Yes. The invoice is created in the WHMCS invoice currency and converted to crypto at the live rate when the client chooses a coin.

Is the module encrypted?

No. You get clean, readable PHP that you can audit.

Related integrations