Jede Fehler-Antwort der PreVOP-Verifikations-API folgt RFC 7807 (Problem Details). Das Feld type im JSON-Body verweist auf die passende Seite unten — wenn Sie das hier lesen, sind Sie vermutlich über einen solchen Link hierher gekommen.

Maschinen-lesbare Identifikation: verwenden Sie das Feld code im Response-Body (z. B. VALIDATION_FAILED), NICHT die type-URL. Die URL kann sich zwischen Versionen ändern; der Code nicht.

Client-seitige Fehler (4xx)

Code	HTTP	Kurzbeschreibung
VALIDATION_FAILED	400	Ihr Request-Body hat die Gateway-Validierung nicht bestanden.
FORMAT_ERROR	400	EPC-Schema-Verletzung, typischerweise upstream erkannt.
TIMESTAMP_INVALID	400	X-Request-Timestamp fehlt, ist fehlerhaft oder außerhalb des Replay-Fensters.
CLIENT_INVALID	401	Client-Zertifikat oder X-Customer-ID wurde nicht akzeptiert.
CLIENT_INCONSISTENT	400/401	Credentials authentifiziert, passen aber nicht zum Request-Payload.
CUSTOMER_BLOCKED	403	Ihr Kundenkonto ist derzeit nicht aktiv.
QUOTA_EXCEEDED	429	Vertragliches Kontingent (inkl. Extra-Anteil) ist aufgebraucht.

Server-seitige Fehler (5xx)

Code	HTTP	Kurzbeschreibung
UPSTREAM_UNAVAILABLE	502	Upstream-VOP-Provider hat Fehler zurückgegeben oder war nicht erreichbar.
UPSTREAM_TIMEOUT	504	Upstream-VOP-Provider hat nicht rechtzeitig geantwortet.
INTERNAL_ERROR	500	PreVOP-seitiger Fehler. Selten; an alseda mit der X-Request-ID melden.

Fehler-Antwort lesen

Jeder Fehler enthält einen code (Maschinen-ID), einen title (Kurzbeschreibung), einen status (HTTP-Code) und optional ein detail-Feld sowie ein issues[]-Array. Prüfen Sie den Response-Header X-Rejected-By-Provider, um Gateway-seitige von Upstream-seitigen Fehlern zu unterscheiden — relevant für mehrere der oben genannten 4xx-Codes.

Vollständiger Vertrag: der Customer API Contract (wird mit Ihrem alseda-Integration-Lead geteilt) enthält die vollständige Spezifikation; diese Seite ist der öffentliche Einstiegspunkt, auf den jede Laufzeit-Fehlerantwort verlinkt.

Support

Schreiben Sie an prevop-support@alseda.com und geben Sie den X-Request-ID-Header aus der Antwort an — damit können wir den Fehler in unseren Logs korrelieren.