Operative Checkliste für Krypto-Zahlungen

Vor dem Start

Einmal erledigen und nach jeder Änderung an Ihrem Server wiederholen.

• Der API-Schlüssel liegt nur auf dem Server, in einer Umgebungsvariable oder einem Secrets-Manager, nie im Frontend-Code oder in einem Repository.
• Die Callback-URL ist gespeichert, öffentlich und per HTTPS, und von außerhalb Ihres Netzwerks erreichbar.
• Der Webhook-Handler antwortet exakt mit HTTP 200, schnell, und lässt sich bedenkenlos zweimal ausführen. Jeder andere Status, ein Timeout oder eine Weiterleitung zählt als fehlgeschlagene Zustellung. Siehe Krypto-Zahlungs-Webhooks absichern.
• Eine Testzahlung funktioniert durchgängig. Zahlen Sie einen kleinen echten Betrag, sehen Sie den Webhook eintreffen und die Bestellung auf bezahlt wechseln. Es gibt noch keine Sandbox, nutzen Sie also kleine echte Beträge.
• Ein Wiederholungsversuch funktioniert. Lassen Sie den Endpunkt einmal fehlschlagen und prüfen Sie, dass Qvard es erneut versucht (fünf Versuche in etwa sechs Minuten), ohne die Bestellung doppelt auszuführen.
• Eine Auszahlung funktioniert. Heben Sie einen kleinen Betrag auf Ihre eigene Wallet ab. Er kostet nur die Netzwerkgebühr.
• Die Regeln sind aufgeschrieben: was Sie bei einer Unterzahlung tun, wie Sie erstatten und wer Kunden antwortet.

Jeden Tag

Ein paar Minuten, am besten zur gleichen Zeit.

• Unbezahlte Bestellungen außerhalb des Kursfensters. Der Kurs auf der Zahlungsseite ist eine Stunde fixiert. Sehen Sie sich Bestellungen an, die danach noch warten: Sie wurden abgebrochen, oder eine Benachrichtigung ging verloren.
• Unterzahlungen. Eine Zahlung mit Status partial sendet keinen Abschluss-Webhook. Prüfen Sie diese im Dashboard, halten Sie die Bestellung zurück und kontaktieren Sie den Kunden. Siehe Unterzahlungen bei USDT behandeln.
• Fehler am Webhook-Endpunkt. Eine Serie fehlgeschlagener Anfragen oder 401-Antworten bedeutet einen defekten Endpunkt oder einen nicht passenden Schlüssel. Richten Sie einen Alarm ein, statt es am Tagesende zu entdecken.
• Die Tagessumme. Vergleichen Sie die als bezahlt markierten Bestellungen mit den Zahlungen im Dashboard. Die öffentliche API hat keine Route zum Auflisten von Zahlungen, es ist also ein Vergleich mit Ihrem eigenen Webhook-Protokoll. Siehe Zahlungsabgleich für Krypto-Händler.

Jede Woche

• Verpasste Benachrichtigungen. Zeigt das Dashboard eine abgeschlossene Zahlung, die Ihr Bestellsystem nicht kennt, senden Sie die Benachrichtigung aus dem Dashboard erneut und lassen Sie den idempotenten Handler sie anwenden.
• Support-Muster. Zählen Sie die Tickets zu falschen Netzwerken, Unterzahlungen und „Ich habe bezahlt, nichts ist passiert". Wiederholt sich eines, korrigieren Sie die Formulierung im Checkout oder auf der Bestellseite, nicht jedes Ticket.
• Erstattungen. Prüfen Sie, dass jede gesendete Erstattung der ursprünglichen Bestellung zugeordnet ist und an eine vom Kunden bestätigte Adresse und ein bestätigtes Netzwerk ging.
• Salden nach Asset und Netzwerk. Zahlungen in verschiedenen Netzwerken sammeln sich getrennt. Sehen Sie nach, was wo liegt, bevor Sie entscheiden, was Sie abheben.
• Bestand und Ablauf. Reservieren Sie Bestand für unbezahlte Bestellungen, bestätigen Sie, dass abgelaufene Bestellungen ihn freigeben.

Jeden Monat

• Vollständig abgleichen. Gleichen Sie die Bestellungen des Monats, das Webhook-Protokoll und die Dashboard-Zahlungen ab und erklären Sie jede Abweichung. Buchen Sie den Umsatz in Dollar zum Bestellwert und erfassen Sie Provision und Auszahlungsgebühren als eigene Zeilen.
• Auszahlungen prüfen. Es gibt keine Abo-Gebühr; die Provision ist für Ihr Projekt individuell und beginnt laut Preisseite bei 1 % und kann bis auf 0,1 % sinken. Eine Auszahlung kostet nur die Netzwerkgebühr, meist ein fester Betrag pro Überweisung; heben Sie daher in sinnvollen Größen ab statt in vielen kleinen. Siehe Netzwerkgebühren im Betrieb von Krypto-Zahlungen.
• Zugriffe rotieren und prüfen. Prüfen Sie, wer den API-Schlüssel und das Dashboard sehen kann, und tauschen Sie den Schlüssel, wenn jemand mit Zugriff gegangen ist oder Sie ein Leck vermuten.
• Den Kundentext erneut lesen. Nennt der Checkout noch die akzeptierten Assets und Netzwerke, den Gebührenhinweis und die Erstattungsregel? Stimmt es noch?
• Mit dem Steuerberater abstimmen. Steuerliche und buchhalterische Behandlung von Krypto-Einnahmen hängt von Ihrem Land ab; prüfen Sie die Praxis regelmäßig.

Wenn etwas falsch aussieht

Ein kurzes Vorgehen für die häufigen Fälle.

• Ein Kunde sagt, er habe bezahlt, die Bestellung ist unbezahlt. Sehen Sie die Zahlung im Dashboard an. Ist sie abgeschlossen, senden Sie die Benachrichtigung erneut. Ist sie partial, fordern Sie die Differenz an. Gibt es sie nicht, fragen Sie nach Transaktionsdaten und dem genutzten Netzwerk.
• Falsches Netzwerk. Die Mittel kommen nicht wie erwartet an und erfordern manuelle Bearbeitung. Halten Sie einen Support-Kontakt auf dem Zahlungsweg sichtbar.
• Eine bezahlte Bestellung wurde zweimal ausgeführt. Der Handler ist nicht idempotent. Machen Sie die Aktualisierung bedingt („bezahlt nur, wenn noch nicht bezahlt") in einer einzigen Datenbankanweisung.
• Der Webhook kommt nicht mehr an. Testen Sie den Endpunkt von außerhalb Ihres Netzwerks, prüfen Sie den Antwortcode im Zugriffsprotokoll und suchen Sie nach Firewall, Weiterleitung oder langsamem Handler. Siehe Webhook-Wiederholungsstrategie für Zahlungssysteme.
• Sie sind unsicher, was die API tut. Die Referenz ist Krypto-Zahlungs-API für Entwickler.

Bewahren Sie diese Liste dort auf, wo Ihr ganzes Team sie sieht, und notieren Sie, wer für jede Zeile zuständig ist.

FAQ