Gateway-Grundlagen

Was ist ein Krypto-Zahlungsgateway?

Ein Krypto-Zahlungsgateway nimmt Krypto an, verfolgt jede Zahlung und hält das Guthaben bis zur Auszahlung. Ablauf Schritt für Schritt und Auswahlkriterien.

Ein Krypto-Zahlungsgateway ist der Dienst zwischen der Wallet Ihres Kunden und Ihrem Bestellsystem: Er erstellt die Zahlungsanforderung, beobachtet die Blockchain, meldet Ihrem Shop, dass das Geld eingegangen ist, und hält das Guthaben bis zur Auszahlung. Dieser Leitfaden erklärt, wie das in der Praxis funktioniert und worauf Sie vor der Auswahl achten sollten.

Was ein Krypto-Zahlungsgateway leistet

Krypto ohne Gateway anzunehmen bedeutet, jedem Kunden eine Wallet-Adresse zu geben, die Blockchain selbst zu beobachten, eingehende Überweisungen Bestellungen zuzuordnen und jeden Sonderfall von Hand zu lösen. Ein Gateway übernimmt vier Aufgaben:

  • Es erstellt die Zahlung. Ihr System fordert eine Zahlung über einen Betrag an; das Gateway liefert eine Zahlungsseite oder eine Adresse nur für diese Bestellung.
  • Es beobachtet das Netzwerk. Es sieht die Überweisung eingehen, zählt Bestätigungen und entscheidet, wann die Zahlung endgültig ist.
  • Es meldet zurück. Es teilt Ihrem Shop, meist per Webhook, mit, dass Bestellung 1024 bezahlt ist, damit Sie liefern oder Zugang freischalten können.
  • Es verwahrt und bewegt das Guthaben. Eingegangenes Geld landet auf einem Händlerguthaben, und Sie zahlen es auf Ihre eigene Wallet aus.

Ein Gateway ist weder eine Wallet, deren Schlüssel Sie halten, noch eine Börse. Es ist Zahlungsinfrastruktur: der Teil einer Kartenzahlung, den Bank und Zahlungsdienstleister meist vor Ihnen verbergen, neu gebaut für Blockchains.

Wie eine Zahlung das Gateway durchläuft

Jedes Gateway arbeitet ein wenig anders, aber der Weg einer Zahlung sieht so aus:

  1. Ihr Server erstellt eine Zahlung mit Bestellnummer und Betrag, meist in Dollar.
  2. Der Kunde öffnet die Zahlungsseite und wählt ein Asset und ein Netzwerk, zum Beispiel USDT auf TRON. Der Händler kann die Methode auch vorauswählen.
  3. Das Gateway fixiert den Wechselkurs für begrenzte Zeit, damit sich der zu sendende Betrag nicht ändert, während der Kunde zahlt. Bei Qvard wird der Kurs für eine Stunde fixiert.
  4. Der Kunde sendet den exakten Betrag von seiner eigenen Wallet an die für diese Zahlung angezeigte Adresse.
  5. Das Gateway beobachtet das Netzwerk, wartet auf Bestätigungen und markiert die Zahlung als bezahlt.
  6. Es benachrichtigt Ihren Server. Ihr Code markiert die Bestellung als bezahlt und gibt die Ware frei.
  7. Das Geld erscheint auf Ihrem Händlerguthaben. Sie zahlen es manuell oder nach einer von Ihnen festgelegten Regel auf Ihre Wallet aus.

Echte Zahlungen laufen nicht immer glatt: Kunden senden zu wenig, zu viel oder nach Ablauf des Kurses. Ein gutes Gateway hat für jeden Fall einen definierten Status, statt Ihnen den Abgleich von Hand zu überlassen. Bei Qvard lauten die Zahlungsstatus wait, partial, completed und rejected.

Gateway, Wallet, Börse und Zahlungsdienstleister: der Unterschied

Diese Begriffe werden oft verwechselt:

  • Wallet. Speichert Schlüssel und erlaubt Senden und Empfangen. Sie ordnet Zahlungen nicht Bestellungen zu und benachrichtigt Ihren Shop nicht.
  • Börse. Tauscht ein Asset gegen ein anderes. Manche Börsen bieten Werkzeuge für Händler an, ihre Hauptaufgabe ist aber der Handel.
  • Zahlungsgateway. Erstellt und verfolgt Zahlungen für Ihre Bestellungen und meldet deren Status. Darum geht es in diesem Leitfaden.
  • Zahlungsdienstleister oder Acquirer. Bei Kartenzahlungen das Unternehmen, das Geld zwischen Banken bewegt. Bei Krypto wird das Wort „Acquiring“ ungenau für den ganzen Dienst verwendet; wie sich beides unterscheidet, steht in Krypto-Acquiring vs. Krypto-Zahlungsgateway.

