API- und Webhook-Fehlerbehebung
Der QrX API- und Webhook-Support funktioniert am besten, wenn Anfragen klare Identifikatoren und bereinigte technische Details enthalten.
Häufige API-Probleme
Falscher Händler-, Kunden- oder Kanal-Identifikator.
Fehlende Kunden-E-Mail oder Telefonnummer für Verifizierungs- und Support-Abläufe.
Ungültige Konfiguration von Betrag, Währung, Land oder Zahlungsmethode.
Webhook-Endpunkt nicht erreichbar oder liefert eine Nicht-Erfolgs-Antwort.
Doppelte Bestellreferenzen oder Idempotenz-Probleme.
Falsche Umgebung, etwa das Senden von Produktions-Zugangsdaten an einen Test-Endpunkt.
Was Sie dem Support senden sollten
Senden Sie die Umgebung, den Händler oder Kanal, die Bestellreferenz, die QrX-Transaktions-ID, den Zeitstempel, den Endpunkt, den Antwortstatus, die Webhook-Event-ID und einen bereinigten Anfrage- oder Antwort-Body. Entfernen Sie API-Schlüssel, Tokens, Signaturen, Passwörter und personenbezogene Daten, die für das Debugging nicht benötigt werden.
Webhook-Wiederholungsprüfungen
Prüfen Sie, ob Ihr Endpunkt erreichbar ist, schnell einen Erfolgsstatus zurückgibt, Signaturen korrekt validiert und doppelte Webhook-Ereignisse sicher verarbeitet. Webhook-Konsumenten sollten idempotent sein, da Wiederholungen auftreten können.
Webhook-Gesundheit und Zustellprotokolle
Jedes Webhook-Abonnement in PortalX zeigt einen Gesundheitsstatus an. Wenn ein Endpunkt dauerhaft fehlschlägt, sendet QrX Warn-E-Mails an die konfigurierten Empfänger und deaktiviert das Abonnement nach etwa 24 Stunden ununterbrochener Fehler automatisch; es kann in PortalX wieder aktiviert werden, nachdem der Endpunkt repariert wurde. Nutzen Sie das Zustellprotokoll pro Webhook in PortalX, um jeden Zustellversuch einschließlich Anfrage, Antwort und Wiederholungen zu untersuchen, bevor Sie den Support kontaktieren.
Wann Sie unser Support-Team kontaktieren sollten
Kontaktieren Sie den QrX-Support direkt bei API-Problemen, die Zugangsdaten, Sicherheit, Produktionsvorfälle, Zahlungsinkonsistenzen, Webhook-Signaturfehler oder wiederholte Integrationsfehler betreffen. Diese Fälle werden immer von einem Menschen bearbeitet.