Blockchain-API für E-Commerce-Zahlungen
Wie ein Webshop Krypto über eine Blockchain-API annimmt und auszahlt: eine Adresse pro Bestellung, Webhooks, Bestätigungen, Rückerstattungen, Testnets.
Geprüft von Maurice Sobiera
Eine Blockchain-API für E-Commerce ist eine REST-Schnittstelle, mit der ein Onlineshop Zahlungsadressen erstellen, eingehende Krypto-Zahlungen erkennen und Rückerstattungen oder Auszahlungen senden kann, ohne eigene Blockchain-Nodes zu betreiben. Der Shop spricht die API über HTTPS an und erhält Webhooks, wenn eine Zahlung eintrifft. Schlüssel und Bestätigungsregeln bleiben unter der Kontrolle des Shops.
Wie nimmt ein Webshop Krypto-Zahlungen über eine API an?
Geben Sie jeder Bestellung eine eigene Einzahlungsadresse, überwachen Sie sie per Webhook und markieren Sie die Bestellung als bezahlt, wenn der bestätigte Betrag passt. Der Ablauf hat fünf Schritte:
- Erstellen Sie mit
POST /api/v2/{blockchain}/addresseseine Adresse für die Bestellung. - Registrieren Sie mit
POST /api/v2/{blockchain}/webhookseinen Webhook für diese Adresse und tragen Sie Ihre Bestell-ID in das Feldreferenceein. - Zeigen Sie dem Kunden die Adresse, den Betrag und eine Ablaufzeit an.
- Prüfen Sie, sobald der Webhook eintrifft, den Header
X-Signatureund kontrollieren Sie Betrag und Token auf der Chain. - Geben Sie die Ware nach der Anzahl an Bestätigungen frei, die Sie festgelegt haben.
Eine Adresse pro Bestellung beseitigt Rätselraten: Jede Zahlung an diese Adresse gehört zu dieser Bestellung. Der Leitfaden zu Zahlungs-Webhooks zeigt den Empfänger-Code, und das Laravel-Tutorial zeigt denselben Ablauf in einem PHP-Framework.
Was sollte der Bestelldatensatz enthalten?
Speichern Sie genug Daten, um selbst zu entscheiden, ob eine Zahlung vollständig ist. Der Webhook sagt Ihnen, dass etwas passiert ist. Ihr Bestelldatensatz sagt Ihnen, was hätte passieren sollen.
| Feld | Zweck |
|---|---|
| Bestell-ID | Wird auch als reference des Webhooks gesendet, damit Sie das Ereignis zuordnen können |
| Netzwerk und Token | Die Chain und der Contract, die der Kunde nutzen muss |
| Einzahlungsadresse | Die für diese Bestellung erstellte Adresse |
| Erwarteter Betrag | Beim Ausstellen der Rechnung aus dem Shop-Preis umgerechnet |
| Rechnungsablauf | Zeitpunkt, nach dem der Preis nicht mehr gilt |
| Erforderliche Bestätigungen | Die Regel, die Sie für dieses Netzwerk und diese Bestellgröße gewählt haben |
| Status | Offen, teilweise bezahlt, bezahlt, abgelaufen oder erstattet |
Mit diesen Feldern ist der Webhook-Handler ein kurzer Vergleich. Suchen Sie die Bestellung über reference, prüfen Sie, ob Netzwerk und Token übereinstimmen, addieren Sie den Betrag zum bisher Erhaltenen und aktualisieren Sie den Status. Eine Zahlung mit dem falschen Token an die richtige Adresse ist ein normaler Fall, den der Handler abfangen muss, weil eine Adresse jeden Token ihres Netzwerks empfangen kann.
Auf wie viele Bestätigungen sollte ein Shop warten?
Das hängt vom Netzwerk und vom Wert der Bestellung ab. Die Bitcoin-Entwicklerdokumentation zur Zahlungsabwicklung sagt, dass einer Transaktion ohne Bestätigung ohne Risikoanalyse nicht zu trauen ist und dass Software für hochwertige Transaktionen auf mindestens sechs Bestätigungen warten sollte, was etwa eine Stunde dauert. Auf TRON gilt ein Block als solidified, sobald mindestens 19 der 27 Super Representatives darauf aufgebaut haben, was die TRON-Konsensdokumentation unter normalen Bedingungen mit etwa einer Minute angibt.
Wählen Sie eine Regel pro Netzwerk und pro Bestellgröße, schreiben Sie sie auf und setzen Sie sie im Code um. Ein digitaler Artikel von geringem Wert kann nach einer Bestätigung ausgeliefert werden. Bei einem hochwertigen physischen Artikel sollten Sie länger warten.
Was tun bei Preisschwankungen?
Legen Sie den Preis in Ihrer eigenen Währung fest, rechnen Sie ihn beim Ausstellen der Rechnung um und lassen Sie die Rechnung ablaufen. Die Bitcoin-Dokumentation hält fest, dass Wechselkurse schwanken, dass an Fiat gekoppelte Rechnungen ablaufen müssen und dass die meisten Zahlungssysteme Rechnungen nach 10 bis 20 Minuten verfallen lassen. Ein kürzeres Zeitfenster senkt das Wechselkursrisiko und erhöht die Chance, dass ein Kunde zu spät zahlt.
Entscheiden Sie vorab, was mit einer verspäteten oder teilweisen Zahlung geschieht. Die meisten Shops erstatten sie oder bitten den Kunden, die Differenz an dieselbe Adresse zu zahlen.
Wie funktionieren Rückerstattungen und Auszahlungen?
Senden Sie sie als gewöhnliche Transaktionen von einer Adresse, die Sie kontrollieren. Nutzen Sie POST /api/v2/{blockchain}/transactions für die native Coin und für Token die Token-Endpoints wie transactions/erc20, transactions/bep20 oder transactions/trc20. Eine Rückerstattung braucht die Rücksendeadresse des Kunden, die Sie separat erfragen müssen, weil der Absender einer Zahlung nicht immer die Wallet ist, die das Geld zurückbekommen soll, etwa wenn die Zahlung von einer Börse kam.
Halten Sie die Guthaben einer Bestelladresse kurzlebig. Verschieben Sie eingehende Zahlungen in eine Wallet, die Sie offline halten, und nutzen Sie die Bestelladressen nur zum Einsammeln. Unsere Sicherheitstipps erklären, wie Sie die Schlüssel speichern.
Wie kontrollieren Sie Netzwerkgebühren?
Planen Sie die Gebühren auf der Senderseite ein. Das Verschieben von Token von einer Bestelladresse kostet auf EVM-Netzwerken Gas und auf TRON Energy oder Bandwidth, und die Bestelladresse braucht dafür genug von der nativen Coin. Auf TRON senkt das Sponsern oder Mieten von Energy die Kosten von TRC-20-Transfers. Unsere Dokumentation zu TronFuel und dem deprecated Paymaster erklärt die aktuelle Option. TronFuel ist ein separater Service mit eigener Dokumentation.
Wie testen Sie die Integration vor dem Start?
Nutzen Sie die Testnets. Fügen Sie einer Anfrage den Header X-Network: testnet hinzu, und derselbe Aufruf läuft auf einem Testnetzwerk ohne echtes Guthaben. Testen Sie eine vollständige Bestellung, eine Unterzahlung, eine Überzahlung, eine verspätete Zahlung und einen Webhook, der Ihren Server nicht erreicht. Fehlgeschlagene Webhooks werden nicht automatisch wiederholt. Sie erscheinen in GET /webhooks/notifications/failed und können erneut gesendet werden, Ihr Shop sollte diese Liste deshalb prüfen.
Müssen Sie Ihre Kunden verifizieren?
Das hängt von Ihrer Rechtsordnung und Ihrem Geschäftsmodell ab, und die API entscheidet das nicht für Sie. Chaingateway ist non-custodial. Lesen Sie unseren Artikel zu KYC bei Krypto-Zahlungen, bevor Sie entscheiden, welche Prüfungen für Ihren Shop gelten.
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.