Install the official BTCPay plugin, point it at your BTCPay Server, authorise it, and switch it on. In full: add the plugin from WordPress, open its settings, enter your server’s address, click Generate API key, pick your store and authorise the app, then enable BTCPay under WooCommerce’s payment methods. The plugin creates the webhook for you. Then make a test purchase.
You need a BTCPay Server, version 1.3.0 or later, with a store and a wallet connected. If you don’t have one yet, here’s what BTCPay Server is and how to get one. Steps from BTCPay’s own WooCommerce guide and the plugin’s WordPress.org page, checked on 30 September 2026.
What you need
- A BTCPay Server with a store and a wallet: your own, a host’s, or one run by Myntli.
- WordPress 6.2 or newer and PHP 8.0 or newer.
- WooCommerce. The plugin is tested up to WooCommerce 11.0.
- The plugin: “BTCPay Server – Accept Bitcoin payments in WooCommerce”, version 2.8.5 at the time of writing, with over 1,000 active installations.
The six steps
- In WordPress, go to Plugins → Add New, search for “BTCPay V2”, then install and activate the plugin.
- Open WooCommerce → Settings → BTCPay Settings.
- Enter your BTCPay Server URL, the address of your server, and click Generate API key.
- In BTCPay, pick your store and click Authorize app. The key comes back to WordPress, and the webhook is created for you.
- Save, then go to WooCommerce → Settings → Payments and enable BTCPay (default).
- Place a test order on your shop and pay it.
Test it properly
Pay a small real order from a bitcoin wallet, then check three things: the order in WooCommerce is marked as paid, the invoice in BTCPay shows as settled, and the coins arrive in your own wallet. That last check matters most, because it proves the addresses on your invoices are yours.
The usual snags
- Still on the old plugin? The legacy “BTCPay for WooCommerce” plugin was closed in March 2023. Move to the V2 plugin above.
- Orders don’t update? Check that the webhook exists in your BTCPay store’s settings. Generating the key through the plugin creates it.
- Making the API key by hand? It needs the permissions the plugin lists, including changing the store’s webhooks and creating pull payments, which BTCPay uses for refunds.
- No Lightning option at checkout? It only appears if Lightning is set up on your BTCPay store.
Or have it done for you
Myntli sets up the whole chain: your BTCPay store on our full bitcoin node, on your own domain, the WooCommerce plugin connected, and a real test payment before you take a single order. $29 a month with no percentage, or $449 once to install it all on your own server.
Questions people ask about BTCPay and WooCommerce
Is there a BTCPay plugin for WooCommerce?
Yes: “BTCPay Server – Accept Bitcoin payments in WooCommerce”, free on WordPress.org. It connects your shop to your own BTCPay Server.
Does BTCPay charge a fee on WooCommerce sales?
No. BTCPay Server and the plugin are free and take no percentage. Your costs are the server BTCPay runs on, and the normal network fee your customers pay.
Do I need my own server?
You need a BTCPay Server somewhere: your own, a host’s, or one run for you. The plugin only connects WooCommerce to it.
What happened to the old BTCPay WooCommerce plugin?
The legacy “BTCPay for WooCommerce” plugin was closed on WordPress.org in March 2023. Use the V2 plugin instead.
How do I know it works?
Place a small real order and pay it. The WooCommerce order should be marked as paid, the BTCPay invoice settled, and the coins should arrive in your own wallet.
From docs.btcpayserver.org/WooCommerce and the plugin’s page on WordPress.org, checked on 30 September 2026. See also: BTCPay on Shopify and how to accept bitcoin payments.