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
- Open a merchant account. Sign in with Google or Telegram, finish the business setup and turn on your authenticator app.
- Download the ZIP from the WHMCS Marketplace. Upload its modules folder into your WHMCS root, the folder that holds configuration.php.
- In WHMCS, open System Settings, then Payment Gateways, and choose All Payment Gateways. Click Plaxswap - Bitcoin & Crypto Payments Gateway to activate it.
- 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.
- 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_.
- In the gateway settings in WHMCS, paste the API key and the webhook signing secret. Leave Convert To For Processing empty and save.
- Choose Send test under Webhooks and check that it shows Delivered.
- 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.
- 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.
| Payment | Invoice | What it means |
|---|---|---|
| Waiting for the client to pay | Unpaid | Pressing the button again within the hour reuses the same payment. |
| Seen on the network, still confirming | Unpaid | The Gateway Log shows a Pending entry. |
| Part of the amount arrived | Unpaid | The Gateway Log shows a Pending entry. |
| Paid and verified | Paid | Recorded once, with the Plaxswap payment ID as the transaction ID. |
| Paid, transfer under review | Unpaid | It's checked again when the client opens the invoice. |
| Expired, cancelled or failed | Unpaid | The client can start a new payment from the invoice. |
| Paid up to 24 hours late | Paid when the webhook arrives | The 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 see | What 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 fails | The callback URL must be public HTTPS, the module active, and the signing secret the same as in Webhooks. |
| Paid, but the invoice is still unpaid | Opening 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 shop | A 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.