Custodial oder non-custodial

Die wichtigste Entwurfsentscheidung hinter jedem Gateway ist, wer das Geld zwischen Zahlung und Ihrer Auszahlung hält.

Bei einem Custodial-Gateway gehen eingehende Zahlungen an Adressen, die der Anbieter kontrolliert, und werden Ihrem Händlerguthaben gutgeschrieben. Danach zahlen Sie sie aus. Das vereinfacht den Abgleich und ermöglicht Funktionen wie automatische Auszahlungen, aber Sie hängen bis zur Auszahlung vom Anbieter ab; seine Auszahlungsbedingungen sind daher wichtig.

Bei einem Non-custodial-Modell gehen Zahlungen direkt an Ihre Wallet. Sie behalten die Schlüssel, und der Anbieter verfolgt nur die Zahlung. Das senkt das Kontrahentenrisiko und verlagert die Schlüsselverwaltung auf Sie.

Qvard ist custodial: Zahlungen werden einem Händlerguthaben gutgeschrieben, und Sie zahlen automatisch nach einer Regel oder manuell auf Ihre Wallet aus. Die Auszahlung auf eine Wallet kostet nur die Netzwerkgebühr, eine Auszahlung auf ein Bankkonto gibt es nicht.

Stablecoins und Netzwerke: warum das Netzwerk zählt

Dasselbe Asset kann auf mehreren Blockchains existieren. USDT zum Beispiel gibt es auf TRON (TRC-20), Ethereum (ERC-20) und BNB Smart Chain (BEP-20). Eine Überweisung gilt nur in dem Netzwerk, das die Zahlungsseite verlangt hat, und Gebühren und Geschwindigkeit unterscheiden sich zwischen den Netzwerken.

Deshalb zeigt das Gateway Asset und Netzwerk gemeinsam an, und die Wahl des Kunden muss ausdrücklich sein. Für Händler ergibt sich daraus praktisch Folgendes:

  • entscheiden Sie, welche Netzwerke Sie akzeptieren wollen, und prüfen Sie, ob das Gateway sie unterstützt;
  • rechnen Sie damit, dass die Netzwerkgebühren von der Blockchain und ihrer Auslastung abhängen, nicht vom Gateway;
  • bevorzugen Sie Stablecoins für Preise in Dollar, weil eine Zahlung in einem volatilen Asset bei der Auszahlung deutlich weniger wert sein kann.

Qvard akzeptiert derzeit USDT und USDC in den wichtigsten Netzwerken sowie die nativen Coins BTC und LTC; TON ist in Vorbereitung. Die vollständige Liste finden Sie auf der Seite unterstützte Coins und Netzwerke.

Worauf Sie vor der Wahl eines Gateways achten sollten

Eine kurze Liste, die ein brauchbares von einem riskanten Gateway trennt:

  • Netzwerke und Assets. Unterstützt es die, die Ihre Kunden tatsächlich nutzen?
  • Gebühren. Was berechnet das Gateway, und wie hoch ist die separate Netzwerkgebühr? Wer trägt was?
  • Guthaben und Auszahlung. Wer hält das Geld, wie funktionieren Auszahlungen, und gibt es Limits oder Fiat-Optionen, die Sie brauchen könnten?
  • API-Qualität. Lässt sich eine Zahlung mit derselben Bestellnummer gefahrlos mehrfach erstellen? Sind Fehler verständlich? Wird der Webhook wiederholt, wenn Ihr Server nicht erreichbar war?
  • Ungewöhnliche Zahlungen. Wie werden Unterzahlung, Überzahlung und abgelaufene Zahlungen behandelt?
  • Tests. Lässt sich der Ablauf ohne echtes Geld ausprobieren?
  • Support und Dokumentation. Wer antwortet, wenn eine Zahlung hängt?

So wählen Sie einen Krypto-Zahlungsanbieter geht diese Liste ausführlicher durch.

So sieht eine minimale Integration aus

Eine Zahlung zu erstellen ist eine einzige Anfrage. Bei Qvard senden Sie Ihre eigene Bestellnummer und den Betrag in US-Dollar und erhalten eine Zahlungs-ID und einen Link zur gehosteten Zahlungsseite. Leiten Sie den Kunden dorthin weiter; alles rund um die Wahl des Assets und das Senden der Überweisung geschieht auf dieser Seite.

