495 / 691PAY·PROC

Bitcoin Payment Processor

Bitcoin-Zahlungsabwickler

Eine Software oder ein Dienst verbindet eine Bestellung mit einer Bitcoin-Zahlung, verfolgt deren Status und meldet das Ergebnis an die Kasse. Verwahrung, Zahlungsbestätigung und anschließende Auszahlung hängen von der jeweiligen Lösung ab.

Bitcoin Payment Processor erstellt Zahlungsanforderungen, ordnet eingehende Zahlungen Bestellungen zu und unterstützt die Dokumentation. Er kann selbst betrieben oder als Dienst genutzt werden. Er ist keine Bitcoin-Konsensregel, und die Bezeichnung Zahlungsabwickler sagt nicht, wer die Mittel kontrolliert.

Der Shop legt eine Bestellung an und sein Server fordert beim Zahlungsabwickler eine Rechnung mit Betrag und Währung an. Er speichert die Zuordnung zwischen interner Bestellnummer und Rechnungskennung. Der Kunde erhält eine Zahlungsseite oder einen QR-Code, und der Abwickler überwacht den Eingang. Ohne diese Zuordnung lässt sich nicht zuverlässig bestimmen, welche Bestellung die Zahlung erfüllt; die bloße Rückkehr im Browser beweist keine Zahlung. [BTCPay Server — eCommerce integration]

BTCPay Server kann Empfangsadressen aus den öffentlichen Daten einer vorhandenen Wallet ohne deren privaten Schlüssel ableiten. Das unterscheidet sich von einer auf dem Server gespeicherten Hot Wallet und vom Zugriff auf die Mittel eines Lightning-Knotens. Ein Anbieter kann Mittel bis zur Auszahlung halten. Prüfen Sie den tatsächlichen Schlüsselbesitz, die Berechtigungen und die Auszahlungsmöglichkeit statt nur den Produktnamen oder das Wort non-custodial. [BTCPay Server — General FAQ] [BitPay — Configuring settlements]

Eine gewöhnliche Rechnung von BTCPay Server fixiert den Wechselkurs für begrenzte Zeit. Ihr Ablauf verhindert nicht, dass später noch eine Überweisung eingeht. Unterzahlungen, Überzahlungen und verspätete Zahlungen haben unterschiedliche Status und benötigen Folgeprozesse. Bewahren Sie den ursprünglichen Betrag und den verwendeten Wechselkurs auf; bei verändertem Preis kann eine neu ausgestellte Anforderung eine andere Anzahl Satoshis verlangen. [BTCPay Server — Invoice lifecycle]

BTCPay Server unterscheidet Processing, das auf die eingestellten Bestätigungen wartet, von Settled; erfolgreiche Lightning-Zahlungen wechseln ohne Warten auf einen Block zu Settled. Statusnamen anderer Anbieter sind nicht automatisch gleichbedeutend: BitPay warnt ausdrücklich, dass paid keine Zahlungsgarantie ist. Der Shop braucht eine Auslieferungsregel für den jeweiligen Status und die konkrete Zahlungsmethode. Eine manuelle Statusänderung erzeugt keine Netzwerkbestätigung. [BTCPay Server — Invoice lifecycle] [BitPay — Invoice webhooks]

BTCPay prüft einen Webhook mit HMAC-SHA256 über die ursprünglichen Bytes des Nachrichtenkörpers und ein gemeinsames Geheimnis. BitPay beschreibt unsignierte IPN: Die Benachrichtigung veranlasst eine API-Abfrage des Rechnungsstatus und ist selbst kein vertrauenswürdiger Nachweis. Benachrichtigungen können mehrfach eintreffen. Die Integration muss daher ein erneut zugestelltes Ereignis zuverlässig erkennen und einen zweiten Versand derselben Bestellung verhindern; nach einem Ausfall müssen gespeicherte Status mit dem Abwickler abgeglichen werden. [BTCPay Server — Webhook validation example] [BitPay — Invoice webhooks]

Die Bestätigung der Kundenzahlung muss nicht zeitgleich mit der Auszahlung des Anbieters erfolgen. Bei BitPay lassen sich Auszahlungswährung und Bankkonto oder Kryptowährungsadresse konfigurieren; eine Änderung kann genehmigungspflichtig sein. Prüfen Sie verfügbare Währungen, Grenzen, Fristen, Gebühren und die Kontrolle der Mittel bis zur Auszahlung. Ein direkter Eingang in die eigene Wallet verwendet dieses Anbieterauszahlungsmodell nicht automatisch. [BitPay — Configuring settlements] [BTCPay Server — General FAQ]

