BTCPay Server + WooCommerce: The Sovereign Merchant’s Guide to Accepting Bitcoin

If you run a business and you are not accepting Bitcoin, you are leaving sovereignty on the table. Every payment that flows through Visa, Mastercard, or PayPal passes through intermediaries who can freeze your funds, reverse transactions, and surveil your customers. BTCPay Server eliminates every single one of those middlemen. Combined with WooCommerce, it gives you a self-custodial, censorship-resistant payment stack that you fully control — no permission required.

At D-Central Technologies, we run our own WooCommerce store on BTCPay Server. We accept Bitcoin for everything from Bitaxe solo miners to Bitcoin Space Heaters to ASIC repair services. This is not theoretical advice — this is battle-tested infrastructure we deploy every day to serve thousands of home miners across Canada and worldwide.

This guide walks you through why BTCPay Server is the only payment processor worth running, how to integrate it with WooCommerce step by step, and how to harden your setup for production use.

Why BTCPay Server? Because Your Keys, Your Commerce

BTCPay Server is an open-source, self-hosted Bitcoin payment processor. No third party touches your funds. No KYC requirements. No transaction fees taken by the payment processor. Payments go directly from your customer’s wallet to yours — peer-to-peer, as Satoshi intended.

Here is why this matters for any business that takes sovereignty seriously:

• Zero processor fees — BTCPay charges nothing. You only pay the Bitcoin network mining fee, which your customer covers.
• Self-custodial — Your private keys never leave your server. No custodial risk. No exchange counterparty risk.
• Censorship-resistant — No payment processor can deplatform you, freeze your account, or reverse a settled transaction.
• Privacy-preserving — BTCPay generates a new address for every invoice. No address reuse. No data harvesting.
• Lightning Network support — Accept instant, near-zero-fee payments over Lightning for a seamless checkout experience.
• Open-source and auditable — The entire codebase is on GitHub. No black boxes. No trust required — verify everything.

Compare this to custodial processors like BitPay, which require KYC, charge processing fees, can freeze your funds, and have historically censored certain merchants. BTCPay Server is the antithesis of that model. It is the cypherpunk answer to payment processing.

BTCPay Server vs. Custodial Payment Processors

Before diving into the integration, let us be absolutely clear about why self-custody matters for your business payments. The following table breaks down the fundamental differences:

The choice is clear. If you believe in Bitcoin’s core value proposition — censorship resistance, self-sovereignty, peer-to-peer transactions — then a custodial payment processor contradicts everything you stand for. BTCPay Server is the only option that actually respects the protocol.

What You Need Before Starting

Before you begin the integration, make sure you have the following infrastructure ready:

Pro tip from our workshop: We strongly recommend using a hardware wallet (Coldcard is the gold standard) and importing only the xpub key into BTCPay. Your private keys never touch the server. This is non-negotiable for production use.

Step-by-Step: Integrating BTCPay Server with WooCommerce

Step 1 — Deploy Your BTCPay Server

You have several deployment options. Choose based on your technical comfort level:

• LunaNode (one-click deploy) — Fastest option. LunaNode offers a one-click BTCPay Server deployment. You get a VPS with BTCPay pre-configured in under 10 minutes.
• Voltage — Managed Lightning + BTCPay hosting. Good if you want Lightning without managing the node yourself.
• Self-hosted VPS — Full control. Spin up a VPS (minimum 2GB RAM, 80GB+ SSD for pruned node), install Docker, and run the BTCPay deployment script.
• Raspberry Pi / Home server — Maximum sovereignty. Run everything on hardware you physically control. Projects like Umbrel and Start9 make this straightforward.

For the self-hosted route, the deployment is a single Docker command:

# Clone and launch BTCPay Server
git clone https://github.com/btcpayserver/btcpayserver-docker
cd btcpayserver-docker
export BTCPAY_HOST="btcpay.yourdomain.com"
export NBITCOIN_NETWORK="mainnet"
export BTCPAYGEN_CRYPTO1="btc"
export BTCPAYGEN_LIGHTNING="clightning"
export BTCPAYGEN_REVERSEPROXY="nginx"
. ./btcpay-setup.sh -i

Once deployed, access your BTCPay Server dashboard, create a store, and connect your wallet by importing your hardware wallet’s xpub key.

Step 2 — Install the BTCPay for WooCommerce V2 Plugin

1. In your WordPress admin dashboard, navigate to Plugins > Add New.
2. Search for “BTCPay for WooCommerce V2” — this is the official, actively maintained plugin.
3. Click Install Now, then Activate.
4. Navigate to WooCommerce > Settings > Payments and enable BTCPay Server.

Step 3 — Connect WooCommerce to Your BTCPay Server

