How to Setup WooCommerce to Take Bitcoin Payment

Posted OnOct 10, 2014     CategoryE-commerce     Comments2 comments

In this guide we’ll show you how to configure your WooCommerce powered E-commerce website to accept Bitcoins as a payment method.

Step 1) On the Dashboard, head to “WooCommerce” and choose “Add-ons” from the dropdown. On the next page, click on “Free” on the toolbar for a complete list of free add-ons for the plugin.


Step 2) Scroll down until you find Bitcoin Payments and click on it to be re-directed to the WooThemes site, where you can download the plugin ready to be uploaded and installed on your site.


Step 3) Unfortunately, the link is broken at present. But don’t let that stop you. Simply search for ‘Bitcoin Payments’ via the search form on the website. You’ll find it in no time.


Step 4) Once you have found Bitcon Payments, hit “Download” to get your free copy of the add-on.


Step 5) Once you have been redirected to the site, read all the documentation you need on the add-on, then click “Download” to get your .zip file of the plugin.


Step 6) Back on the site, head to your Dashboard and head to “Plugins > Add new” and then click on “Upload”. Once you are given the “Choose File” option, click on that and find your .zip file for the plugin, and then click on the “Install Now” button.


Step 7) Once your package has unpacked and installed, click “Activate Plugin” to add Bitcoin Payments to your website.


Step 8) You can now find Bitcoin Payments via the Dashboard, and can flit between General and Advanced Settings (Advanced are Pro Only). The General Settings consist of allowing all Bitcoin info to be deleted in the event of uninstalling the theme, and whether you choose between Soft Cron or Hard Cron as your system of Bitcoin operation. As a quick guide: Soft Cron: – WordPress-driven (runs on behalf of a random site visitor). Hard Cron: – Cron job driven by the website hosting system/server (usually via CPanel).


Step 9) The other Bitcoin payments options can be found on the Checkout settings, found via the Dashboard: WooCommerce >> Settings >> Checkout. Bitcoin now appears at the end of the second navigation.


Step 10) You can choose whether to enable Bitcoin payments or disable them by ticking or unticking the box provided.


Step 11) The title that customers will see during checkout is defaulted as “Bitcoin Payment”, but you can change it if you wish to do so.


Step 12) The Bitcoin Service provider is Electrum Wallet. Once you have changed it to this, you will be asked to Save Changes to get the details of how to set up Electrum Wallet. The details are as follows:

1. Launch Electrum wallet and get Master Public Key value from: Wallet -> Master Public Key, or:
older version of Electrum: Preferences -> Import/Export -> Master Public Key -> Show.
Copy long number string and paste it in this field.

2. Change “gap limit” value to bigger value (to make sure youll see the total balance on your wallet):
Click on “Console” tab and run this command: (‘gap_limit’,100)

Then restart Electrum wallet to activate new gap limit. You may do it later at any time – gap limit does not affect functionlity of your online store.  If your online store receives lots of orders in bitcoins – you might need to set gap limit to even bigger value.

When you have your Master Public Key, enter it into the box provided and you will be set to go.



Step 13) You can set the number of confirmations that are required before you accept payment in this section. 6 is the default, but you can set it as high or as low as you would like. It takes longer to confirm the more you have, so aim around the default setting to be sure.


Step 14) You can set the exchange rate calculation type between Weighted Average, Real Time and Most Profitable. Read the info provided for each option before you make your decision.


Step 15) The exchange rate multiplier is used to convert the default currency into the Bitcoin price. Read through the details provided before you set your rates.


Step 16) You can alter your customer message regarding the initial instructions at the checkout screen here, or use the default message provided.


Step 17) The HTML payment instructions are provided for you, but they can be edited if you know what you are doing. Read through them carefully and only change them if you have experience in this field. Save your changes at the bottom of the screen.




  1. Jeremy


    Thanks for this great guide but I’m a bit confused.

    I have already a wallet on Buttercoin, so it means I can’t set up my existing wallet with this WooCommerce plugin?

    Best regards

Leave a Reply

Your email address will not be published. Required fields are marked *

Send this to friend