Was es bedeutet

PreVOP hat den Verifikations-Request an den Upstream-VOP-Provider gesendet, innerhalb des konfigurierten Timeouts aber keine Antwort erhalten. Ihr Request wurde nicht abgeschlossen; es liegt kein Verifikationsergebnis vor.

Wann Sie diesen Fehler sehen

• Der Upstream-Provider ist überlastet und seine Antwortlatenz hat die PreVOP-Deadline überschritten.
• Eine vorübergehende Netzwerkstörung zwischen PreVOP und dem Upstream hat den Round-Trip verzögert.
• Der Upstream befindet sich in einem Teilausfall — bedient manche Requests, timet bei anderen aus.
• Ein großer Request-Payload benötigt länger zur Verarbeitung als typische Traffic-Werte.

Beispiel-Antwort

HTTP/1.1 504 Gateway Timeout
Content-Type: application/problem+json
X-Request-ID: 550e8400-e29b-41d4-a716-446655440000

{
  "type":    "https://errors.prod.prevop.alseda.eu/errors/upstream-timeout",
  "code":    "UPSTREAM_TIMEOUT",
  "title":   "Upstream provider did not respond in time",
  "status":  504
}

So beheben Sie das Problem

1. Senden Sie den Request mit einer neuen X-Request-ID erneut. Timeouts sind meist transient und ein Retry gelingt normalerweise.
2. Halten Sie die Anzahl der Retries begrenzt — ein oder zwei Retries mit wachsenden Intervallen (z. B. 1 s, dann 5 s) reichen; unbegrenzte Retries im engen Loop helfen nicht.
3. Wenn Ihr eigenes Request-Budget eine enge Deadline hat, ziehen Sie ein kürzeres Client-seitiges Timeout in Betracht, um schneller zu scheitern und anders zu routen.
4. Halten die Timeouts länger als eine Minute an, behandeln Sie es als Provider-Ausfall und stoppen Sie die Retries — alsedas Upstream-Monitoring hat es dann bereits erkannt.

Verwandte Themen

• Customer API Contract §4.5 — UPSTREAM_TIMEOUT-Beispiel
• Siehe auch: UPSTREAM_UNAVAILABLE — gleiche Klasse von Upstream-Fehler, wenn der Provider zwar geantwortet hat, aber mit einem unbrauchbaren Ergebnis.