1. In the BTCPay payment gateway settings within WooCommerce, enter your BTCPay Server URL (e.g., https://btcpay.yourdomain.com).
2. Click “Generate API Key” — this redirects you to your BTCPay Server to authorize the connection.
3. On BTCPay Server, approve the requested permissions (create invoices, view invoices, manage store).
4. The API key auto-populates back in WooCommerce. Click Save Changes.

Step 4 — Configure Payment Settings

Once connected, configure these critical settings in WooCommerce > Settings > Payments > BTCPay Server:

• Order states mapping — Map BTCPay invoice states (New, Paid, Confirmed, Complete) to WooCommerce order statuses (Pending, Processing, Completed).
• Payment speed — Set confirmation requirements. “High speed” (0-conf) for small orders, “Medium” (1 confirmation) for standard, “Low” (6 confirmations) for high-value orders.
• Invoice expiration — Default is 15 minutes. We recommend keeping this or extending to 30 minutes for larger orders.
• Lightning Network — If your BTCPay instance has Lightning configured, it is automatically offered at checkout alongside on-chain payments.

Step 5 — Test the Integration

Before going live, run test transactions:

1. Place a test order on your WooCommerce store and select Bitcoin as the payment method.
2. Verify the BTCPay invoice page loads correctly with both on-chain and Lightning payment options.
3. Complete a small real payment to confirm the full flow: invoice creation, payment detection, order status update.
4. Check that the payment arrives in your connected wallet.

Lightning Network: The Game Changer for E-Commerce

On-chain Bitcoin transactions are settled and final, but they take time — typically 10-60 minutes for confirmations. For e-commerce, especially for smaller purchases like mining accessories and parts, this can create friction.

The Lightning Network solves this completely. Lightning payments settle in seconds, cost fractions of a cent in fees, and are natively supported by BTCPay Server. When a customer checks out, the BTCPay invoice page shows both an on-chain Bitcoin address and a Lightning invoice — the customer chooses their preferred method.

For a mining hardware store like D-Central, Lightning is particularly powerful. A customer buying a Bitaxe heatsink for $15 CAD can pay over Lightning and have the transaction confirmed before they close the browser tab. No chargebacks. No processing fees. No intermediaries. Just peer-to-peer value transfer at the speed of light.

Security Hardening for Production

Running a payment server is serious business. Here is our recommended security checklist — the same practices we follow at D-Central:

• Hardware wallet only — Never generate a hot wallet on BTCPay for production use. Import your Coldcard or Trezor xpub. Your private keys stay on the hardware device.
• SSH key authentication — Disable password authentication on your BTCPay VPS. Use SSH keys only.
• Firewall configuration — Only expose ports 80, 443, and 9735 (Lightning). Block everything else.
• Automatic updates — BTCPay’s Docker deployment includes an auto-update mechanism. Enable it.
• Regular backups — Back up your BTCPay data directory, especially the Lightning channel database. A lost channel database means lost funds.
• Tor hidden service — BTCPay supports Tor out of the box. Enable it for an additional privacy layer.
• Two-factor authentication — Enable 2FA on your BTCPay admin account. Non-negotiable.

Operational Best Practices

Wallet Management

BTCPay derives a new Bitcoin address for every invoice from your xpub key. This means you never reuse addresses — which is critical for privacy. However, it also means you need to monitor your wallet gap limit. If you generate many invoices that go unpaid, your wallet software might not scan far enough ahead to find your actual balance. Most modern wallets handle this well, but keep it in mind.

Accounting and Tax Compliance

BTCPay Server provides detailed export functionality. You can export all invoices as CSV with timestamps, amounts in both BTC and fiat, payment method (on-chain vs. Lightning), and order references. For Canadian businesses, this data feeds directly into your CRA reporting obligations. We recommend exporting monthly and reconciling with your WooCommerce orders.

Handling Refunds

Bitcoin transactions are irreversible — that is a feature, not a bug. For refunds, BTCPay Server has a built-in refund mechanism where you can issue a refund to a customer-provided address. The key difference from fiat: you initiate the refund manually and choose the exchange rate (original rate or current rate). Build clear refund policies into your store terms.

Monitoring and Uptime

Your BTCPay Server must be online for invoices to be created and payments to be detected. Set up uptime monitoring (UptimeRobot, Hetrix, or similar) and configure email alerts for downtime. If your BTCPay instance goes down during a customer checkout, the payment will fail — and you lose the sale.

Why D-Central Runs BTCPay Server

We are Bitcoin Mining Hackers. We take institutional-grade mining technology and hack it into accessible solutions for home miners across Canada and worldwide. That same hacker ethos applies to our payment infrastructure.

We do not ask permission from payment processors to sell mining hardware. We do not hand over 3% of every transaction to Stripe. We do not risk having our merchant account frozen because some compliance officer does not understand Bitcoin mining equipment.

We run our own BTCPay Server because it aligns with everything we believe: self-sovereignty, decentralization, censorship resistance, and the conviction that Bitcoin is not just money — it is a tool for freedom.

Every purchase made on our store with Bitcoin flows directly to our wallet. No middlemen. No permission. No surveillance. That is the standard every Bitcoin business should hold itself to.

If you are building a mining operation and need hardware — from Bitaxe solo miners to full ASIC rigs — or if your miners need professional repair, we are here to help. And yes, we accept Bitcoin.

Frequently Asked Questions

The Bitaxe $189.99 – $269.99Price range: $189.99 through $269.99

Shop The Bitaxe →