Die id, die Sie senden, ist Ihre Bestellnummer: Wird dieselbe id für dieselbe Zahlungsmethode erneut gesendet, liefert Qvard die bestehende Zahlung zurück, statt ein Duplikat anzulegen, wodurch Wiederholungen sicher sind. Wenn der Kunde zahlt, sendet Qvard einen Webhook an Ihren Server mit derselben id und dem Zahlungsstatus. Den vollständigen Ablauf mit Code für Ihr Backend finden Sie in Kryptozahlungen auf einer Website annehmen; die Referenz steht auf der Seite für Entwickler.

curlPOST /api/v1/payment
curl -X POST https://api.qvard.com/api/v1/payment \
  -H "x-api-key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "id": "order_1024", "price": 149.99 }'

# 201 Created
{ "id": "8f3k2a1c", "redirectUrl": "https://my.qvard.com/pay/8f3k2a1c" }

Häufige Fehler

  • Der Weiterleitung vertrauen. Dass der Kunde auf Ihrer Dankeseite landet, beweist nicht, dass er bezahlt hat. Markieren Sie eine Bestellung nur dann als bezahlt, wenn das Gateway einen Endstatus meldet.
  • Teilzahlungen ignorieren. Hat der Kunde weniger als den Betrag gesendet, ist die Bestellung nicht bezahlt. Entscheiden Sie vorab, ob Sie die Differenz anfordern oder erstatten.
  • Die Webhook-Wiederholung nicht testen. Gibt Ihr Server bei einem Webhook einen Fehler zurück, muss die Benachrichtigung wiederholt werden, und Ihr Handler muss damit umgehen können, dasselbe Ereignis zweimal zu erhalten.
  • In einem volatilen Asset kalkulieren. Nennen Sie Preise in Dollar und lassen Sie den Kunden mit einem Stablecoin zahlen, wenn Sie das Preisrisiko nicht tragen können.
  • Den Auszahlungsweg nicht testen. Zahlen Sie einen kleinen Betrag aus, bevor Sie sich für echte Umsätze auf das Gateway verlassen.

Wo Qvard einzuordnen ist

Qvard ist ein Krypto-Zahlungsgateway für Unternehmen mit Verwahrung der Gelder (custodial). Heute erstellen Sie eine Zahlung über die API, leiten den Kunden auf die gehostete Zahlungsseite, erhalten den Endstatus per Webhook und zahlen von Ihrem Händlerguthaben auf eine Wallet aus. Die übrigen Wege zur Zahlungsannahme, etwa Zahlungslinks, ein eingebettetes Fenster, ein SDK und ein Kassenterminal, sind in Entwicklung. Die echte Zahlungsseite sehen Sie mit einer Demo-Rechnung, noch bevor Sie ein Konto anlegen, und die Seite Preise erklärt, wie die Gebühren funktionieren.

FAQ

Ist ein Krypto-Zahlungsgateway dasselbe wie eine Krypto-Wallet?

Nein. Eine Wallet speichert Schlüssel und sendet Überweisungen. Ein Gateway erstellt eine Zahlung für eine bestimmte Bestellung, verfolgt sie auf der Blockchain, meldet den Status an Ihren Shop und hält das Geld auf einem Händlerguthaben, bis Sie es auszahlen.

Lässt sich eine Kryptozahlung rückgängig machen?

Nein. Eine bestätigte Überweisung auf der Blockchain ist endgültig. Wenn Sie einem Kunden Geld zurückgeben müssen, senden Sie selbst eine neue Überweisung; legen Sie daher Ihre Erstattungsregeln fest, bevor Sie Zahlungen annehmen.

Wie lange dauert es, bis eine Zahlung bestätigt ist?

Das hängt vom Netzwerk und von der Zahl der Bestätigungen ab, auf die das Gateway wartet. Manche Netzwerke bestätigen in Sekunden, während Bitcoin etwa alle zehn Minuten einen Block erzeugt. Die Zahlungsseite zeigt den Status, während der Kunde wartet.

Muss ich auf meiner Seite etwas entwickeln?

Sie müssen die Zahlung aus Ihrem Backend erstellen und den Webhook verarbeiten, der ihren Status meldet. Alles andere, von der Zahlungsseite bis zur Blockchain-Überwachung, übernimmt das Gateway.

Ähnliche Artikel

Ähnliche Artikel