How to accept bitcoin payments on WHMCS: 5 simple steps!

Bitcoin is to payment systems that Linux has been to computer OS. The biggest advantages of bitcoin being :

  • Cheaper transactions (1% vs. 2.9% for Paypal),
  • Non-existent chargebacks, and
  • Minimized fraud.

The growing bitcoin community, which comprises of a lot of developers and entrepreneurs, is looking for avenues to pay using bitcoins. Accepting Bitcoins for your hosting business can attract this community and increase revenues by huge % without any marketing costs. Besides this, you save more than 50% on your current payment costs.

We at Blockonomics, have developed a WHMCS Bitcoin payment plugin which you can install in a few steps and start accepting Bitcoin payments, instantly.


Here's the video version:


Installation Process:

WHMCS account

  • Free account on Blockonomics Wallet Watcher
  • Bitcoin wallet — we will use for this example, but you can use any HD wallet like trezor, electrum, mycelium

In these six simple steps, you’ll be ready to accept Bitcoins on your WHMCS enabled website. If you like video format feel free to check this youtube tutorial

  1. Download the plugin from WHMCS marketplace

Head to the WHMCS Marketplace. In the search bar, type Blockonomics, then click on the Blockonomics Bitcoin payments plugin. Here is a link directly to the plugin page for your convenience.

On the Blockonomics plugin page, click on “Get It Now” and download the plugin.

  2. Copy the plugin to the WHMCS root folder

Next, we’ll install Blockonomics on your website by copying files from the plugin folder you just downloaded into the root folder of your WHMCS server. (Please make sure you copy the files from the plugin folder into the root folder and not the plugin folder itself. I use Filezilla client to copy the files for this particular installation example.)

Copy files from downloaded plugin folder into WHMCS root folder.

Blockonomics is now installed on your WHMCS website!

  3. Activate the plugin

Next, we’ll activate the plugin which can be done simply by going to Setup>Payments>Payment Gateway.

Then under All Payment Gateways, click on Blockonomics and your plugin is activated!

To paste this API key in the WHMCS admin panel, go back to the Manage Existing Gateways tab and paste the API key under the API key there. Then click Save.

4. Synchronize your wallet with Blockonomics

It’s time to connect your wallet, which stores all of your Bitcoin, to your WHMCS site.

You can either use your own wallet, or you can create a free one at

We’ll need to get the Extended Public Address, also known as the xPub. The key will act as your unique identifier that ensures your Bitcoin transactions land in your wallet. From there, you’ll be able to move your Bitcoins to another, more private, wallet, or convert them to real currency (or fiat currency).

After logging into your account, click on the Settings icon on the top right corner and select Wallets and Addresses.

Under the Bitcoin Wallets section, click on Manage.

Then select More options -> Show xPub

Your xPub key should be kept secret. Copy it to your clipboard.

  5. Setup Merchants Account

Head over to Blockonomics Merchants and click Get started For Free

Then, head to Stores -> Add new Store and enter the xPub key you copied in Step 2 in the Xpub field and Save the changes.

You can also add a Tag [not mandatory] for your store. It’s sort of like an identifier, it can help you locate the right store in case you have multiple stores.

Now, copy the API Key and head to the WHMCS Blockonomics settings page.

In WHMCS, under the Manage Existing Gateways -> Blockonomics

Paste the copied API Key in the API Key field.

Then copy the address next to the Callback URL and set it as HTTP Callback URL in Blockonomics. (If you can’t see the Callback URL for some reason, please refresh the page)

You can also go back to your WHMCS and click on save just to ensure that the details are all saved.

That’s it — you’re officially ready to accept Bitcoins on your WHMCS site. Feel free to do a test transaction on your front-end. Each purchase made on your site will send your Bitcoins to your wallet of choice.

Congratulations and good luck!

How do you rate this article?



Frederick Coleman has been working in Bitcoin since 2017. He has had articles published in many online institutions including Hacker Noon and Blockonomics Blog, as well as having writing cited by articles in academic journals.


I write articles on Bitcoin, Politics, Ecommerce, business, and all other kinds of topics.

Send a $0.01 microtip in crypto to the author, and earn yourself as you read!

20% to author / 80% to me.
We pay the tips from our rewards pool.