So akzeptieren Sie USDT-TRC20-Zahlungen

Was USDT TRC20 eigentlich ist

USDT ist ein von Tether ausgegebener Stablecoin, der den US-Dollar abbilden soll. Er existiert auf mehreren Blockchains, und das Netzwerk bestimmt, wie sich eine Überweisung verhält. TRC20 ist der Token-Standard auf TRON. Eine USDT-TRC20-Adresse beginnt mit dem Buchstaben T, und eine Überweisung ist eine TRON-Transaktion.

Warum er bei Kunden so verbreitet ist:

• Überweisungen sind im Vergleich zu vielen anderen Netzwerken günstig, was bei kleinen und mittleren Bestellungen zählt;
• die meisten Börsen und Wallets unterstützen Auszahlungen in diesem Netzwerk, daher ist es für viele Käufer die Voreinstellung;
• der Betrag lautet auf Dollar, sodass weder Sie noch der Kunde zwischen Bestellung und Zahlung Preisschwankungen tragen.

Für Sie als Händler heißt das praktisch: Ein großer Teil der Kunden, die „Ich zahle in USDT“ sagen, meint USDT auf TRON. Wenn Sie es nicht anbieten, wird es für Kunden schwieriger, Sie zu bezahlen.

Das Netzwerk gehört zur Zahlung

Derselbe Coin in einem anderen Netzwerk ist eine andere Zahlung. USDT auf TRON, auf Ethereum (ERC20) und auf BNB Smart Chain (BEP20) nutzen unterschiedliche Adressen und Wege, und im falschen Netzwerk gesendete Mittel kommen nicht dort an, wo der Absender es erwartet. Das ist der teuerste Fehler bei Stablecoin-Zahlungen, und ihn machen Kunden, nicht Händler.

Was hilft:

• lassen Sie die Zahlungsseite, nicht den Text Ihrer Kasse, das Netzwerk bestimmen: Der Kunde wählt dort Asset und Netzwerk und erhält die passende Adresse;
• sagen Sie an der Kasse klar, welche Netzwerke Sie akzeptieren (siehe unterstützte Coins);
• wenn Sie alle auf TRON lenken wollen, übergeben Sie beim Erstellen der Zahlung die Zahlungsmethode USDT TRC20, damit die Seite bereits mit dieser Auswahl geöffnet wird.

Qvard unterstützt unter anderem die Netzwerke TRON (TRC20), Ethereum (ERC20) und BNB Smart Chain (BEP20). Mehrere Netzwerke anzubieten ist nicht schlecht, aber jede zusätzliche Wahl ist eine weitere Chance, dass ein Kunde aus Gewohnheit ein anderes Netzwerk als das beabsichtigte wählt; die Zahlungsseite zeigt Netzwerk und Adresse zusammen, damit das sichtbar bleibt.

Wie eine USDT-Zahlung abläuft

Der Weg von der Bestellung zur Zahlung:

1. Der Kunde wählt Krypto-Zahlung und Ihr Server erstellt eine Zahlung für die Bestellung.
2. Das Gateway liefert eine gehostete Zahlungsseite. Ihr Kunde wählt USDT und das Netzwerk TRC20 und sieht Adresse und genauen Betrag.
3. Er sendet den Betrag aus seiner Wallet oder von seiner Börse. Der Kurs auf der Seite ist eine Stunde lang festgesetzt, der Betrag ändert sich also nicht, während er zahlt.
4. Das Gateway überwacht das TRON-Netzwerk. Sobald der volle Betrag angekommen und die Zahlung endgültig ist, ruft es Ihren Webhook auf.
5. Ihr System markiert die Bestellung als bezahlt.

Sie erzeugen nie TRON-Adressen und betreiben keinen Node. Die Zahlung zu erstellen ist eine einzige Anfrage: ein POST an https://api.qvard.com/api/v1/payment mit dem Header x-api-key und einem Body mit der id Ihrer Bestellung und dem price in US-Dollar. Die Schritt-für-Schritt-Version mit Code finden Sie unter Krypto-Zahlungen auf einer Website akzeptieren.

Gebühren: wer zahlt was

Drei verschiedene Kosten werden oft vermischt, und es hilft, sie zu trennen.

