← Blog
10 Min. Lesezeit
|
Veröffentlicht
|
Aktualisiert

Wiederkehrende Krypto-Zahlungen: Aufbau und Betrieb

Wiederkehrende Krypto-Zahlungen im Vergleich: Escrow, Pull-Zahlungen und Abrechnung über statische Adressen, dazu Allowances, Webhooks, Abgleich und 1099-DA.

Kapitel
C
Chaingateway Team
Blockchain-Experten

Geprüft von Maurice Sobiera

Isometrische Illustration einer Architektur für wiederkehrende Zahlungen

Wiederkehrende Krypto-Zahlungen sind Abonnement-Abrechnungen, bei denen ein Kunde einem Händler regelmäßig in Kryptowährung zahlt. Blockchains haben kein eingebautes Abo-Feature. Man baut es aus einer Zahlung an eine statische Adresse, einem vorfinanzierten Escrow-Contract oder einer signierten Pull-Zahlung. Stablecoins sind dafür der übliche Vermögenswert, denn Rechnungen brauchen einen stabilen Wert.

Welches Muster sollten Sie bauen?

Der Leitfaden von Stripe zu wiederkehrenden Krypto-Zahlungen beschreibt die wichtigsten Muster. Viele Blockchains unterstützen keine nativen Timer. Wiederkehrende Zahlungen stützen sich deshalb auf Off-Chain-Auslöser und Automatisierungsschichten. Der Leitfaden nennt Chainlink Automation und Gelato, um die Ausführung eines Contracts anzustoßen, sowie Superfluid und Sablier für kontinuierliche Zahlungsströme.

MusterWer löst die Zahlung ausWo das Geld liegtWas Sie brauchen
Abrechnung über statische AdresseDer Kunde, in jeder PeriodeBeim Kunden, bis er zahltAdresse je Kunde, Webhook, Abgleich
Vorausbezahltes EscrowEin Scheduler oder der ContractIn einem Smart ContractContract, Off-Chain-Auslöser, Audit
Signierte Pull-ZahlungenDer Händler, in jedem ZyklusBeim Kunden, bis zum PullContract, der Signaturen prüft, Scheduler
StreamingDer Contract, laufendIn einem Streaming-ContractContract, Bündelung der Abrechnung

Die Abrechnung über eine statische Adresse braucht keinen Contract und ist am einfachsten zu betreiben. Chaingateway rechnet die eigenen Abos so ab: Jeder Kunde hat eine statische Zahlungsadresse, der Betrag ist flexibel, und das Abo-Enddatum verschiebt sich mit dem eingegangenen Betrag. Die Version New Payment Flow beschreibt das. Der Nachteil: Der Kunde muss in jeder Periode handeln. Die Verlängerung hängt also an einer Erinnerung und nicht an einer Automatisierung.

Escrow und Pull-Zahlungen nehmen diesen manuellen Schritt weg. Dafür bringen sie Contract-Risiken, die Verfügbarkeit des Schedulers und bei Pulls die Frage mit, wie der Kunde die Erlaubnis widerruft.

Wie funktioniert die Abrechnung über statische Adressen mit Webhooks?

Sie legen für jeden Kunden eine Adresse an, registrieren dafür einen Webhook und schreiben das Abo gut, sobald eine passende Zahlung eingeht. Der folgende Webhook überwacht eine Tron-Adresse auf USDT. Das Feld reference trägt Ihre Abo-ID, damit sich die Benachrichtigung dem Konto zuordnen lässt:

Terminal window
curl -X POST https://app.chaingateway.io/api/v2/tron/webhooks \
-H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to": "TWrTTVizHkF3LxTiWE9vCnhWC7CBpNXe22",
"contractaddress": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"type": "TRC20",
"url": "https://billing.example.com/hooks/payment",
"reference": "sub_20417"
}'

Eine Benachrichtigung enthält txid, from, to, contractaddress, amount, blocknumber und webhook_id. Ihr Handler sollte fünf Dinge tun:

  1. Prüfen Sie den Header X-Signature. Er signiert die txid, sobald Sie ein persönliches Secret gesetzt haben.
  2. Suchen Sie das Abo über webhook_id oder die Adresse.
  3. Weisen Sie eine txid zurück, die Sie schon gesehen haben.
  4. Vergleichen Sie amount und Token mit der Rechnung. Entscheiden Sie, was mit Unter- und Überzahlungen sowie falschen Token passiert.
  5. Verlängern Sie den Abo-Zeitraum und antworten Sie mit einem 2xx-Status.

