Arbeiten mit Zahlungen in QryptoPay

Jede Zahlung in QryptoPay hat ihre eigene Karte — den Dialog „Blockchain-Zahlungsdetails“. Öffnen Sie einen Merchant, wechseln Sie zum Reiter „Zahlungen“, fahren Sie mit der Maus über die gewünschte Zeile und klicken Sie auf das Symbol mit dem Tooltip „Zahlungsdetails“.

Der Reiter bietet eine Suche — nach der E-Mail-Adresse des Kunden (Teilübereinstimmung) oder nach der exakten Zahlungs-ID — sowie Filter nach Bezahlstatus, Währung und Chain. Der Status neben einer Zahlung zeigt ihre Phase: „Erstellt“ und „Nicht bezahlt“ bedeuten, das Geld ist noch nicht eingegangen, „Teilweise bezahlt“ und „Überbezahlt“ bedeuten, der Betrag weicht vom erwarteten ab, „Bezahlt“ heißt, die Zahlung ist abgeschlossen, „Abgelaufen“ heißt, die Frist ist verstrichen, und „Ungültig“ heißt, sie wurde ohne Zahlungseingang geschlossen.

Blockchain-Transaktionsdaten

Die Karte zeigt die zur Zahlung gefundenen Transaktionen, und der Link „Im Explorer anzeigen“ öffnet bei jeder davon den Blockchain-Explorer.

⚠️ Erneute Prüfung und Transaktionssuche — nur für Tron und Ethereum

Die Schaltflächen „Zahlung erneut prüfen“ und „Transaktion per ID prüfen“ erscheinen in der Karte nur bei Zahlungen in den Chains Tron und Ethereum — also TRX, USDT TRC-20 und andere Tron-Token sowie ETH, USDT ERC-20, USDC und andere Ethereum-Token. Für Bitcoin, Litecoin und Monero gibt es solche Schaltflächen in der Karte nicht — für diese Chains ist kein manuelles Werkzeug vorgesehen.

Webhook-Zustellung

Sobald eine Zahlung bezahlt ist, erscheint in der Karte der Block „Webhook-Zustellung“ — er zeigt, ob Ihr Shop die Statusbenachrichtigung zu genau dieser Zahlung erhalten hat. Mögliche Zustände:

• Zugestellt — der Shop hat die Benachrichtigung erhalten.
• Wird gesendet… — der Versand läuft gerade.
• Wiederholung ausstehend — der vorherige Versuch ist fehlgeschlagen, die Wiederholung ist in die Warteschlange gestellt und läuft automatisch ab.
• Fehlgeschlagen — die Zustellung ist gescheitert, weitere automatische Versuche folgen nicht mehr.
• Nie gesendet — die Benachrichtigung wurde noch nie versendet.

Szenario 1. Die Zahlung ist bezahlt, aber das Panel erfasst es nicht

Der Kunde sagt, er habe das Geld überwiesen, doch die Zahlung ist weiterhin unbezahlt. Bei Tron oder Ethereum gibt es zwei Werkzeuge, mit steigendem Aufwand.

Klicken Sie zuerst auf „Zahlung erneut prüfen“. Das Panel durchsucht erneut die Blöcke über die gesamte Lebensdauer der Zahlung und sucht nach Überweisungen an ihre Adresse, weiter als der reguläre Scanner. Das Ergebnis kommt als Benachrichtigung: gefunden — das Panel schreibt es gut und aktualisiert den Status der Zahlung; nichts gefunden — bei einer bereits bezahlten Zahlung bedeutet das nur „bereits erfasst“, bei allen anderen bleibt die Transaktionssuche der nächste Schritt. Auf drei erneute Prüfungen pro Zahlung und Stunde begrenzt.

Hilft die erneute Prüfung nicht, oder kann der Kunde den Hash der Überweisung mitteilen, klicken Sie auf „Transaktion per ID prüfen“, fügen Sie den Hash in das Feld „Transaktions-ID“ ein und klicken Sie auf „Prüfen“ — ein Probelauf, der noch nichts ändert. Gehört die Überweisung zu genau dieser Zahlung, erscheint die Schaltfläche „Importieren“. Die übrigen Antworten sind im Abschnitt „Das Geld ist woanders angekommen“ weiter unten beschrieben. Auf zehn Prüfungen pro Stunde und Terminal begrenzt.

Szenario 2. Das Panel erfasst die Zahlung, aber der Shop hat keine Benachrichtigung erhalten

