Btcpayserver woocommerce

Installing BTCPay WooCommere Plugin

While you’re on fire installing the plugins, let’s install the BTCPay plugin, which will allow us to connect our own Bitcoin Payment processing system on the VPS server and our Woocommerce store. The plugin is a “bridge” between the two.

For now, we will just install it.

At the time of writing, BTCPay Server has not been added to WordPress plugins repository, so we will need to install it manually. But do not worry, it’s easy enough.

UPDATE: BTCPay for WooCommerce is now added. You can install plugin directly from the  plugins > add new > btcpay for woocommerce.

First, we need to download the WooCommerce plugin from the GitHub.

Go to BTCPay WooCommerce plugin section, and click on the “Releases” tab.

Locate the latest release and download a woocommece.zip file by clicking on it.

In your WordPress dashboard, click “Plugins > Add new” and “Choose File.”

Select the downloaded file marked usually as btcpay-woocommerce.zip and upload it to the website.

Click “Install Now” to install the uploaded plugin.

Do not close the page, wait for few seconds and click “Activate plugin” once the installation is completed.

• 1. Hosted solution
• 2. Self-hosted solution

Connecting to a Third-Party Host

BTCPay Hosts are running their own BTCPay Server. In their settings, they enabled registration for other people. You’re never uploading your private key to hosts.

There are free third-party hosts and paid ones. In this step, I will show you how to connect to a free host. For the up to date list of BTCPay Server hosts, check this document.

The process of connecting to a host is similar for each of them. We have to register and pair the API keys with your WooCommece Store. I will be using BTCPay Jungle host in this example, but feel free to use any other you prefer. If you’re hosting BTCPay server yourself, you can show this guide to your friends so that they can connect to your node and receive payment to their Bitcoin wallet.

Registering with a third-party host

The first step is to register and enter the login credentials. Head over to BTCPay Jungle.

1. Click on “Register”
2. Enter your e-mail and password
3. Go to your e-mail inbox, and verify the e-mail address.

4. Log in to the host website

5. Click on the “Stores”

6. Click “Create new store”

7. Enter store name

8. Click “Create”

Pairing your store with a host

Now it’s time to pair your payment processor to your website. The BTCPay plugin we installed, is a bridge between your host and your store.

Go back to your store dashboard. WooCommerce > Settings > Payments. Click BTCPay.

1. In the field, enter the full URL of your host (including the https) – https://btcpayjungle.com
2. Click on the generated link which will redirect you back to your BTCPay host.

3. Click on request pairing
4. Approve the pairing

5. Copy the pairing code
6. Go back to your store and paste the pairing code
7. Click “Pair”
8. When you see the image, it means you successfully paired your host and your store

Installing BTCPay self-hosted Server

UPDATE. While this section is still valid, there’s now a much easier way to install BTCPay Server without ever using code. Please visit this article I wrote. and follow the video below.

You can still folllow the instructions below, since you will need to register and buy hosting with lunanode, but the deployment method is much easier and takes less than 2 minutes.

Having your payment processor server handled by a third party has its pros and cons. The cost reduction and fewer efforts are are the most notable advantages. Relying on someone else’s full node brings privacy and trust issues. Furthermore, the self-hosted BTCPay offers additional features (Lightning Network) that only work if you’re the server admin (owner).

Once you outgrow the third-party solution, you should consider running your BTCPy instance on a VPS, for the ultimate privacy, versatility, and trustlessness.

There are many ways in which you can run your own BTCPay. If you’re technically advanced user, you can look into software documentation and choose the method which suits your knowledge.

In this tutorial, we’re focused on ease of use and cost-effectiveness. For that reason, I decided to showcase you a method which is the cheapest. Even though it requires that you add a piece of code here and there, provided that you follow the instructions, you shouldn’t have any issues.

This part of the article is based on Nicolas Dorier article. I’ve decided to modify it slightly so that it fits the style of the entire tutorial.

BTCPay Server can be deployed and run Bitcoin and Lightning network on any Virtual Private Server which meets the minimal requirements :