Prüfen Sie die Einheit von amount mit einer Testnet-Zahlung, bevor Sie die Preislogik schreiben. Webhooks werden nicht automatisch wiederholt. Eine fehlgeschlagene Benachrichtigung erscheint unter GET /api/v2/tron/webhooks/notifications/failed. Sie senden sie mit dem Retry-Endpunkt erneut. Ein nächtlicher Job, der erwartete und eingegangene Zahlungen vergleicht, fängt den Rest auf. Der Webhook-Leitfaden behandelt Idempotenz und Tests genauer.

Welchen Token und welches Netzwerk sollten Sie wählen?

Nutzen Sie einen großen Stablecoin. Wählen Sie das Netzwerk nach Gebühren und danach, wo Ihre Kunden schon Guthaben halten. Eine monatliche Rechnung über 29 Dollar sollte bei der Abrechnung noch etwa 29 Dollar wert sein. Falls Sie jemals einen volatilen Vermögenswert annehmen, rechnen Sie ihn bei Eingang um und erfassen die Umrechnung getrennt von der Rechnung.

Layer-2-Netzwerke sollen Ethereum skalieren. ethereum.org nennt niedrige Gebühren als einen ihrer Vorteile. Laut der Tron-Dokumentation betreibt Tron das größte Netzwerk für TRC-20-USDT. Chaingateway unterstützt für solche Zwecke unter anderem Ethereum, Arbitrum, Polygon, BNB Smart Chain und Tron. Jedes Netzwerk hat ein eigenes Gebührenmodell. Testen Sie deshalb zuerst eine volle Zahlung und eine Rückerstattung im Testnet des Netzwerks, mit dem Header X-Network: testnet.

Was ändern Allowance-Standards bei Pull-Zahlungen?

Sie begrenzen, wie lange und wie viel ein Händler-Contract abbuchen darf. Eine einfache ERC-20-Freigabe kann unbegrenzt und dauerhaft sein. Dann kann ein kompromittierter Händler-Contract das ganze Guthaben des Kunden leeren. Drei Standards adressieren Teile dieses Problems. Ihr Status unterscheidet sich, prüfen Sie ihn deshalb, bevor Sie sich auf einen verlassen:

StandardWas er ergänztStatus im EIP-Repository (5. November 2026)
ERC-2612Permit: Freigaben per signierter Nachricht, ohne eigene Freigabe-TransaktionFinal
ERC-5827Erweiterung für automatisch erneuerbare FreigabenStagniert
ERC-8255Ablaufende Token-Freigaben: Freigaben laufen standardmäßig nach einer begrenzten Dauer ausEntwurf

Nur ein Token, der einen Standard umsetzt, unterstützt ihn. Prüfen Sie jeden Token, den Sie annehmen, und bauen Sie den Contract so, dass er auch mit einer einfachen Freigabe über einen begrenzten Betrag funktioniert. Bitten Sie den Kunden um einen Betrag, der einige Zyklen abdeckt, statt um eine unbegrenzte Freigabe.

Wie halten Sie die wiederkehrende Abrechnung sicher?

Behandeln Sie Widerruf, Schlüssel und Webhooks als drei Risiken. Beim Widerruf gilt: Widerruft ein Kunde eine Freigabe, muss Ihr System davon erfahren, bevor der nächste Pull scheitert. Beobachten Sie deshalb Freigabe-Events für Ihre Spender-Adresse. Bei den Schlüsseln nutzen Sie für Treasury-Mittel eine Multisig-Wallet und halten Scheduler-Schlüssel getrennt von Schlüsseln, die das Treasury erreichen können. Bei den Webhooks prüfen Sie jede Signatur und entfernen Duplikate, wie im Abschnitt oben.

Kunden können auch Ziel von Identitätsfälschung werden. Veröffentlichen Sie Ihre Zahlungsadressen deshalb auf einer einzigen statischen Seite. Sagen Sie Kunden, dass sie niemals Geld an eine Adresse aus einer E-Mail oder Chat-Nachricht senden sollen. Legitime Abrechnungsabläufe zeigen die Adresse innerhalb Ihrer eigenen Anwendung.

