BTCPay Server für WooCommerce selbst hosten (Vollständige Anleitung 2025)
Dieser Leitfaden zeigt dir Schritt für Schritt, wie du deinen BTCPay Server für WooCommerce Bitcoin Zahlungen und WooCommerce Lightning Zahlungen nutzen kannst und wie du deinen BTCPay Server ganz einfach mit WooCommerce verbindest.
Wir erklären, warum BTCPay für selbst gehostete Bitcoin-Zahlungen geeignet ist, wie du es einsetzt, für wen und für welche Geschäftsfälle WooCommerce Lightning Payment von Coinsnap die richtige Wahl ist, sowie Best Practices, Grundlagen der Compliance/Buchhaltung und Fehlerbehebung.
Warum BTCPay Server für WooCommerce Bitcoin und WooCommerce Lightning Zahlungen?
BTCPay Server ist der führende und verbreitetste selbst gehostete Open-Source Bitcoin-Zahlungsprozessor. Wenn du einen hast, behältst du alle Schlüssel und Daten, zahlst keine Plattformgebühr und kannst sowohl on-chain-BTC als auch Lightning von jeder Quelle und natürlich auch von deinem WooCommerce-Shop akzeptieren.
Einige Woo-Shop-Besitzer möchten WooCommerce Bitcoin mit ihrem BTCPay-Server anbieten, denn im Gegensatz zu verwahrten Bitcoin-Zahlungsanbietern müssen sie sich mit einem selbst gehosteten BTCPay-Server nicht um das Onboarding von Drittanbietern kümmern: Es gibt kein KYB/KYC, um BTC/Lightning auf ihre eigene Wallet zu akzeptieren – sie gehen mit Schlüsseln in Betrieb, die sie kontrollieren.
Außerdem gibt es keine Prozessor-Caps oder Holds, so dass der Cashflow frei skalierbar ist (egal ob 200 € oder 200.000 €+) und sofort ausgeglichen wird.
Und nicht zuletzt bist du nicht an Verbote von Anbieterkategorien gebunden
– du kannst im Grunde jede Art von Geschäft betreiben, solange es in deinem Heimatland nicht illegal ist. Wie alle Händler musst du natürlich die lokalen gesetzlichen, steuerlichen und verbraucherrechtlichen Verpflichtungen erfüllen (und bei einer späteren Umwandlung in Fiat wird KYC erforderlich sein).
Für reine Bitcoin/Lightning Zahlungen bietet dir dein eigener BTCPay-Server also maximale Souveränität, Geschwindigkeit und Freiheit.
Was ist ein selbst gehosteter BTCPay-Server?
Ein selbst gehosteter BTCPay-Server ist einfach deine eigene BTCPay-Instanz, die auf einem Webserver läuft (auf dem du ihn installiert hast).
Der Server stellt das Benutzerkonto, den Speicher und die Rechenleistung zur Verfügung; BTCPay führt dann deinen Bitcoin- (und optional Lightning-, siehe unten) Stack aus, erstellt Rechnungen und kommuniziert mit deinem Shop – ohne einen Drittanbieter-Prozessor.
Du behältst die Schlüssel, Daten und die Konfiguration und bist für die Betriebszeit, die Updates und die Sicherheit verantwortlich; verschiedene Hoster können den zugrunde liegenden Webspace bereitstellen, aber es bleibt dein BTCPay Server.
Du kannst BTCPay Server auf jedem webfähigen Server einrichten, aber schlüsselfertige „geskriptete“ Anbieter wie LunaNode und Voltage bieten vorkonfigurierte Images und Assistenten, die die Einrichtung, SSL und laufende Updates vereinfachen.
„Leerer“ VPS vs. BTCPay-„freundlicher“ Hoster (schneller Vergleich)
- DIY (auf jedem beliebigen VPS)
- Vorteile: Maximale Kontrolle, potenziell niedrigste monatliche Kosten, volle Anpassungsfähigkeit.
- Nachteile: Du bist für die Sicherheit, Docker/OS-Updates, Domain/SSL, Backup-Strategie selbst verantwortlich und musst rund um die Uhr auf Vorfälle reagieren können.
- Skript-unterstützte Einrichtung (auf einem „BTCPay-ready“ VPS)
- Vorteile: Schnellere Einrichtung, sinnvolle Voreinstellungen, Snapshots, einfachere Wartung; ideal für Händler, die Zuverlässigkeit wollen, ohne einen Server selber zu betreiben.
- Nachteile: BTCPay Server-optimierte Hosts können etwas teurer sein als ein reiner VPS; ein solides LunaNode-Setup kostet zum Beispiel etwa $15 pro Monat
Warum einen spezialisierten BTCPay-Server-Hoster (wie LunaNode oder Voltage) wählen?
- Zeit bis zur Inbetriebnahme: Mit den vorgefertigten BTCPay-Bildern und -Vorlagen bist du in wenigen Minuten live, nicht in Stunden.
- SSL & Updates: Optimiertes HTTPS und einfacheres Lifecycle-Management (Docker, Abhängigkeiten, Kernel-Updates).
- Leistung und Betriebszeit: Rechenleistung/Speicherplatz für einen Knotenpunkt, der rund um die Uhr Rechnungen bearbeitet.
- Backups & Wiederherstellung: Snapshots und Wiederherstellungspfade reduzieren das Risiko von Ausfallzeiten.
- Vorhersehbarkeit: Transparente Preise für CPU/RAM/Speicher; du erweiterst nur bei Bedarf.
- Weniger Überraschungen: Keine Port-, Firewall- oder Speicherdruck-Anforderungen, die den Checkout zu Spitzenzeiten entgleisen lassen.
Empfehlung: Wenn du keine Erfahrung mit dem Betrieb von Linux-Produktionsservern hast, solltest du mit einem speziellen BTCPay-Host wie LunaNode oder Voltage beginnen. Damit bekommst du einen stabilen BTCPay-Server mit minimalem DevOps-Aufwand, sodass du dich auf den Verkauf und nicht auf die Server-Logs konzentrieren kannst.
BTCPayServer.org bietet hier eine Liste empfohlener Hoster mit Beschreibungen und Schritt-für-Schritt-Anleitungen zur Installation.
Installation eines BTCPay-Servers (Beispiel: LunaNode)
Hier bekommst du einen Überblick über die Einrichtung aus der Vogelperspektive – die wichtigsten Schritte in der richtigen Reihenfolge – ohne die kleinsten Befehle oder Screenshots. Du siehst, was zu tun ist, ohne jedes technische Detail verstehen zu müssen. Nutze diesen Überblick, um Zeit und Ressourcen einzuplanen, und folge dann einer detaillierten Anleitung für die genauen Schritte.
- Erstelle ein LunaNode-Konto und gib deine Rechnungsdaten an.
- Setze den BTCPay Server mit der App-Vorlage oder dem Image ein (wähle die Region, CPU/RAM und SSD, die deinem erwarteten Volumen entsprechen).
- Richte deine Domain (z. B. pay.deinedomain.com) über einen A-Record auf die IP der Instanz.
- Rufe BTCPay auf (folge dem Assistenten auf dem Bildschirm/Domain). Stelle sicher, dass HTTPS aktiv ist.
- Lege den Admin-Benutzer an und erstelle dann deinen Store in BTCPay (stelle die Fiat-Währung ein, z. B. EUR/USD).
- Füge Zahlungsarten hinzu:
- On-chain: Verbinde/erstelle eine Wallet (xpub/descriptor oder Hardware-Wallet).
- Lightning: Wähle deine Implementierung (LND oder Core Lightning), initialisiere Kanäle/Liquidität.
Das war’s im Grunde – du hast jetzt einen funktionierenden BTCPay Server. Aber um ihn zu nutzen, um WooCommerce Bitcoin- oder WooCommerce Lightning-Zahlungen zu akzeptieren, musst du den BTCPay Server mit WooCommerce auf deiner WordPress-Seite verbinden.
Wie verbinde ich meinen BTCPay Server mit meinem WooCommerce Shop?
Um deinen BTCPay Server mit WooCommerce zu verbinden, hast du zwei einfache Möglichkeiten: das BTCPay Server for WooCommerce Plugin und das Coinsnap for WooCommerce Plugin. Beide sind einfach zu installieren und zu konfigurieren – welche Option ist also die richtige für dich?
Das BTCPay Server Plugin
Verwende das WooCommerce-Plugin von BTCPay Server, wenn deine Kunden hauptsächlich On-Chain bezahlen. Auch wenn du den nativen Weg bevorzugst und die gesamte Kontrolle über den Zahlungsprozess behalten willst, ist dies das richtige Plugin für dich.
Aber es gibt einen Haken: Wenn du relevante WooCommerce-Lightning-Umsätze hast, musst du einen Lightning-Knoten auf deinem BTCPay-Server einrichten und betreiben – und das kann schnell zu Kopfschmerzen führen, denn der Betrieb eines eigenen Knotens bringt echte Verantwortung und Herausforderungen mit sich:
1) Du brauchst zuverlässige Liquidität im Eingang (Kanäle zu gut vernetzten Peers öffnen oder Liquidität/LSPs kaufen), verwalten Kanal-Funktionalität (Rebalancing, Gebührenpolitik, Kapazitätszuweisung), und musst 24/7 Erreichbarkeit sicherstellen (Port 9735/TCP, NAT/Firewall, Tor oder Clearnet), um fehlgeschlagene Routen zu vermeiden.
2) Du musst für die Sicherheit planen: Hot-Wallet-Risiko, strenge Serverhärtung, statische Channel-Backups (LND) oder Key/State-Backups (CLN) und idealerweise einen Monitor.
3) Rechne mit On-Chain-Kosten für Eröffnungen/Zwangsschließungen, die bei Überlastung in die Höhe schnellen, sowie mit Routine-Updates (BTCPay, LND/CLN) und Überwachungen/Alarmen für Liquidität, festsitzende HTLCs und Speicherplatz.
4) Stimme schließlich die Buchhaltung ab, indem du die LN-Rechnungen und die Abrechnung mit den WooCommerce-Bestellungen abstimmst, und definiere ein Lastenheft für Vorfälle (Zwangsschließung, Sweep-Fonds, Wiederherstellung aus dem Backup), bevor du in Betrieb gehst.
Langer Rede kurzer Sinn: BTCPay Server for WooCommerce eignet sich hervorragend, wenn dein Shop höherpreisige Artikel verkauft, bei denen die Kunden aufgrund der typischen Lightning-Wallet-Limits von rund 1.000 US-Dollar pro Zahlung lieber (oder notwendigerweise) on-chain bezahlen.
Das Coinsnap für WooCommerce Plugin
Coinsnap für WooCommerce ist die perfekte Lösung, wenn du einen BTCPay Server hast, aber keinen eigenen Lightning Node betreiben möchtest.
Behalte BTCPay für die On-Chain-Souveränität und größere Tickets, während Coinsnap eine verwaltete Lightning-Schieneanbietet – keine Kanäle, Liquidität oder Node-Uptime, auf die du aufpassen musst – und direkt auf deine Lightning-Wallet abrechnet.
Der integrierte BTCPay-Assistent verknüpft alles in wenigen Klicks, sodass du aus Geschwindigkeits- und Kostengründen auf Lightning setzen und bei Bedarf auf On-Chain zurückgreifen kannst.
Jetzt zeigen wir dir, wie einfach es ist, diese Plugins zu installieren:
Klassische DIY-Methode: das BTCPay for WooCommerce Plugin einbinden
Du bevorzugst den nativen Weg und möchtest innerhalb des BTCPay-Ökosystems bleiben? Einfacher geht’s nicht:
So installierst du BTCPay Server für WooCommerce
- Installiere das BTCPay Server-WordPress Plugin in WordPress.
- In BTCPay: Konto → API-Schlüssel → Erstelle einen Greenfield-API-Schlüssel mit den richtigen Berechtigungen (Achtung: potenzielle Fehlerquelle!) für deinen Store.
- Kopiere deine Store ID.
- In WooCommerce → Zahlungen → BTCPay fügst du die BTCPay URL, den API-Schlüssel und die Store ID ein; Aktivieren und speichern.
1.
Installiere das BTCPay Woo Plugin
2.
Verbinde dein Portemonnaie
3.
Teste den Checkout
(C) Videos: BTCPayserver.org
Du hast den BTCPay Server nun erfolgreich mit deinem WooCommerce-Shop verbunden und bist bereit, Bitcoin-Zahlungen on-chain zu akzeptieren. Wenn du auch Lightning anbieten möchtest, musst du einen Lightning-Knotenpunkt innerhalb deines BTCPay Servers einrichten und betreiben, was die oben beschriebenen Aufgaben mit sich bringt (Kanal- und Inbound-Liquiditätsmanagement, 24/7-Betriebszeit, Backups/Aktualisierungen, Gebühren/Kapazitätsüberwachung).
Coinsnap: BTCPay WooCommerce Bitcoin Lightning Zahlungen akzeptieren, ohne einen eigenen Lightning Knoten zu betreiben
Coinsnap für WooCommerce kümmert sich um den gesamten Lightning-Flow für dich – du musst keinen Knotenpunkt betreiben und keine Kanäle verwalten – und schreibt jede Zahlung direkt und in Echtzeit auf deiner eigenen Wallet gut.
Installiere einfach das Plugin (du musst dafür nicht einmal ein Konto bei Coinsnap einrichten!), füge deine Anmeldedaten ein und schon bist du mit einer schnellen, kostengünstigen Lightning-Kasse (mit optionalem On-Chain-Fallback) live. Da die Gelder auf deine Wallet überwiesen werden, gibt es kein KYB/KYC für BTC/LN-Auszahlungen, weniger operativen Aufwand und ein reibungsloses Käufererlebnis vom QR-Scan bis zur Bestellbestätigung.
So kannst du zwei alternative Methoden in WooCommerce auflisten – Bitcoin (on-chain) über deinen BTCPay-Server und Lightning-Zahlungen, die von Coinsnap an deinen BTCPay-Server weitergeleitet werden – damit deine Kunden die Wahl haben, die sie brauchen.
So installierst du Coinsnap für WooCommerce
- Installiere Coinsnap für WooCommerce in deinem WordPress-Backend (wenn du BTCPay Server nutzt, brauchst du nicht einmal ein Konto bei Coinsnap zu eröffnen!)
- Gehe dann zurück zu den WooCommerce Coinsnap-Einstellungen in deinem WordPress, gib deine BTCPay-URL ein und klicke auf API-Schlüssel generieren
- Bestätige die 2 folgenden Aufforderungen deines BTCPay Servers
- und alle Einträge in den WooCommerce Coinsnap-Einstellungen sehen
1.
installiere das Coinsnap Plugin
2.
Startassistent
3.
bestätige die Aufforderungen von BTCPay
4.
WooCommerce ist jetzt verbunden
(zum Vergrößern auf die Bilder klicken)
Siehe die ausführliche Anleitung zur Installation von Coinsnap für WooCommerce
Neben dem WooCommerce-Plugin bietet Coinsnap eine Reihe von BTCPay-Server-kompatiblen Plugins, die du später hinzufügen kannst, um neue Geschäftsmodelle oder Funktionen auf deiner Website freizuschalten – alle zahlbar in Bitcoin, wobei die Gelder direkt auf deinen BTCPay-Server überwiesen werden.
Empfohlene Einstellungen (funktioniert bei den meisten Shops)
Mit dem Coinsnap-Plugin sind die sinnvollen Standardeinstellungen – Lightning on, on-chain fallback, rate-lock und order-status mapping – bereits voreingestellt, sodass du WooCommerce Lightning-Zahlungen mit minimalen Anpassungen überprüfen und anbieten kannst.
Wenn du den BTCPay Server selbst einrichtest, solltest du auf Folgendes achten:
- Lightning: EIN (Standard-Rail für Geschwindigkeit/Kosten).
- On-Chain: EIN (Fallback für große Warenkörbe oder auf Kundenwunsch).
- Rate lock: 10-15 Minuten.
- Zuordnung des Bestellstatus: „Bezahlt → In Bearbeitung“ (oder „Abgeschlossen“ für sofort lieferbare digitale Waren).
- Währungen: Behalte die Shop-Währung als Fiat; BTCPay zeigt BTC/Sats-Beträge an.
Aufgaben, um die du nicht herumkommst, wenn du deinen eigenen BTCPay Server für WooCommerce betreibst
Freiheit und Unabhängigkeit bringen Verantwortung mit sich: Wenn du dich dafür entscheidest, deinen eigenen BTCPay Server zu betreiben, musst du folgende Themen stets im Auge haben:
Sicherheit, Wartung und Überwachung
- Backups: Speichere Seeds (On-Chain) und Channel-Backups (Lightning) offline und redundant.
- Updates: Wende BTCPay/Docker/OS-Updates nach einem Zeitplan an; bevorzuge Wartungsfenster.
- Zugang: Starke Passwörter, 2FA für BTCPay-Admin; Firewall nur benötigte Ports.
- Überwachung: Uptime-Checks, Festplattenplatz-Warnungen, Lightning Channel Health; Log-Überprüfung.
Compliance, Buchhaltung und Abrechnung (praktische Sicht)
- Compliance: Selbstgehostet bedeutet in der Regel, dass kein KYB/KYC mit einem Auftragsverarbeiter erforderlich ist, aber das lokale Steuer-/Verbraucherrecht gilt weiterhin (Rechnungsstellung, Mehrwertsteuer, Erstattungsrichtlinien).
- Buchhaltung: Erfasse den BTC-Betrag, den Fiat-Wert zum Zeitpunkt der Zahlung, den Kurs, die Bestell-ID, ggf. auch die TXID/den Zahlungs-Hash. Exportiere CSV-Dateien von BTCPay (oder deinem Woo-Plugin) und gleiche sie regelmäßig mit deinen Zahlungseingängen ab.
- Wahlmöglichkeiten bei der Abrechnung:
- Halte BTC/LN (Selbstverwahrung) und wandle sie später zu deinen Bedingungen um.
- Automatische Fiat-Auszahlungen über einen Off-Ramp-Partner (wenn du dich später entscheidest, dass du EUR in der Bank haben möchtest).
- Hybrid: Lightning für das Tagesgeschäft, mit on-chain-Option für große Warenkörbe; regelmäßige Entnahme in Fiat, um Währungsschwankungen auszugleichen (ausser du behälst deine Bitcoin als langfristiges Investment).
Prüfung und Fehlerbehebung
- Führe zwei Tests durch: einen Lightning-Test und einen On-Chain-Test (kleine Beträge). Kontrolliere den von WooCommerce erkannten Zahlungsstatus.
- Zeitüberschreitungen bei Rechnungen: Richte das Ablaufdatum von BTCPay-Rechnungen an den Zeitplan von WooCommerce-Sessions/Checkouts aus.
- „Bezahlte, aber ausstehende“ Bestellungen: Überprüfe die API-Berechtigungen, die Store ID und die Erreichbarkeit des Callbacks (keine Firewall/Caching-Blockierung).
- Lightning-Ausfall: Überprüfe die eingehende Liquidität, die Kanalgebühren und die Betriebszeit des Knotens; versuche eine zweite Wallet, um das Problem einzugrenzen.
Wann solltest du Coinsnap anstelle eines vollständigen Selbsthostings nutzen?
Coinsnap ist ein praktisches Add-on für Händler, die bereits einen BTCPay-Server betreiben, aber keinen eigenen Lightning-Knoten verwalten möchten.
Behalte BTCPay für die On-Chain-Souveränität und größere Tickets und überlasse Coinsnap die Abwicklung der Lightning Rail – lass Coinsnap die Kanäle, Liquidität oder Node-Uptime verwalten, anstatt es selbst zu machen!
Der integrierte BTCPay-Assistent verknüpft alles in wenigen Klicks, Zahlungen werden direkt auf deine Wallet überwiesen und du kannst beide Methoden an der Kasse anbieten (Lightning über Coinsnap, On-Chain über BTCPay), ohne die Kontrolle zu verlieren.
Und du brauchst nicht einmal ein Coinsnap-Konto, um das Plugin zu nutzen!
FAQ
Does WooCommerce support Bitcoin natively?
No. You add Bitcoin/Lightning via a plugin. BTCPay Server (self-hosted) or a WooCommerce Bitcoin plugin like Coinsnap makes it work.
Is self-hosting hard?
If you know Linux, it's not too hard. if not, it’s manageable with a BTCPay-ready host like LunaNode. You’ll still handle periodic updates and basic ops.
What’s the easiest WooCommerce connection to BTCPay?
The Coinsnap plugin wizard: enter BTCPay URL, click Generate API Key, confirm prompts, enable, test.
Do I need Lightning and on-chain?
Most stores enable both: Lightning for everyday speed/cost; on-chain as a fallback for large tickets.
How do I avoid accounting headaches?
Record fiat value at payment time, rate, BTC amount, and TXID/payment hash; export CSVs and reconcile monthly.
Fazit: Der praktische Weg zu WooCommerce Lightning Payment mit BTCPay Server
Für selbst gehostete Bitcoin-Zahlungsabwicklung mit maximaler Kontrolle ist BTCPay Server + WooCommerce kaum zu schlagen.
Verwende einen spezialisierten Hoster wie LunaNode oder Voltage, um den Aufwand bei Bereitstellung und Wartung zu verringern, und verbinde WooCommerce mit Coinsnap, wenn du viele Lightning-Umsätze erwartest und keinen eigenen Lightning-Knoten betreiben willst.
Aktiviere beide Methoden – Lightning über Coinsnap und On-Chain über deinen BTCPay Server – um deinen Kunden einen schnellen, modernen Checkout zu bieten, der die Gebühren senkt und die Konversion steigert, ohne deine Souveränität zu opfern.
Akzeptiere jetzt Bitcoin mit deinem BTCPay Server und WooCommerce
Du hast einen BTCPay-Server und einen WooCommerce-Shop? Mit dem Coinsnap for WooCommerce Plugin kannst du WooCommerce Bitcoin und WooCommerce Lightning Zahlungen in wenigen Minuten aktivieren. Installiere das Plugin, starte den Assistenten und schon kannst du WooCommerce Bitcoin und WooCommerce Lightning Zahlungen empfangen:
