495 / 736PAY·PROC

Bitcoin Payment Processor

Bitcoin-Zahlungsabwickler

Ein Kunde zahlt mit Bitcoin. Der Shop muss trotzdem erkennen, welche Bestellung bezahlt wurde, ob der Betrag stimmt und wann er versenden kann. Ein Bitcoin Payment Processor verbindet diese Schritte. Dahinter kann selbst betriebene Software stehen oder ein Dienst, auf dessen Auszahlung der Händler wartet.

Bitcoin Payment Processor bezeichnet Software oder einen Dienst, der Zahlungsanforderungen erstellt, Zahlungseingänge verfolgt und Bestellungen zuordnet. Er unterstützt Verkauf und Dokumentation. Er bestimmt keine Bitcoin-Netzwerkregeln und hält nicht zwangsläufig Kundengelder: Wer Schlüssel kontrolliert und wer an wen auszahlt, hängt vom Aufbau ab.

Ein Kunde bestellt ein Buch im Onlineshop. Dieser fordert beim Zahlungsabwickler eine Invoice an, also eine Zahlungsanforderung mit Betrag und Währung, und speichert ihre Kennung zur Bestellnummer. Der Kunde öffnet die Zahlungsseite oder scannt einen QR-Code und bezahlt. Über die gespeicherte Zuordnung erkennt der Shop, zu welchem Kauf das Geld gehört. Ohne sie reicht die Feststellung, dass irgendwo Bitcoin eingegangen ist, nicht aus. Auch die Rückkehr zur Seite „Vielen Dank für Ihre Bestellung“ beweist keinen Zahlungseingang. [1]

BTCPay Server kann Empfangsadressen aus öffentlichen Daten einer vorhandenen Wallet erzeugen, ohne die privaten Schlüssel zum Ausgeben zu erhalten. Anders ist es bei einer Hot Wallet mit Schlüsseln auf dem Server oder beim Zugriff auf Gelder eines Lightning-Knotens für schnelle Zahlungen. Ein Dienstleister kann vor der Auszahlung die Mittel kontrollieren. Die Bezeichnung non-custodial, also ohne Überlassung der Schlüssel an den Anbieter, genügt deshalb allein nicht. Prüfen Sie tatsächliche Berechtigungen, wer Geld senden kann und ob Sie für den Zugriff eine fremde Zustimmung benötigen. [2] [6]

Das Buch kann in Landeswährung ausgezeichnet sein, während der Kunde Bitcoin sendet. BTCPay Server legt Betrag und Wechselkurs der Zahlungsanforderung zeitlich begrenzt fest. Ein Ablauf verhindert keinen späteren Zahlungseingang; der Shop muss ihn richtig behandeln. Das gilt ebenso für Unter- und Überzahlungen. Ursprünglicher Betrag und Kurs bleiben für den Abgleich gespeichert. Eine neue Anforderung bei verändertem Kurs kann eine andere Zahl Satoshis, der kleinsten Bitcoin-Einheiten, verlangen, obwohl der Buchpreis unverändert ist. [3]

Processing bedeutet bei BTCPay Server, dass der geforderte Betrag bezahlt wurde, aber Abschlussbedingungen fehlen, etwa Bestätigungen der Transaktion in Blöcken. Bei Settled sind diese Bedingungen erfüllt; Lightning-Zahlungen warten gewöhnlich nicht auf Blockbestätigungen. Andere Dienste definieren eigene Status. BitPay warnt ausdrücklich, dass paid keine Zahlungsgarantie ist. Die Versandregel muss deshalb zur Dokumentation des gewählten Dienstes und zur Zahlungsart passen. Eine manuelle Markierung als bezahlt ersetzt keine Prüfung des tatsächlichen Eingangs. [3] [5]

Statusänderungen meldet der Abwickler per Webhook, einer automatischen Nachricht zwischen Servern. Der Shop muss Herkunft und Inhalt prüfen. Bei BTCPay wird HMAC-SHA256 aus den ursprünglichen Nachrichtenbytes und einem gemeinsamen Geheimnis berechnet. Das ist ein Authentifizierungscode, keine Bitcoin-Netzwerkbestätigung. BitPay signiert seine IPN-Mitteilung nicht: Sie soll nur eine Abfrage des tatsächlichen Status über die API auslösen, die Kommunikationsschnittstelle für Programme. Nachrichten können erneut eintreffen. Der Shop vermerkt die Erfüllung, damit eine Wiederholung keinen weiteren Versand bewirkt. Nach Ausfällen gleicht er gespeicherte Status mit dem Abwickler ab. [4] [5]

Kundenzahlung und Auszahlung eines Dienstleisters sind verschiedene Ereignisse. BitPay erlaubt die Wahl einer unterstützten Auszahlungswährung sowie eines Bankkontos oder einer Kryptowährungsadresse; Änderungen können eine Genehmigung benötigen. Händler prüfen daher auch Termine, Grenzen, Gebühren und die Kontrolle der Mittel vor der Auszahlung. Beim direkten Empfang in der eigenen Wallet kann dieser Zwischenschritt entfallen. Das Verkaufssystem muss diese Modelle unterscheiden, damit „bezahlt“ keine falsche Vorstellung vom bereits verfügbaren Geld vermittelt. [6] [2]

Eine Erstattung löscht die ursprüngliche Bitcoin-Transaktion nicht. Der Shop bearbeitet zunächst die Anfrage, bestimmt Betrag und Währung, prüft den Empfänger und veranlasst eine neue Zahlung. Ein Link zur Anforderung einer Erstattung bedeutet noch nicht, dass Geld versendet wurde. Bestellung, Zahlungsanforderung, Eingang, Wechselkurs, Gebühren und Erstattung bleiben dokumentiert. Exportierte Berichte helfen der Buchhaltung, erfüllen allein jedoch nicht sämtliche örtlichen Pflichten. Eine Netzwerkbestätigung entscheidet weder einen Lieferstreit noch hebt sie vertragliche oder gesetzliche Pflichten bei Reklamationen auf. [7] [8] [10]

Ein erfolgreicher Testkauf genügt vor dem Start nicht. Prüfen Sie Unterzahlungen, verspätete Zahlungen, wiederholte Meldungen und den Wiederanlauf nach Ausfällen. Ein API-Schlüssel ist der Zugangsnachweis eines Programms: Er erhält nur notwendige Rechte für den betreffenden Shop. Zusätzliche Angaben sollten keine unnötigen Kundendaten enthalten. Eigenbetrieb erfordert Hosting, Updates und Betreuung; bei Lightning kommt Liquiditätsverwaltung hinzu, also Geld und verfügbarer Spielraum in Zahlungskanälen. Kostenlose Software bedeutet keinen kostenlosen Betrieb. Verfügbarkeit, Schlüsselschutz und korrekte Shopanbindung sind getrennt zu prüfen. [1] [9]

Beispiel · PAY·PROC

Ein bezahltes Buch und eine wiederholte Nachricht

Der Shop verknüpft eine Zahlungsanforderung mit Bestellung OBJ-101. Nach Prüfung der Zahlung und Erfüllung der Versandbedingungen schickt er das Buch und dokumentiert die Erledigung. Später trifft dieselbe Nachricht erneut ein. Das System erkennt die erledigte Bestellung und erzeugt kein weiteres Paket. Das bloße Öffnen der Dankeseite hätte den Versand nicht auslösen dürfen.

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-Zahlung bei Alza, Merchant Adoption, BTCPay Server, Bitcoin Point of Sale.

01Muss ich dem Abwickler Bitcoin anvertrauen?

Nicht immer. Software kann Zahlungen in Ihre Wallet ohne Ausgabeschlüssel überwachen. Eine Hot Wallet auf dem Server, Zugriff auf einen Lightning-Knoten oder ein Dienst mit späterer Auszahlung haben andere Voraussetzungen. Entscheidend sind tatsächliche Geldkontrolle und Rechte, nicht allein das Etikett non-custodial.

02Darf ich versenden, sobald der Kunde zum Shop zurückkehrt?

Nein. Eine Rückkehr im Browser ist nur ein Seitenvorgang. Der Shop braucht einen verifizierten Status der konkreten Zahlung und eine zur Methode passende Versandregel. Auch wiederholte Nachrichten zur selben Zahlung dürfen keine mehrfachen Sendungen auslösen.

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
Überarbeitet: Quellenbasiert · Keine Anlageberatung