Fehler

Fehler liefern einen JSON-Body mit einem Feld error und oft einer message mit weiteren Details:

{
  "error": "You haven't set up a wallet address for the Polygon network",
  "message": "Please configure a Polygon-specific wallet in your merchant settings before accepting payments on this network.",
  "network": "polygon"
}

Statuscodes

Code	Bedeutung
400	die Anfrage wurde abgelehnt, lesen Sie error
401	fehlende oder ungültige Zugangsdaten
404	kein solcher Endpunkt, oder keine solche Ressource bei den Endpunkten, die dies verwenden
500	serverseitig ist etwas fehlgeschlagen

Eine unbekannte Zahlungs-ID gibt 500 zurück

Der Abruf einer Zahlung, die nicht existiert, gibt 500 zurück, nicht 404:

{ "success": false, "error": "Failed to query payment status" }

Das betrifft die Abruf-Endpunkte für Zahlungen und Einzahlungen. Andere Endpunkte geben für eine nicht existierende Ressource sehr wohl 404 zurück, das Verhalten ist also nicht in der gesamten API einheitlich. Es ist dokumentiert, weil es heute so passiert: Werten Sie 500 auf diesen Routen nicht zwangsläufig als Ausfall. Prüfen Sie zuerst die ID.

Da eine Änderung von 500 zu 404 den Statuscode für ein bestehendes Ergebnis ändern würde, gilt sie gemäß unserer Versionierungsrichtlinie als Breaking Change und wird in v1 nicht stillschweigend eingeführt.

Erneut versuchen

500-Antworten bei Abruf-Endpunkten können gefahrlos wiederholt werden.

Das Wiederholen eines Schreibvorgangs ist nur sicher, wenn der Server die Wiederholung erkennen kann. Senden Sie einen Idempotency-Key-Header oder zumindest dieselbe orderId. Siehe Sicher erneut versuchen.