496 / 736BTCPAY

BTCPay Server

Eigene Infrastruktur für den Zahlungsempfang

Du möchtest in einem kleinen Onlineshop Bitcoin annehmen und erkennen, welche Bestellungen bezahlt sind. BTCPay Server erstellt die Zahlungsseite für den Kunden und verfolgt die Eingänge für dich. Dabei kann es deine Wallet nutzen, ohne die Schlüssel zum Ausgeben zu erhalten. Entscheidend sind die Einrichtung und die Person, die den Server betreibt.

BTCPay Server ist freie Software zum Empfang von Bitcoin-Zahlungen unter der MIT-Lizenz. Du kannst sie auf einem eigenen Server betreiben oder eine fremde Installation nutzen. Sie erstellt Zahlungsanforderungen, ordnet Eingänge zu und unterstützt die Dokumentation. Das Projekt selbst ist weder ein Konto, dem du Geld anvertrauen musst, noch eine Schlichtungsstelle für Streitigkeiten über Waren.

Stell dir einen Onlinebuchladen vor. Der Kunde wählt Bitcoin und BTCPay Server erstellt eine Invoice, also eine Zahlungsanforderung über einen bestimmten Betrag. Je nach Einrichtung zeigt die Zahlungsseite eine Adresse oder eine Lightning-Anforderung. Die Software überwacht den Eingang und meldet dem verbundenen Shop Statusänderungen. So musst du nicht jede Zahlung von Hand zuordnen. Auch eine Ladenkasse oder Spendensammlung lässt sich damit betreiben. Der offene Quellcode erlaubt Prüfung und Anpassung, beweist aber allein noch nicht die Sicherheit einer bestimmten Installation. [1]

Bei einer bestehenden Wallet kann der Server einen erweiterten öffentlichen Schlüssel erhalten, aus dem er Empfangsadressen ableitet. Die privaten Schlüssel, die das Ausgeben erlauben, können außerhalb des Servers bleiben, etwa in einer Hardware Wallet. Bei einer Hot Wallet liegen die geheimen Daten dagegen auf einem mit dem Internet verbundenen Gerät. Auch der Zugang zu einem Lightning-Knoten für schnelle Zahlungen kann Ausgaben ermöglichen. Serverbetrieb und Kontrolle über das Geld sind deshalb getrennte Fragen. Das Wort self-hosted, also selbst betrieben, beantwortet sie nicht von allein. [2] [3]

Ein fremder Server kann dir Installation und Wartung abnehmen. Selbst beim Empfang in die eigene Wallet verlässt du dich jedoch auf seinen Betreiber. Ein veränderter oder kompromittierter Server kann statt deiner Adressen die eines Angreifers anzeigen. Der öffentliche Schlüssel allein erlaubt diesem nicht, bereits empfangene Coins auszugeben; eine manipulierte Kasse kann aber künftige Zahlungen umleiten. Prüfe Eingänge deshalb zusätzlich in einer unabhängigen Wallet. Dasselbe Risiko besteht bei einem angegriffenen eigenen Server. Ein fremder Betreiber beeinflusst außerdem Verfügbarkeit und Privatsphäre. [4]

Das Buch kann in tschechischen Kronen ausgezeichnet sein, während der Kunde Bitcoin zahlt. Die Invoice legt Kurs und Betrag für begrenzte Zeit fest. Processing bedeutet: Der volle Betrag wurde bezahlt, aber Bedingungen für den Abschluss, etwa Blockbestätigungen, fehlen noch. Bei Settled sind sie erfüllt; Lightning wartet normalerweise nicht auf einen Block. Unter-, Über- und verspätete Zahlungen muss der Händler gesondert behandeln. Ein manuell geänderter Status erzeugt keine Netzwerkbestätigung. Auch die bloße Preisumrechnung überweist keine Kronen auf dein Bankkonto: Ein Umtausch per Plugin oder Anbieter ist eine weitere Dienstleistung mit eigenen Bedingungen und Kosten. [5] [6] [3]

Programme verbinden sich über die Greenfield API, eine Schnittstelle für ihre Kommunikation. Der Shop speichert die Invoice-Kennung zusammen mit der Bestellung. Ein Webhook, eine automatische Servernachricht, meldet Änderungen; ihre Echtheit muss gemäß Dokumentation geprüft werden. Der API-Zugangsschlüssel erhält nur die für diesen Shop nötigen Rechte. Kommt dieselbe Nachricht erneut, darf kein zweites Buch verschickt werden. Auch die Rückkehr zur Dankesseite beweist keine Zahlung. Nach einem Ausfall sind lokale Aufzeichnungen mit den Rechnungen und tatsächlichen Zahlungen abzugleichen. [7]

