Accept crypto in
WHMCS
The CoinsPay gateway lets your clients pay WHMCS invoices in USDT, BTC, ETH or any of 30+ coins. The payment is added to the invoice on its own, WHMCS provisions or renews the service, and the money goes straight to your wallets.
- WHMCS
- 7.0 and newer
- PHP
- 5.6 to 8.5
- Module
- free, GPL 2.0
What the gateway gives you
Services start on their own
When the payment is confirmed, the gateway adds it to the invoice, and WHMCS does what it does after any payment: marks the invoice paid, provisions or renews the service and emails the client. Nobody checks payments by hand.
Money lands in your wallets
CoinsPay does not hold your revenue: every payment goes on to your wallets by the payout rule of your shop. Each network takes up to 5 addresses with shares, say 70% to you and 30% to a partner.
Prices stay in your currency
The client pays what is left on the invoice, in its currency. CoinsPay converts it at the current rate and holds the coin amount for 30 minutes while the client opens a wallet. If CoinsPay does not take your currency, set "Convert To For Processing" to USD, for instance.
A key that cannot withdraw
The gateway only needs a key with "Invoices only" access: it can create invoices and follow them, but it cannot move money.
Set up in five minutes
You need a CoinsPay account with a shop and access to the WHMCS admin area. No developer required.
- 01Install the moduleDownload the archive and copy the contents of its upload folder into the WHMCS root, the one with configuration.php. Then find CoinsPay among the payment gateways and activate it.
- 02Paste the keyIn the CoinsPay dashboard create a key with "Invoices only" access and paste it into "API key". Leave "API address" empty.
- 03Connect the webhookIn the "Webhook" section of the dashboard enter your WHMCS address followed by /modules/gateways/callback/coinspay.php, and copy the whsec_ signing secret into "Webhook secret".
- 04Check it with a test paymentThe "Check the connection" link shows your shop and which of your currencies CoinsPay takes. Then pay one invoice with a cpk_test_ key: no money moves, and you see it turn Paid in your own WHMCS.
It handles the awkward cases too
Changed or cancelled invoices, lost webhooks, the wrong amount: the gateway adds to the invoice only what closes it and shows you what needs your decision.
Each payment once
The webhook, the return of the client, the WHMCS cron and the invoice page can arrive at the same moment, and the payment is still added once.
The invoice changed
Change its total, cancel it, have it paid another way or switch it to another gateway, and the module cancels the open CoinsPay invoice. The next "Pay Now" creates one for the new amount.
Payments for your decision
A payment for an invoice cancelled or paid another way meanwhile is not added on its own. It gets a "CoinsPay" entry in the activity log and a warning on the admin page of the invoice: add it by hand or refund it from the dashboard.
Underpayment
If less arrives, the client can pay the rest on the same payment page. If the CoinsPay invoice expires first, the part received waits for your decision, with a warning on the admin page of the invoice.
Overpayment
The invoice balance is added and the invoice is paid. The excess is not added in WHMCS and gets a warning on the invoice: refund it from the dashboard or keep it.
No payment gets lost
Webhooks are signed, and the gateway checks the signature. Even without webhooks, the module asks CoinsPay about open invoices on every run of the WHMCS cron, and when the client opens the invoice.
The client can pay the fee
Turn these settings on and the CoinsPay fee and the network fee are added to the amount on the payment page. The WHMCS invoice gets its own balance.
Your button text
The button on the invoice can say "Pay with crypto" or anything else. Left empty, it is the "Pay Now" of WHMCS in the language of the client.
Test mode
With a cpk_test_ key, invoices are paid with a button on the payment page and no coins move. Only signed-in admins see the gateway, so real clients never notice it.
Installation
The module is one archive on GitHub, next to its source code. Copy its files into the WHMCS root: it adds the gateway and a small hooks file.
API documentation- WHMCS
- 7.0 and newer
- PHP
- 5.6 to 8.5, as your WHMCS needs
- Cron
- the cron of WHMCS, which WHMCS needs anyway
- License
- GPL 2.0 or later
Pay only when you get paid
- First 10 days fee-free, on payouts up to $500
- No monthly or setup fee
- The fee can go on the buyer’s invoice
- Network fees at cost, no markup
Questions about the gateway
All questionsHow much does the module cost?
The module is free. You only pay the CoinsPay fee on payouts: as low as 0.3%, going down as your turnover grows, with no monthly fee. For the first 10 days after your first payment, payouts up to $500 carry no fee.
Which coins can clients pay with?
More than 30 coins and tokens on TRON, Ethereum, BNB Smart Chain, Solana, Bitcoin and Litecoin: USDT, USDC, BTC, ETH, BNB, TRX, LTC, SOL and more. A gateway setting can limit the choice to stablecoins.
Does the service start right after the payment?
Yes. Once the gateway adds the payment, the invoice is paid, and WHMCS provisions or renews the service as after any payment, a hosting account or a VPS for one, and emails the client.
How do I check it before taking real payments?
Pay one invoice in test mode. Make an invoice with a custom line item for your own client account, turn on "Add test payments", pay it with a cpk_test_ key and watch it turn Paid. No money moves, and the README of the module walks you through it.
Do I need a cron job?
WHMCS needs its cron anyway, and the module checks open invoices on every run, even when a webhook does not arrive. Without the cron, such a payment arrives when the client opens the invoice.
Which languages does the gateway speak?
English and Russian. Messages to the client follow the client’s language in WHMCS, and the payment page opens in it. The gateway settings in the admin area are in English.
What client data goes to CoinsPay?
The invoice number, the amount and currency, and the address to send the client back to after payment. Client names, emails, addresses and phone numbers are not sent.
Can I connect a staging copy of my WHMCS?
Yes, but give it a separate CoinsPay shop. A shop has one webhook address, so its events would reach only one of the two sites.
Start taking crypto today
Signing up takes a minute and setting up a shop about five more. Connecting is free.
WHMCS and the WHMCS logo are trademarks of WHMCS Limited. CoinsPay is not affiliated with WHMCS Limited, and the module is not sponsored or endorsed by it.