Eine Erstattung erfordert eine weitere Auszahlung und die Prüfung des Empfängers; sie verändert die ursprüngliche Bitcoin-Transaktion nicht. Trennen Sie die Bestellreklamation, die Entscheidung über den Erstattungsbetrag und den tatsächlichen Geldversand. Bewahren Sie die Verknüpfungen Bestellung–Rechnung–Zahlung, Wechselkurse, Gebühren und Erstattungen auf. Ein Berichtexport unterstützt die Dokumentation, erfüllt aber allein weder sämtliche örtlichen Buchhaltungspflichten noch klärt er einen Lieferstreit. Auch eine bestätigte Überweisung klärt für sich genommen nicht die rechtliche Endgültigkeit des Geschäfts: Prüfen Sie Reklamationen, mögliche Chargeback-Verfahren und Pflichten nach Zahlungsweg, Vertrag und Rechtsordnung. [BTCPay Server — Refunds] [BTCPay Server — Reporting] [BitPay — Merchant and shopper terms]

Testen Sie erfolgreiche, unvollständige, verspätete und mehrfach gemeldete Zahlungen sowie die Wiederherstellung nach einem Ausfall. Geben Sie dem API-Schlüssel nur nötige Berechtigungen und beschränken Sie ihn auf den betreffenden Shop. Übertragen Sie keine unnötigen Kundendaten in Metadaten. Planen Sie Hosting, Updates, Liquidität und Support ein; kostenlose Software bedeutet keine Betriebskosten von null. Dienstverfügbarkeit, Schlüsselverwahrung und korrekte Integration sind getrennte Voraussetzungen. [BTCPay Server — eCommerce integration] [BTCPay Server — Lightning operations]

Beispiel · PAY·PROC

Dieselbe Benachrichtigung ist kein weiterer Kauf

In einer beispielhaften Integration ist für die Bestellung OBJ-101 die Rechnungskennung gespeichert. Nach Prüfung der Abwicklung erzeugt das System einmal einen Versandauftrag. Trifft später eine wiederholte Benachrichtigung desselben Ereignisses ein, ordnet es sie der bereits erfüllten Bestellung zu und erstellt keinen weiteren Versandauftrag. Das bloße Anzeigen einer Dankeseite darf diesen Übergang nicht auslösen.

Für ein möglichst vollständiges Bild lies diesen Eintrag zusammen mit BTCPay Server, Bitcoin Point of Sale, Merchant Adoption, Lightning Network, Bitcoin. Auf diesen Eintrag verweisen außerdem Bitcoin-Zahlungen bei Alza, Merchant Adoption, BTCPay Server, Bitcoin Point of Sale.

01Hält jeder Zahlungsabwickler meine Bitcoins?

Nein. Manche Lösungen erstellen nur Anforderungen und überwachen den Eingang in Ihre Wallet, andere verwalten Mittel bis zur Auszahlung. Selbst dieselbe Software kann unterschiedliche Wallet-Modelle nutzen. Entscheidend sind Schlüssel, Berechtigungen und der tatsächliche Geldfluss, nicht allein die Bezeichnung Zahlungsabwickler.

02Darf der Shop nach der Rückkehr des Kunden von der Zahlungsseite versenden?

Die Rückkehr allein reicht nicht. Der Shop muss die passende Rechnung und ihren Status nach dem Verfahren des jeweiligen Abwicklers prüfen. Benachrichtigungen werden gemäß Dokumentation geprüft, und ihre erneute Zustellung darf keine weitere Erfüllung auslösen. Die Warenausgabe richtet sich nach den gewählten Bedingungen für die Zahlungsbestätigung.

DOC · 001BTCPay Server — eCommerce integrationDokumentation ↗DOC · 002BTCPay Server — General FAQDokumentation ↗DOC · 003BTCPay Server — Invoice lifecycleDokumentation ↗DOC · 004BTCPay Server — Webhook validation exampleDokumentation ↗DOC · 005BitPay — Invoice webhooksDokumentation ↗DOC · 006BitPay — Configuring settlementsDokumentation ↗DOC · 007BTCPay Server — RefundsDokumentation ↗DOC · 008BTCPay Server — ReportingDokumentation ↗DOC · 009BTCPay Server — Lightning operationsDokumentation ↗DOC · 010BitPay — Merchant and shopper termsPrimärquelle ↗
Quellenbasiert · Keine Anlageberatung