Welche steuerlichen Meldepflichten sollten Sie kennen?

Die US-Steuerbehörde IRS verpflichtet Broker, Verkäufe digitaler Vermögenswerte auf dem Formular 1099-DA zu melden. Dazu können einige Zahlungsabwickler gehören. Die IRS-Seite zu digitalen Vermögenswerten besagt, dass die Meldepflicht für Transaktionen ab dem 1. Januar 2025 gilt und die Vorschriften nach und nach greifen.

Sie nennt Abwickler von Zahlungen in digitalen Vermögenswerten (PDAPs) unter den erfassten Brokern. Sie gilt für Broker, die die verkauften Vermögenswerte in Besitz nehmen. Ob Ihr Dienst als Broker gilt, hängt von der Verwahrung und vom Geldfluss ab. Fragen Sie dazu einen Steuerberater. Dieser Artikel ist weder Steuer- noch Rechtsberatung.

Für die Buchhaltung erfassen Sie je Zahlung drei Beträge: den Rechnungsbetrag in der Abrechnungswährung, den eingegangenen Krypto-Betrag und den Wert in Ihrer Berichtswährung zum Zeitpunkt des Eingangs. Speichern Sie die Transaktions-ID zu jedem Datensatz.

Wie sieht ein sinnvolles Pilotprojekt aus?

Starten Sie mit einem Netzwerk, einem Stablecoin und einer Kundengruppe. Bauen Sie zuerst die Abrechnung über statische Adressen, denn sie hat die wenigsten beweglichen Teile. Messen Sie ab der ersten Zahlung zwei Zahlen: den Anteil der Rechnungen, die pünktlich bezahlt werden, und die Minuten manuellen Abgleichs pro Zyklus. Fügen Sie Escrow oder Pull-Zahlungen erst hinzu, wenn der manuelle Verlängerungsschritt Sie Kunden kostet.

Die Adressen, Webhooks und Auszahlungen für dieses Pilotprojekt legen Sie über die Blockchain API und Chaingateway Webhooks an. Die OpenAPI-Datei hat keinen Endpunkt für Freigaben, Terminierung oder beliebige Contract-Aufrufe. Pull-Zahlungen und Escrow brauchen deshalb Ihren eigenen Contract und Scheduler. Die Tarife beginnen bei 49 Euro im Monat, und die 7-Tage-Testphase braucht weder Karte noch KYC. Details finden Sie auf der Preisseite.

Quellen

Empfohlen

Häufig gestellte Fragen

Das IRS überwacht Wallets nicht direkt. Es erhält Meldungen von Brokern, die ab 2025 das Formular 1099-DA für Transaktionen mit digitalen Vermögenswerten einreichen. Wenn Ihr Unternehmen oder eine Plattform, die Sie nutzen, als Broker gilt, erscheinen Ihre Transaktionen in diesen Meldungen.

Kunden müssen entweder in jeder Periode handeln oder eine Erlaubnis erteilen, die ein Contract nutzen kann. Die Gasgebühren schwanken je nach Netzwerk. Andere Token als Stablecoins tragen ein Preisrisiko. Steuer- und Compliance-Arbeit kostet zusätzlich Aufwand, besonders für Abwickler.

Ein legitimer Ablauf für wiederkehrende Abrechnung verlangt nie, dass Sie manuell Geld an eine Adresse aus einer E-Mail oder Chat-Nachricht senden. Vergleichen Sie jede Adresse mit der Adresse auf der eigenen Seite des Händlers, bevor Sie etwas zahlen oder freigeben.

Das hängt vom Kunden ab. Die Abrechnung über statische Adressen mit Webhooks ist am einfachsten zu betreiben und braucht keinen Contract. Pull-Zahlungen eignen sich für Kunden, die Automatisierung wollen. Sie brauchen dafür einen geprüften Contract und einen Scheduler.

So entstehen diese Artikel

Möchten Sie das selbst umsetzen? API-Key erhalten — 7 Tage kostenlos testen, keine Karte nötig — oder werfen Sie einen Blick auf Blockchain-API für die vollständige Endpoint-Referenz.

C
Chaingateway Team
Blockchain-Experten

Das Chaingateway-Team hat es sich zur Aufgabe gemacht, die Blockchain-Integration für Entwickler weltweit zu vereinfachen.