Die Zahlung ist bezahlt, doch der Shop hat nicht reagiert: Die Bestellung wurde nicht abgeschlossen. Der Grund liegt im Block „Webhook-Zustellung“, der nur bei bereits bezahlten Zahlungen erscheint.

Die Statusbenachrichtigung sendet das Panel automatisch, sobald eine Zahlung abgeschlossen wird, und schlägt der erste Versuch fehl, wiederholt es ihn einmal pro Stunde, bis eine Antwort 200 OK eintrifft. Die Schaltfläche „Erneut senden“ ist für den Fall gedacht, dass Warten keine Option ist oder die automatischen Versuche bereits ausgeschöpft sind:

• bei „Wiederholung ausstehend“ — das Panel sendet sofort, statt auf den nächsten automatischen Versuch zu warten;
• bei „Fehlgeschlagen“ — es gibt keine automatischen Versuche mehr, und dies ist der einzige Weg, es erneut zu versuchen;
• bei „Nie gesendet“ — die Benachrichtigung wird zum ersten Mal gesendet.

Ist im Terminal kein Webhook konfiguriert, fehlt die Schaltfläche — stattdessen erscheint ein Hinweis, den Webhook einzutragen (das geschieht im Schritt zur Webhook-Einrichtung bei der Shop-Integration).

⚠️ Eine bereits zugestellte Benachrichtigung erneut zu senden ist riskant

Beim Zustand „Zugestellt“ weist das Panel eigens darauf hin: Der Shop hat die Benachrichtigung bereits erhalten, ein erneutes Senden kann zu einer doppelten Gutschrift auf seiner Seite führen. Senden Sie nur erneut, wenn Sie sicher sind, dass der Shop sie nicht verarbeitet hat.

⚠️ „Nie gesendet“ deckt zwei unterschiedliche Fälle ab

War eine Benachrichtigung bereits erstellt, aber nie versendet, sendet das Panel genau diese unverändert. Wurde dagegen nie etwas erstellt, erzeugt es eine neue aus den aktuellen Zahlungsdaten — die vom ursprünglichen Inhalt abweichen kann.

Auch die Schaltfläche „Erneut senden“ ist begrenzt — höchstens fünf Versände pro Zahlung und Stunde.

Szenario 3. Das Geld ist woanders angekommen

Der Kunde hat einen Hash geschickt, aber die geöffnete Zahlung ist nicht die richtige: Die Überweisung ist auf der Adresse des Kunden angekommen, wurde aber einer anderen Zahlung zugeordnet — oder gar keiner. Das Panel weist einem Kunden meist dieselbe Adresse für alle seine Zahlungen zu und sucht die Überweisung anhand der Adresse, nicht anhand einer Rechnung — deshalb genügt jede Zahlung dieses Kunden, nicht zwingend die „richtige“.

Öffnen Sie die Karte einer solchen Zahlung, klicken Sie auf „Transaktion per ID prüfen“, fügen Sie den Hash in „Transaktions-ID“ ein und klicken Sie auf „Prüfen“. Danach sind folgende Fälle möglich:

• Die Überweisung gehört zu einer anderen Zahlung — öffnet sich die Karte dieser Zahlung mit der Schaltfläche „In diese Zahlung importieren“, die die Überweisung dorthin gutschreibt, nicht der geöffneten Zahlung.
• Es gibt keine passende Zahlung — die Überweisung kam an, während auf dieser Adresse keine Rechnung offen war. „Als Aufladung erfassen“ legt dafür eine eigene, bereits bezahlte Zahlung an, damit das Geld nicht verloren geht, und benachrichtigt den Shop darüber.
• Die Überweisung wurde bereits früher importiert — die Karte zeigt, zu welcher Zahlung sie gehört, weiteres ist nicht nötig.

Andere Antworten — ein Fehler auf Seiten des Blockchain-Node, eine Lizenzbeschränkung und Ähnliches — werden direkt im Dialog erklärt; dann bleibt nur, es später erneut zu versuchen.

Nützliche Links

• Shop-Integration mit QryptoPay — wie der Shop Webhook-Benachrichtigungen empfängt und prüft.
• Zahlungs-Routing zwischen Wallets in QryptoPay — wenn die Zahlungen eines Kunden immer wieder im falschen Wallet landen, prüfen Sie die Routing-Regeln.
• Vorgangsprotokoll in QryptoPay — gehört der gefundene Hash nicht zu einer Kundenzahlung, sondern zu einer Überweisung zwischen Ihren eigenen Wallets, importieren Sie ihn stattdessen im Reiter „Vorgänge“.