1. 2048MB of RAM
2. 80GB of storage

The 80GB storage is enough if you use the pruned mode. If you want to accept other cryptocurrencies supported in BTCPay, go with a larger storage. For Bitcoin and Lightning Network, 80GB is enough.

Buying the VPS

In this tutorial, I wanted to use a VPS provider which accepts Bitcoin payments. While the list of such services is quite decent, it was a real challenge for the entire community to find an appropriate solution and find the right balance between the price and offered features. The choice came down to Canadian VPS provider – LunaNode.

LunaNode has a large number of plans. For our purpose, the ideal solution would be the c.1 plan, but its price is 20$/month.

To save a bit of money, we will go with the m.2 plan 7$/month and purchase additional storage space for $2.4. We also have to pay $3.5 as a one-time only for CPU points so that our node can sync. The total cost would be $9.4/month + $3.5 for the first month.

Creating an account

1. Click “Sign Up” and enter account information
2. Verify your email address
3. Click “Deposit Credit” to pre-fill your account
4. Choose a payment method and the amount and click “Add Credit” button.
5. Add your phone number and “Continue”
6. Verify your phone by entering 4 digit PIN you received via SMS.
7. Wait for your invoice confirmation (you will receive a confirmation e-mail)

1-CLICK BTCPay Server Deployment

From here there is no need to follow the rest of the guide on how to deploy btcpay. The video bellow will show you how to launch BTCPay Server in less than 2 minutes.

Creating the Virtual Machine

Wait for e-mail confirmation of your order. When you receive the confirmation email, click on the link. Log into LunaNode dashboard.

1. Click “Create VM” on the left-hand side menu.
2. Give your VM a name in the “hostname” field, for example – btcpay.
3. Click on the “Memory optimized” plans from the tabbed selection
4. Choose the m.2 plan
5. Scroll down, and in the “Image” section, select the operating system for your machine – Ubuntu 18.04 64-bit.
6. Create virtual machine.

Buying  additional volume

Now that we purchased our computer and installed an operating system on it, we must add a bit of storage. In laymen words, we’re plugging a 80 gigabyte USB stick into our PC.

Let’s go ahead and purchase additional storage for our virttual machine.

1. Go to “Volumes” in the dashboard.
2. Select volume location from the dropdown menu, add name and write 80 in the size field.
3. Create volume

Attaching a volume

We now created an 80GB storage, which we need to attach to our virtual machine.

1. In Volumes, scroll down to the “Volume List”
2. Find the volume you previosly created and click on to “Manage”
3. When the volume opens, choose “Attach to VM”
4. In the pop-up window, choose the virtual machine to which you want to attatch the volume.
5. Attach volume to VM

Enabling CPU usage

So far, we created our machine, installed an operating system on it, created a storage volume and attached a volume to it. Because this machine needs to sync with bloca kchain, it needs a little bit of extra power. Let’s enable additional CPU usage. If you’re using a better plan than the m.2, you probably won’t need extra settup like CPU or additional volume.

1. Virtual Machines > Find your machine > Manage.
2. Click on the “CPU” from the tabbed menu
3. From the first drop down menu “Pay for CPU utlization” – select YES.
4. Click Update.

DNS Settup

Now that we set up our Virtual Machine entirely, we need to configure our DNS. The setup will be similar t whatever host you’re using, but since our entire store setup is on SiteGround, I’ll show you on the SiteGround platform.

1. Log into your Sitegrond account.
2. From the upper menu, choose “My Account“
3. Click on go to C-panel.
4. DNS Zone Editor
5. Open a new tab in browser and go to LunaNode > Virtual Machine and select your VM.
6. In General tab of your virtual machine, copy the “External IP”
7. Go back to Siteground Simple DNS zone editor. In the add an a-record section, select the name and paste the external IP. If put the name to btcpay for example, sitegrund will immediatelly show you what will the the url location for your BTCPay Server. In my case, btcpay.wootoshi.com
8. Click “add an a-record“