Lightning Network nutzt Zahlungskanäle, sodass nicht jede Zahlung einzeln in einem Block stehen muss. Ein eigener Knoten muss erreichbar sein und eingehende Liquidität besitzen: Spielraum in den Kanälen, über den Geld zu dir gelangen kann. Das erfordert laufende Betreuung. Möglich sind Hilfe bei der Liquidität, ein Tausch zwischen Zahlungsnetzen oder ein Verwahrdienst, der Kundengelder kontrolliert. Diese Varianten unterscheiden sich bei Berechtigungen, Gebühren und Risiken. Der Name BTCPay Server auf der Zahlungsseite verrät weder die gewählte Variante noch garantiert er jede Zahlung. [8]

Die Wiederherstellungsdaten der Wallet sind kein Backup des gesamten Shops. Neben Schlüsseln brauchst du Rechnungsdaten, Einstellungen und je nach Einrichtung weitere Daten. Bei Lightning ist es besonders gefährlich, einen Knoten mit veraltetem Kanalzustand zu starten: Eine falsche Wiederherstellung kann Geld gefährden. Ein geplanter Serverumzug unterscheidet sich von einer Notfallwiederherstellung. Beim Umzug darf sich der ursprüngliche Knoten nicht weiter verändern und später nicht neben der wiederhergestellten Kopie laufen. Folge dem Verfahren für die verwendete Implementierung. Teste Lightning-Wiederherstellungen getrennt vom Netzwerk und den Gegenstellen, damit der Test keine aktiven Kanäle beeinflussen kann. Die Anleitung für Docker, eine Umgebung zum Ausführen von Anwendungsteilen in getrennten Containern, gilt für diese Installationsart. [9]

Du kannst über deine Zahlungsinfrastruktur entscheiden. Jemand muss sich dennoch um Updates, Administratorzugänge, aus dem Internet erreichbare Dienste und wiederherstellbare Backups kümmern. Die Software behält keinen Anteil jeder Zahlung ein; Hosting, Hardware, Netzwerkgebühren oder Lightning-Unterstützung können trotzdem Geld kosten. Speichere keine unnötigen personenbezogenen Kundendaten. Geht das Buch verloren oder wird es zurückgegeben, bearbeitet der Händler Reklamation und Erstattung. Die BTCPay-Entwickler entscheiden nicht über den Verkauf. Rechnungsaufzeichnungen helfen bei der Buchführung, ersetzen aber nicht sämtliche Pflichten. [10] [3] [7]

Beispiel · BTCPAY

Die Kasse fällt aus, die Wallet bleibt

Ein Shop nutzt nur die öffentlichen Daten einer externen Wallet, als sein Server ausfällt. Bereits empfangene Bitcoin unter Kontrolle ihrer Schlüssel verschwinden dadurch nicht. Kunden können aber möglicherweise keine neue Zahlungsseite öffnen und der Shop sieht keine aktuellen Bestellzustände. Nach der Wiederherstellung prüft er die Empfangseinstellungen und gleicht Rechnungen mit der Wallet ab. Für verlorene Schlüssel einer Hot Wallet auf dem Server oder die Wiederherstellung alter Lightning-Kanaldaten gilt dieses Beispiel nicht in gleicher Weise.

Für ein möglichst vollständiges Bild lies diesen Eintrag zusammen mit Bitcoin Payment Processor, Bitcoin Point of Sale, Selbstverwahrung, Lightning Network, Merchant Adoption, Bitcoin. Auf diesen Eintrag verweisen außerdem Bitcoin Coffee, Transaction Labeling, Bitcoin Payment Processor, Bitcoin Point of Sale.

01Bedeutet BTCPay Server automatisch eigene Verwahrung?

Nein. Prüfe, wer die Schlüssel der verbundenen Wallet kontrolliert und welche Rechte der Server oder Lightning-Dienst hat. Öffentliche Daten einer externen Wallet erlauben allein keine Ausgaben. Hot Wallets und Verwahrdienste können anders funktionieren. Auch ohne private Schlüssel kann eine kompromittierte Kasse falsche Adressen anzeigen.

02Reichen die Sicherungswörter der Wallet für alles aus?

Sie können die entsprechende Bitcoin-Wallet wiederherstellen, aber weder Rechnungslisten und Shop-Einstellungen noch automatisch den Lightning-Kanalzustand. Dafür braucht es eigene Backups und Verfahren. Teste sicher: Eine alte Lightning-Testkopie darf nicht so mit dem Netzwerk kommunizieren, als wäre sie der aktuelle Knoten.

DOC · 001BTCPay Server — Source repositoryPrimärquelle DOC · 002BTCPay Server — Wallet setupDokumentation DOC · 003BTCPay Server — General FAQDokumentation DOC · 004BTCPay Server — Third-party hosting risksDokumentation DOC · 005BTCPay Server — Invoice lifecycleDokumentation DOC · 006BTCPay Server — Store rates and policiesDokumentation DOC · 007BTCPay Server — eCommerce integrationDokumentation DOC · 008BTCPay Server — Lightning optionsDokumentation DOC · 009BTCPay Server — Backup and restoreDokumentation DOC · 010BTCPay Server — MaintenanceDokumentation
Überarbeitet: Quellenbasiert · Keine Anlageberatung