Zahlungen über mehrere Blockchains nutzen
Der Zahlungsdienst im Überblick:
- Zwei Zugangswege: Kasse (einrichten und Link senden, ohne Code) sowie Anwendung und API (Ihr System erstellt Bestellungen und empfängt Push-Benachrichtigungen)
- Zwei Verwahrungsmodelle: Geld auf Adressen in Plattformverwahrung ist nach dem Einzug auszahlbar, die Gebühr wird beim Einzug abgezogen; Geld auf Selbstverwahrungsadressen geht direkt an Ihre Adresse, die Gebühr wird pro Zahlung vom Kontoguthaben abgebucht
- Anwendungseinstellungen: App Key zum Signieren von Bestellungen, Push-Geheimnis zur Signaturprüfung, Callback-URL nur mit https, wahlweise Rotation oder 1:1-Empfang
- Eine Push-Benachrichtigung gilt bei einer 2xx-Antwort als zugestellt; Fehlschläge werden automatisch bis zu 10-mal wiederholt und lassen sich im Push-Protokoll erneut senden
- Seiten für Gelder: Adresspool, Vermögenswerte, Einzugseinstellungen, Auszahlen und Geldtransfers, Transaktionen sowie API-Auszahlungen
- Tokengenauigkeit und Empfangsversatz bestimmen die letzten Stellen des Zahlbetrags; mehrere Bestellungen auf einer Adresse werden daran unterschieden, deshalb muss der Betrag exakt stimmen
Was dieser Dienst bietet
Zahlungen über mehrere Blockchains sind der Kerndienst der Plattform: Kunden zahlen in USDT oder anderen Kryptowährungen, und das Geld geht an Empfangsadressen in Ihrem Namen. Es gibt zwei Zugangswege; Sie können einen davon oder beide gleichzeitig nutzen.
- Kasse: Die Plattform erzeugt einen eigenen Zahlungslink und QR-Code. Richten Sie Marke und Parameter ein und senden Sie ihn dem Kunden, ganz ohne Code.
- App und API: Erstellen Sie eine App für ihre Schlüssel. Ihr System erstellt damit Aufträge und empfängt Zahlungs-Webhooks. Geeignet für vorhandene Systeme.
Zuerst das Verwahrungsmodell wählen
Es gibt zwei Arten von Empfangsadressen: Adressen in Plattformverwahrung und Adressen in Selbstverwahrung. Das Verwahrungsmodell hängt an der Adresse, sodass eine Anwendung beide Arten gleichzeitig nutzen kann. Es bestimmt, wo das Geld liegt, wie Gebühren erhoben werden und welche Funktionen verfügbar sind. Entscheiden Sie sich, bevor Sie Zahlungen annehmen.
- Plattformverwahrung — Die Empfangsadresse wird von der Plattform zugewiesen. Eingegangenes Geld landet nach dem Einzug unter „Vermögenswerte“ in „Auszahlbar (eingezogen)“. Danach können Sie es an eine externe Adresse auszahlen, auf Ihr Kontoguthaben übertragen oder über die API auszahlen.
- Selbstverwahrung — Importieren Sie unter „Adresspool → Selbstverwahrungsadressen“ Adressen, deren privaten Schlüssel Sie selbst besitzen. Das Geld geht direkt an Ihre Adresse; die Plattform erkennt nur den Zahlungseingang, sendet Benachrichtigungen und verbucht ihn. Es wird nicht eingezogen, Sie verwalten es selbst.
Geld auf Selbstverwahrungsadressen läuft nicht über die Plattform. Es erscheint nicht unter „Auszahlbar (eingezogen)“ und kann daher weder über die Plattform noch über die API ausgezahlt werden. Prüfen Sie vor der Wahl der Selbstverwahrung, dass Ihr Auszahlungsprozess nicht auf diese beiden Wege angewiesen ist.
So werden Gebühren erhoben
- Plattformverwahrung — Beim Einzug wird ein prozentualer Anteil vom eingezogenen Betrag abgezogen; für jeden Token gilt zusätzlich eine Mindestgebühr. Der Restbetrag geht in „Auszahlbar (eingezogen)“. Der Prozentsatz ist der aktuell für Ihr Konto geltende Gebührensatz: der Standardsatz, ein individueller Satz oder ein Staffelsatz nach dem im laufenden Monat eingezogenen Betrag.
- Selbstverwahrung — Nach jedem Zahlungseingang wird die Tokenmenge dieser Zahlung mit dem Gebührensatz multipliziert, in US-Dollar umgerechnet und von Ihrem Kontoguthaben abgebucht. Für jede Zahlung gilt eine Mindestgebühr.
Gebühren für Selbstverwahrung werden vom Kontoguthaben abgebucht; das Guthaben kann dadurch negativ werden. Liegt es unter 0, nehmen Anwendungen, die über Selbstverwahrungsadressen kassieren, keine neuen Bestellungen mehr an: Neue Bestellungen von Kunden schlagen dann fehl, bereits erzeugte Bestellungen sind nicht betroffen. Auch Push-Benachrichtigungen über Zahlungseingänge im 1:1-Modus werden zurückgestellt. Sobald das Guthaben durch eine Aufladung wieder über 0 liegt, geht der Betrieb automatisch weiter und zurückgestellte Benachrichtigungen werden automatisch nachgesendet.
Die Gebührensätze sehen Sie unter „Vermögenswerte → Einzugseinstellungen“ in den „Plattformgebührenregeln“: den aktuell geltenden Satz, die Staffelsätze nach Monatsumsatz und die Mindestgebühr je Token. Die Zeile „Gebühr“ in den Bestelldetails ist bei Selbstverwahrungsadressen die Grundlage der Abbuchung. Bei Adressen in Plattformverwahrung ist sie nur ein Richtwert; maßgeblich ist der beim Einzug berechnete Betrag.
Zahlungs-App erstellen
- Anwendung erstellen und Zugangsdaten speichern: Wählen Sie unter „Zahlungen über mehrere Blockchains → Anwendungsliste“ die Option „Anwendung erstellen“. Danach werden App ID und App Key angezeigt. Den App Key können Sie später in der Anwendungsliste über „Geheimnis“ erneut ansehen. Eine neue Anwendung hat noch kein Push-Geheimnis: Klicken Sie im selben Dialog auf „Push-Geheimnis zurücksetzen“, um eines zu erzeugen, und hinterlegen Sie es auf Ihrem Server für die Signaturprüfung.
- Callback- und Weiterleitungs-URLs festlegen: Die Callback-URL empfängt die Push-Benachrichtigungen mit dem Zahlungsergebnis und muss eine https-Adresse sein. Die Weiterleitungs-URL ist die Seite, auf die der Kunde nach der Zahlung geleitet wird. Beide haben unterschiedliche Zwecke; tragen Sie nicht dieselbe Adresse ein.
- Zahlungsmodus wählen: Rotation weist jedem neuen Auftrag eine Empfangsadresse aus dem Pool zu. 1-zu-1 bindet je Kunde eine feste Adresse und meldet Eingänge. Beide können zugleich aktiviert werden.
- Blockchains und Token auswählen: Öffnen Sie in den Anwendungsdetails die Registerkarte „Anwendungskonfiguration“. Die Liste zeigt die von der Plattform freigegebenen Blockchains und Token. Wählen Sie diejenigen aus, die diese Anwendung annehmen soll, legen Sie die Fiatwährung für die Preisangabe der Bestellungen fest und klicken Sie auf „Speichern“.
App Key und Push-Geheimnis sind Zugangsdaten. Bevor Sie das vollständige Push-Geheimnis anzeigen, erzeugen oder zurücksetzen, müssen Sie Ihre Identität bestätigen. Ist für die Anwendung die offene API freigegeben, gilt das auch für das Anzeigen oder Zurücksetzen des App Keys. Nach dem Zurücksetzen wird der alte Wert sofort ungültig und eine laufende Integration bricht ab. Planen Sie den Wechselzeitpunkt deshalb vorher.
Zahlungen über die Kasse annehmen
Die Kasse benötigt keinen Code. Nach Konfiguration erhalten Sie einen eigenen Link und QR-Code für Kunden. Die Einstellungen liegen in drei Registerkarten.
- Zahlungsparameter — Verknüpfte Anwendung, Standard-Fiat- und Kryptowährung, Mindestbetrag, Bestellzeitfenster, Weiterleitungs-URL nach erfolgreicher Zahlung und URL für Zahlungsbenachrichtigungen. Das Bestellzeitfenster ist die Dauer des Countdowns auf der Zahlungsseite und kann auf 5 bis 1440 Minuten gesetzt werden. Nach Ablauf des Countdowns bleibt die Bestellung noch 25 Minuten bestehen, damit Zahlungen erfasst werden, die kurz vor Fristende gesendet wurden und noch auf der Blockchain bestätigt werden. Ist eine URL für Zahlungsbenachrichtigungen eingetragen, gehen die Benachrichtigungen dorthin; andernfalls an die Callback-URL der verknüpften Anwendung.
- Markenauftritt — Kassenvorlage (fünf Vorlagen: „Modern und minimalistisch“, „Marke im Mittelpunkt“, „Kompakt“, „Krypto-orientiert“ und „Professionell und vertrauenswürdig“, jederzeit wechselbar), Logo, Markenname, Designfarbe, Slogan und Beschreibung. Sie bestimmen, was Kunden beim Öffnen der Kasse sehen.
- Anzeigeeinstellungen — Für Kunden angezeigte Kontaktdaten (E-Mail, Telefon, Telegram, offizielle Website), ob Kunden Bestellhinweise eingeben dürfen sowie ob Kunden Kontaktdaten angeben müssen und welche Arten zulässig sind.
Ist bei der verknüpften App Rotation aktiviert, sagt die Seite dies direkt. Der Hinweis erklärt die Herkunft der Empfangsadresse und ist kein Fehler.
Aufträge, Kassenaufträge und Webhook-Protokolle
- „Bestellungen“: Hier stehen alle Zahlungsbestellungen. Über die Kasse entstandene Bestellungen sind mit „Kasse“ gekennzeichnet und lassen sich über „Bestellquelle“ filtern. Die Bestelldetails zeigen die On-Chain-Informationen, die Gebühr dieser Bestellung und den Benachrichtigungsstatus.
- „Kassenbestellungen“: Listet nur die über die Kasse entstandenen Bestellungen, filterbar nach ausstehend, bezahlt, abgelaufen und abgebrochen. Den Kassenlink jeder Bestellung können Sie kopieren.
- „Push-Protokolle“: Anfrage, Antwort und Ergebnis jeder einzelnen Push-Benachrichtigung. Beginnen Sie hier mit der Fehlersuche bei der Integration: Sie sehen, ob nichts gesendet wurde oder ob Ihr Server die Nachricht nicht angenommen hat. Erfolgreiche wie fehlgeschlagene Einträge lassen sich mit „Erneut senden“ wiederholen.
Regeln für Push-Benachrichtigungen: Antwortet Ihr Server innerhalb von 10 Sekunden mit einem beliebigen 2xx-Statuscode, gilt die Benachrichtigung als zugestellt; den Inhalt der Antwort wertet die Plattform nicht aus. Zeitüberschreitung, ein anderer Status als 2xx oder eine Weiterleitung gelten als Fehlschlag. Nach einem Fehlschlag wiederholt die Plattform die Zustellung nach 30 Sekunden, 1 Minute, 2 Minuten und 5 Minuten je einmal, danach alle 10 Minuten, insgesamt höchstens 10-mal. Jede Benachrichtigung trägt eine eindeutige notify_id, die bei automatischen Wiederholungen und bei „Erneut senden“ gleich bleibt. Erkennen Sie Duplikate anhand dieser ID.
Gelder, Adresspool und Auszahlungen
Der Speicherort des Geldes hängt vom Verwahrungsmodell ab; diese Seiten behandeln die verschiedenen Phasen.
- Adresspool — Gesamtzahl der Adressen, verfügbare und gebundene Adressen sowie die Vermögenswerte auf jeder Adresse. Sie können Adressen mit Notizen versehen, die nur Sie sehen, und die Bindung einer Adresse aufheben, damit sie in den verfügbaren Pool zurückkehrt. Adressen in Plattformverwahrung lassen sich einzeln mit „Einziehen“ einziehen. Selbstverwahrungsadressen importieren Sie über „Selbstverwahrungsadressen“; die Regeln stehen im Hinweis unten.
- Vermögenswerte — Oben werden Kontoguthaben, „Auszahlbar (eingezogen)“ und „On-Chain, noch nicht eingezogen (geschätzt)“ getrennt angezeigt. Die beiden letzten Werte lassen sich nicht addieren: Noch nicht eingezogenes Geld ist erst nach dem Einzug und nach Abzug der Gebühr auszahlbar. Diese Seite bietet außerdem Zugänge zu Aufladen, Auszahlen, Geldtransfers, Plattformabrechnungen, Einzugsverlauf und Einzugseinstellungen.
- Einzugseinstellungen — Zeigt die „Plattformgebührenregeln“. Unter „Einstellungen für automatischen Einzug“ legen Sie pro Token einen Einzugsschwellenwert fest; ist er erreicht, wird automatisch eingezogen. Der Schwellenwert darf nicht unter dem Mindesteinzugsbetrag der Plattform liegen. Sie können auch „Alle geeigneten Vermögenswerte jetzt einziehen“ wählen. Ein höherer Schwellenwert bedeutet weniger Einzüge, sodass die Mindestgebühr seltener anfällt.
- Auszahlen und Geldtransfers — „Auszahlen“ überweist auszahlbare Vermögenswerte an eine externe Adresse und setzt eine aktivierte Zwei-Faktor-Authentifizierung voraus. Die Seite zeigt für jeden Token die Gebühr, den Mindestauszahlungsbetrag und den Gesamtabzug. Die Gebühr wird zusätzlich abgezogen, der eingegebene Betrag kommt vollständig an. Sie können auch Regeln für automatische Auszahlungen festlegen: Nach einem Einzug wird bei Erreichen des Schwellenwerts automatisch ausgezahlt. „Geldtransfers“ rechnet auszahlbare Vermögenswerte zum aktuellen Kurs in US-Dollar um und überträgt sie auf Ihr Kontoguthaben; das lässt sich nicht rückgängig machen.
- Transaktionen — On-Chain-Transaktionen aller Adressen im Adresspool. Bei jeder Transaktion steht die zugehörige Bestellung. Transaktionen ohne passende Bestellung sind mit „Nicht verknüpft“ gekennzeichnet, solche, für die keine Bestellung erzeugt wurde, mit „Keine Bestellung“.
- Auszahlungs-API — Programmatische Auszahlungen; verwendet werden nur Vermögenswerte aus „Auszahlbar (eingezogen)“. Den „Hauptschalter“ können Sie erst einschalten, wenn der öffentliche Schlüssel der Gegenseite und mindestens ein Eintrag in der IP-Freigabeliste eingerichtet sind. Der verwendete API-Schlüssel muss außerdem unter „API-Verwaltung“ die Berechtigung „API-Auszahlungen“ haben. Sie können eine Auszahlungsverzögerung, den Gebührenmodus, ein Limit pro Auszahlung und eine Adressfreigabeliste festlegen. Während der Verzögerung können Sie Auszahlungen unter „Auszahlungsverlauf“ pausieren, stornieren oder sofort ausführen.
Selbstverwahrungsadressen importieren: Sie erfassen nur die Adresse; ein privater Schlüssel wird weder benötigt noch angenommen. Beim Import signieren Sie mit der Wallet der jeweiligen Adresse einen von der Seite vorgegebenen Prüftext als Nachricht und weisen so nach, dass die Adresse Ihnen gehört. Die Signatur verbraucht keine Vermögenswerte und autorisiert keine Überweisung; der Text ist 15 Minuten gültig. Welche Netzwerke importiert werden können, zeigt die Seite; unterstützt werden nur TRON- und EVM-Adressen. Pro Vorgang lassen sich höchstens 20 Adressen importieren, pro Blockchain höchstens 100. Eine Adresse, die an eine Anwendung mit Rotation gebunden ist oder noch nicht abgelaufene Bestellungen hat, kann nicht gelöscht werden. Beim Löschen werden auch die für diese Adresse erfassten Transaktionen entfernt.
Tokeneinstellungen: Genauigkeit und Versatz
Die Tokeneinstellungen enthalten zwei Parameter. Zusammen bestimmen sie, wie der Kunde den Zahlbetrag sieht.
- Genauigkeit: Anzahl der Nachkommastellen des Kryptobetrags, einstellbar von 2 bis 10. Für USDT / USDC werden sechs, für TRX zwei empfohlen.
- Empfangsversatz: Bei mehreren gleichzeitig unbezahlten Aufträgen an einer Adresse variiert das System die letzten Dezimalstellen, um sie zu unterscheiden.
- Der Versatz hat Typ und Bereich. Der Bereich muss innerhalb der Genauigkeit liegen; er kann sich nur in den erlaubten Nachkommastellen bewegen.
Deshalb muss der Zahlbetrag exakt stimmen: Die letzten Ziffern identifizieren den Auftrag. Schon etwas mehr oder weniger kann eine Zuordnung verhindern.
API-Integration
Die vollständige Schnittstellenreferenz finden Sie in der Entwicklerdokumentation: Signaturverfahren, Anfrage- und Antwortbeispiele, Fehlercodes, Push-Ereignisse und Signaturprüfung. Über „API-Integrationsdokumentation“ in der Seitenleiste der Konsole gelangen Sie direkt dorthin.
Bestellanfragen werden mit dem App Key signiert. Push-Benachrichtigungen der Plattform an Sie werden mit dem Push-Geheimnis signiert; prüfen Sie die Signatur auf Ihrem Server. Die Option „Weitere offene APIs erlauben“ in den Anwendungsdetails ist standardmäßig ausgeschaltet. Solange sie aus ist, können die Zugangsdaten der Anwendung nur die Zahlungs- und Wechselkursendpunkte aufrufen. Ist sie eingeschaltet, lassen sich auch andere Dienste abfragen; Endpunkte für Bestellungen und Abbuchungen akzeptieren aber weiterhin nur API-Schlüssel aus der „API-Verwaltung“.
Fehlerbehebung
- Ein Kunde hat bezahlt, aber es kam keine Benachrichtigung — Callback-URL falsch oder Serverantwort nicht ordnungsgemäß — Prüfen Sie zuerst die „Push-Protokolle“. Gibt es keinen Eintrag, prüfen Sie die Callback-URL der Anwendung; sie muss eine https-Adresse sein. Gibt es einen fehlgeschlagenen Eintrag, prüfen Sie, ob Ihr Server innerhalb von 10 Sekunden mit 2xx geantwortet hat; nach der Behebung können Sie „Erneut senden“ wählen. Stellen Sie außerdem sicher, dass die Signaturprüfung das aktuelle Push-Geheimnis verwendet.
- Eine Überweisung wurde keiner Bestellung zugeordnet — Der gezahlte Betrag weicht vom angezeigten exakten Betrag ab — Auf einer Adresse können mehrere unbezahlte Bestellungen offen sein; das System unterscheidet sie über den Versatz in den letzten Nachkommastellen. Zahlen Sie exakt den auf der Seite angezeigten Betrag. Nicht zugeordnete Überweisungen sind unter „Transaktionen“ mit „Nicht verknüpft“ gekennzeichnet.
- Es wird keine Empfangsadresse zugewiesen — Der Adresspool hat keine freie Adresse und die automatische Zuweisung hat ihr Limit erreicht, oder unter den rotierenden Adressen ist keine Adresse dieser Blockchain — 1:1-Modus: Hat Ihr Adresspool keine freie Adresse, weist die Plattform automatisch eine zu, höchstens 1000 pro Blockchain innerhalb von 24 Stunden. Ist das Limit erreicht, heben Sie die Bindung nicht mehr benötigter Adressen auf oder importieren Sie eigene Adressen. Rotation: Sind in der Anwendung rotierende Adressen eingerichtet, werden nur diese verwendet; prüfen Sie, ob die Liste eine Adresse dieser Blockchain enthält.
- Die Auszahlungs-API meldet fehlendes Guthaben — Das Geld liegt noch nicht eingezogen auf der Blockchain, oder es ist auf einer Selbstverwahrungsadresse eingegangen — Prüfen Sie unter „Vermögenswerte“ den Betrag „Auszahlbar (eingezogen)“. Noch nicht eingezogene Beträge können Sie unter „Einzugseinstellungen“ mit „Alle geeigneten Vermögenswerte jetzt einziehen“ einziehen. Geld auf Selbstverwahrungsadressen läuft nicht über die Plattform und kann nicht per API ausgezahlt werden.
- Eine Anwendung mit Selbstverwahrungsadressen nimmt keine neuen Bestellungen an — Das Kontoguthaben liegt unter 0 — Gebühren für Selbstverwahrung werden vom Kontoguthaben abgebucht. Sobald das Guthaben durch eine Aufladung wieder über 0 liegt, geht der Betrieb automatisch weiter; zurückgestellte Push-Benachrichtigungen im 1:1-Modus werden automatisch nachgesendet.
- Eine 1:1-Adresse hat eine sehr kleine Überweisung erhalten, aber es wurde keine Bestellung erzeugt — Für Eingänge im Gegenwert von weniger als 0,01 US-Dollar wird keine Bestellung erzeugt — Das Geld ist auf der Adresse angekommen; es wird nur keine Bestellung erzeugt und keine Push-Benachrichtigung gesendet. Unter „Transaktionen“ sehen Sie die Zahlung mit der Kennzeichnung „Keine Bestellung“.
- Neue Zahlungsbestellungen oder das Binden neuer Adressen werden abgelehnt — Das Konto ist eingeschränkt oder gesperrt — In diesem Zustand können Sie keine neuen Zahlungsbestellungen anlegen und keine neuen Adressen binden; vorhandene Bestellungen lassen sich weiterhin abfragen und schließen. Wenden Sie sich bitte an den Support.
Häufig gestellte Fragen
Ein Kunde hat bezahlt, aber mein System hat keine Benachrichtigung erhalten. Was tun?
Prüfen Sie zuerst die „Push-Protokolle“. Gibt es keinen Eintrag, prüfen Sie, ob die Callback-URL der Anwendung richtig eingetragen und eine https-Adresse ist. Gibt es einen fehlgeschlagenen Eintrag, hat Ihr Server nicht mit 2xx innerhalb von 10 Sekunden geantwortet. Nach der Behebung können Sie im Eintrag „Erneut senden“ wählen; die Plattform sendet außerdem automatisch nach dem Wiederholungsschema erneut.
Wo sehe ich die Gebühren und wann werden sie abgezogen?
Den aktuell geltenden Gebührensatz sehen Sie unter „Vermögenswerte → Einzugseinstellungen“ in den „Plattformgebührenregeln“. Bei Adressen in Plattformverwahrung wird die Gebühr beim Einzug abgezogen, bei Selbstverwahrungsadressen nach jedem Zahlungseingang vom Kontoguthaben. Die „Gebühr“ in den Bestelldetails ist bei Plattformverwahrung nur ein Richtwert; maßgeblich ist der Einzug.
Warum muss der Kunde genau den angezeigten Betrag zahlen?
Auf derselben Adresse können gleichzeitig mehrere unbezahlte Bestellungen offen sein; das System unterscheidet sie über den Versatz in den letzten Nachkommastellen. Stimmt der Betrag nicht, kann die Überweisung möglicherweise keiner Bestellung automatisch zugeordnet werden.
Verwandte Seiten: Hilfezentrum · Anleitungen und häufige Fragen · Krypto-Zahlungen über mehrere Blockchains · API-Dokumentation
Wird geladen…