• Die Netzwerkgebühr der Überweisung. Wer USDT auf TRON sendet, bezahlt die Transaktion mit den eigenen Ressourcen des Netzwerks (TRX oder Energie). Das sind Kosten des Kunden, wenn er Sie bezahlt. Ihr Preis muss sie nicht enthalten, auch wenn bei einem Kunden, der von einer Börse zahlt, eine Auszahlungsgebühr vom gesendeten Betrag abgezogen werden kann.
• Die Gateway-Provision. Laut Preisseite ist sie individuell für Ihr Projekt, beginnt bei 1 % und kann nach Vereinbarung bis auf 0,1 % sinken. Es gibt keine Abo-Gebühr.
• Die Netzwerkgebühr bei Ihrer Auszahlung. Das Abheben Ihres Guthabens auf Ihre eigene Wallet kostet nur die Netzwerkgebühr.

Der Punkt, der an der Kasse zählt, ist der erste: Sendet ein Kunde weniger, weil eine Börse eine Gebühr vom Betrag abgezogen hat, ist die Zahlung zu niedrig, nicht vollständig.

Unterzahlungen und andere Sonderfälle

Eine Zahlung endet mit einem von vier Status: wait (erstellt), partial (weniger als erforderlich angekommen), completed (voller Betrag angekommen) und rejected. Nur completed löst den Webhook aus.

Bei USDT TRC20 sind die realistischen Probleme:

• Unterzahlung von einer Börse. Die Auszahlungsgebühr wurde vom Betrag abgezogen. Der Status ist partial. Entscheiden Sie vorab, ob Sie die Differenz verlangen oder dem Kunden erstatten, und teilen Sie dies dem Kunden auf der Bestellseite mit.
• Zahlung nach dem Kursfenster. Der Kurs ist eine Stunde lang festgesetzt. Zahlt der Kunde viel später, behandeln Sie das als Supportarbeit, statt dafür Automatisierung zu bauen.
• Falsches Netzwerk. Der Kunde hat in einem anderen Netzwerk gezahlt als die Seite anzeigte. Das braucht manuelle Prüfung und lässt sich nicht per Code beheben; halten Sie im Zahlungsablauf einen klaren Support-Kontakt bereit.

Machen Sie den Bestell-Handler idempotent, denn der Webhook wird wiederholt, bis Ihr Endpunkt genau mit HTTP 200 antwortet, und vergleichen Sie den x-api-key-Header mit Ihrem Schlüssel. Mehr dazu unter Krypto-Zahlungs-Webhooks absichern.

Was Sie zuerst einrichten

Eine kurze Reihenfolge der Arbeitsschritte, die zu einer funktionierenden USDT-TRC20-Kasse führt:

1. Legen Sie ein Konto und ein Projekt an und holen Sie sich Ihren API-Schlüssel.
2. Sehen Sie sich eine Demo-Rechnung an, um zu sehen, was Ihr Kunde sehen wird.
3. Fügen Sie Ihrer Kasse den Aufruf zum Erstellen der Zahlung hinzu, mit Ihrer Bestellnummer als id.
4. Fügen Sie den Webhook-Endpunkt hinzu, speichern Sie seine Adresse als Callback-URL und markieren Sie Bestellungen nur bei completed als bezahlt.
5. Zahlen Sie einen kleinen echten Betrag in USDT auf TRON und prüfen Sie den ganzen Weg, einschließlich einer Auszahlung auf Ihre Wallet.

Eine separate Sandbox steht auf der Roadmap, verwenden Sie also vorerst kleine echte Beträge. Die Entwicklerdokumentation enthält die genauen Anfrage- und Antwortformate.

Wohin Sie auszahlen können

Mittel aus Zahlungen liegen auf Ihrem Qvard-Guthaben, und Sie heben sie auf Ihre eigene Krypto-Wallet ab; es fällt nur die Netzwerkgebühr an. Eine Auszahlung in Fiatwährung auf ein Bankkonto ist nicht verfügbar; planen Sie also einen Auszahlungsweg über Krypto, etwa zu einer Börse, die Sie bereits nutzen, falls Sie in Bargeld umwandeln müssen.

FAQ