Skip to content

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.

  1. 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.
  2. 02Paste the keyIn the CoinsPay dashboard create a key with "Invoices only" access and paste it into "API key". Leave "API address" empty.
  3. 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".
  4. 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

as low as0.3%of each payout, the rate depends on your volume

Connect your shopHow the fee works

Questions about the gateway

All questions
How 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.