BTCPay for WooCommerce V2


BTCPay Server is a free and open-source cryptocurrency payment processor which allows you to receive payments in Bitcoin and altcoins directly, with no fees, transaction cost or a middleman.

BTCPay Server is a non-custodial invoicing system which eliminates the involvement of a third-party. Payments with BTCPay WooCommerce Plugin go directly to your wallet, which increases the privacy and security. Your private keys are never uploaded to the server. There is no address re-use since each invoice generates a new address deriving from your xPub key.

You can run BTCPay as a self-hosted solution on your own server, or use a third-party host.

The self-hosted solution allows you not only to attach an unlimited number of stores and use the Lightning Network but also become the payment processor for others.

  • Direct, peer-to-peer Bitcoin and altcoin payments
  • No transaction fees (other than mining fees by cryptocurrency network itself)
  • No processing fees
  • No middleman
  • No KYC
  • User has complete control over private keys
  • Enhanced privacy (no address re-use, no IP leaks to third parties)
  • Enhanced security
  • Self-hosted
  • SegWit, Taproot support
  • Lightning Network support (LND, c-lightning and Eclair)
  • Altcoin support
  • Attach unlimited stores, process payments for friends
  • Easy-embeddable Payment buttons
  • Point of Sale app


  • The BTCPay Server invoice. Your customers will see this at the checkout. They can pay from their wallet by scanning a QR or copy/pasting it manually into the wallet.
  • Customizable plugin interface allows store owners to adjust store statuses according to their needs.
  • Customer will see the pay with Bitcoin button at the checkout.Text can be customized.
  • Example of successfully paid invoice.
  • Example of an easy-embeddable HTML donation payment button.
  • Example of the PoS app you can launch.


This plugin requires WooCommerce. Please make sure you have WooCommerce installed.

To integrate BTCPay Server into an existing WooCommerce store, follow the steps below or check our official installation instructions.

1. Deploy BTCPay Server (optional)

This step is optional, if you already have a BTCPay Server instance setup you can skip to section 2. below. To launch your BTCPay server, you can self-host it, or use a third party host.

1.1 Self-hosted BTCPay

There are various ways to launch a self-hosted BTCPay. If you do not have technical knowledge, use the web-wizard method and follow the video below.

For the self-hosted solutions, you will have to wait for your node to sync fully before proceeding to step 3.

1.2 Third-party host

Those who want to test BTCPay out, or are okay with the limitations of a third-party hosting (dependency and privacy, as well as lack of some features) can use a one of many third-party hosts.

The video below shows you how to connect your store to such a host.

2. Install BTCPay WooCommerce Plugin

BTCPay WooCommerce plugin is a bridge between your BTCPay Server (payment processor) and your e-commerce store. No matter if you are using a self-hosted or third-party solution from step 1., the connection process is identical.

You can find detailed installation instructions on our WooCommerce documentation.

Here is a quick walk through if you prefer a video:

3. Connecting your wallet

No matter if you’re using self-hosted or server hosted by a third-party, the process of configuring your wallet is the same.

4. Testing the checkout

Making a small test-purchase from your own store, will give you a piece of mind. Always make sure that everything is set up correctly before going live. The final video, guides you through the steps of setting a gap limit in your Electrum wallet and testing the checkout process.

Depending on your business model and store settings, you may want to fine tune your order statuses.


You’ll find extensive documentation and answers to many of your questions on BTCPay for WooCommerce V2 docs and on BTCPay for WooCommerce integrations FAQ.


september 4, 2022
läuft und läuft 🙂 Ein tolles plugin für woocommerce! Alles ist verständlich konfigurierbar im BTCPayserver Schade, dass Zahlen mit bitcoin so wenig verbreitet ist, dabei geht alles so einfach auch mit dem Handy. Man bräuchte die anderen teuren und komplizierten Zahlungsanbieter und die Überwachung durch diese eigentlich gar nicht mehr, aber das haben leider viele noch nicht verstanden. Vielen Dank für dieses super Plugin!
apríl 15, 2022
This plugin allows anyone to link their self-hosted BTCPay Server to manage Bitcoin payments for their WooCommerce shop with no intermediaries! How WooCommerce isn't including this in their default options is beyond me.
apríl 9, 2022
I love this open-source crypto payment processor!! What I find most incredible is, the passion/support, patience that the BTCPay Team shows to it's loyal users, no matter their skill level!! Shout-out to @ndeet and @pavlenex you guys ROCK!! - @jlee
mars 23, 2022
I have used the previous version and updated my onlineshop to the new V2 version. The upgrade worked great and I can recommend the plugin and BTCPay server to anyone who runs a WooCommerce store and wants to accept Bitcoin and Lightning payments.
Read all 6 reviews

Contributors & Developers

“BTCPay for WooCommerce V2” is open source software. The following people have contributed to this plugin.



2.3.1 :: 2023-10-20

  • Fix: Ensure refunds text does not exceed API field limit.

2.3.0 :: 2023-09-06

  • Support for high performance order storage (HPOS)

Note: This is opt-in but brings performance improvements. Follow instructions here if you want to use it.

2.2.3 :: 2023-08-22

  • Automatically create webhook after redirect.

2.2.2 :: 2023-08-22

  • Fix edgecase JS error on payment method selection.

2.2.1 :: 2023-08-17

  • Add tooltip with webhook callback information

2.2.0 :: 2023-08-17

  • Refactor settings UI and allow manual webhook secret entry. This allows 3rd party integrators limit their API keys scope and not include the webhook permission.

2.1.0 :: 2023-04-03

  • New feature: Modal / Overlay checkout mode (no redirect to BTCPay Server)

2.0.0 :: 2023-03-20

  • New feature: Add support for refunds.

Note: If you are upgrading from a version < 2.0 and you want to use refunds (via pull payments) you need to create a new API key with the “Create non-approved pull payments” which is available from BTCPay Server version 1.7.6.
See this link for more information:

If you do NOT use refunds. You do NOT need to do anything, your existing API key and setup will continue to work as before.

Changelog of older releases can be found here