Skip to content

Updated 20 Nov 2026

WHMCS crypto payment gateway

Plaxswap - Bitcoin & Crypto Payments Gateway is a free module on the WHMCS Marketplace. Your client pays an invoice in Bitcoin, USDT or another coin on our hosted checkout, and WHMCS marks it paid once the module has verified the payment.

Module details

Price
Free on the WHMCS Marketplace
Version
1.0.0, from 3 Nov 2026
Needs
WHMCS 8.13, 9.0 or 9.1.0, and PHP 7.4 with cURL, or newer
Invoices
Any invoice in one of 67 currencies
Platform fee
1.5% of each payment, paid by your client and shown at checkout. The module adds nothing on top
Time to pay
60 minutes, set by the module
Short payments
Counts as paid if your client sent at least 99.5% of the amount
Payment size
From about $1 to about $500,000. The checkout shows the limit for each coin

Set up the module

  1. Open a merchant account. Sign in with Google or Telegram, finish the business setup and turn on your authenticator app.
  2. Download the ZIP from the WHMCS Marketplace. Upload its modules folder into your WHMCS root, the folder that holds configuration.php.
  3. In WHMCS, open System Settings, then Payment Gateways, and choose All Payment Gateways. Click Plaxswap - Bitcoin & Crypto Payments Gateway to activate it.
  4. In your merchant dashboard, open Developers, then API keys. Choose New key, select Test and choose Create test key. It starts with pxs_test_ and is shown only once.
  5. Open Developers, then Webhooks. Choose Add URL, paste https://your-whmcs-address/modules/gateways/callback/plaxswap.php with your real WHMCS address, and choose Save. Choose Make a new secret and copy it. It starts with whsec_.
  6. In the gateway settings in WHMCS, paste the API key and the webhook signing secret. Leave Convert To For Processing empty and save.
  7. Choose Send test under Webhooks and check that it shows Delivered.
  8. In the admin area, use Login as Client, open an unpaid invoice and press Pay with Bitcoin & Crypto. Act out a payment on the test checkout. The invoice should turn Paid, with a Success entry in the Gateway Log.
  9. When that works, create a live key (pxs_live_) in the same merchant account, paste it in place of the test key and make one small real payment.

You can also change the button text, and turn on Share client email, which is off by default.

Moving from Coinbase Commerce? See what to check when you switch.

What happens to a WHMCS invoice

The module never trusts a returning client or a notification alone. A signed webhook makes it ask our API about the payment, and it checks the payment ID, mode, amount, currency and invoice first.

PaymentInvoiceWhat it means
Waiting for the client to payUnpaidPressing the button again within the hour reuses the same payment.
Seen on the network, still confirmingUnpaidThe Gateway Log shows a Pending entry.
Part of the amount arrivedUnpaidThe Gateway Log shows a Pending entry.
Paid and verifiedPaidRecorded once, with the Plaxswap payment ID as the transaction ID.
Paid, transfer under reviewUnpaidIt's checked again when the client opens the invoice.
Expired, cancelled or failedUnpaidThe client can start a new payment from the invoice.
Paid up to 24 hours latePaid when the webhook arrivesThe Gateway Log entry shows it was late. Check it before you act.

If a webhook is missed, the module checks the invoice's open payments again when the client comes back to the invoice. There is no separate cron task.

What your client sees

Your client chooses Bitcoin & Crypto (Plaxswap) as the payment method and presses the button on the invoice. On our hosted checkout they pick a coin and network, and see the amount, address, QR code and every charge before they send. It takes multiple coins and networks, including BTC, ETH, USDT, USDC, SOL, TRX, BNB, LTC, DOGE, BCH, XRP, GRAM, AVAX, POL, DAI and DASH.

Costs and your money

On a $100 invoice, your client sends about $101.50 in the coin they chose, plus the network fee, and about $100 in that coin reaches your merchant balance. When you withdraw, you pay our 0.3% fee and the network fee, both shown before you approve. Work out other amounts with the fee calculator, and see every cost on the fees page.

Limits to know first

  • Refunds aren't automatic, and a crypto payment can't be reversed.
  • You receive the coin your client paid with, in your Plaxswap merchant balance. The module can't withdraw your funds.
  • The callback URL has to be public HTTPS. A WHMCS on localhost can't receive webhooks.
  • Our merchant terms apply, and payments are closed in some countries. See the country list.

If something goes wrong

What you seeWhat to check
Clients see "being set up (test mode)"A test key is saved, so only a logged-in admin can pay. Paste a live key.
"Crypto payments are not available for invoices in ..."Use a supported currency, and leave Convert To For Processing empty.
Send test failsThe callback URL must be public HTTPS, the module active, and the signing secret the same as in Webhooks.
Paid, but the invoice is still unpaidOpening the invoice as the client checks the payment again. Then look for Error or Pending entries in the Gateway Log.
"The amount due has changed"The invoice changed. Open it again to pay the current amount.
Webhooks go to another shopA merchant account has one callback URL. WHMCS then records payments only when the client returns to the invoice.

Still stuck? Contact support with your module version, WHMCS version and the invoice number. Never send an API key, signing secret, recovery phrase or authenticator code.

Questions

Is the WHMCS module free?

Yes, it's free on the WHMCS Marketplace. Your client pays our 1.5% platform fee, and you pay 0.3% plus the network fee when you withdraw.

Which WHMCS versions does it support?

The Marketplace listing lists WHMCS 8.13, 9.0 and 9.1.0. The module needs PHP 7.4 or newer with cURL.

Which invoice currencies work?

67 currencies, including USD, EUR, GBP and INR. For any other currency the pay button doesn't appear.

Does the Refund button in WHMCS send coins back?

No. The module has no refund function, and a crypto payment can't be reversed. Send the coins yourself from your merchant balance or wallet, then record the refund in WHMCS.

Can it bill recurring services automatically?

No. WHMCS still creates renewal invoices, but the client pays each one at checkout. There is no stored payment method or automatic charge.

Related

Selling on WordPress too? See the WooCommerce plugin. To build your own checkout, read the payment API docs, or see the crypto payment gateway. The module itself is on the WHMCS Marketplace. Billing with FOSSBilling instead? See the FOSSBilling module, or every plugin on the integrations page.

Using Plaxswap means you accept our terms and privacy notice, recorded with your IP address and browser details. Extra cookies are optional.