Was es bedeutet

Sie haben Ihr vertragliches Verifikations-Kontingent für die aktuelle Periode aufgebraucht, UND ein zusätzlich konfigurierter Burst-Anteil ist ebenfalls erschöpft. PreVOP lehnt den Request ab, damit Ihr Konto innerhalb des vereinbarten Konsum-Rahmens bleibt.

Wann Sie diesen Fehler sehen

• Ihr tägliches / wöchentliches / monatliches / jährliches Kontingent (je nach Vertrag) ist voll verbraucht.
• Falls ein Extra-Kontingent bereitgestellt wurde, ist auch dieses verbraucht.
• Für Ihr Konto ist kein aktives Kontingent konfiguriert — z. B. bei einem neuen Kunden, der noch nicht live ist.
• Das Gateway ist so konfiguriert, dass es bei Überschreitung sofort ablehnt statt zu puffern — kein Backpressure, kein verzögerter Retry.

Beispiel-Antwort

HTTP/1.1 429 Too Many Requests
Content-Type: application/problem+json
X-Request-ID: 550e8400-e29b-41d4-a716-446655440000
X-Quota-Extra: false
Retry-After: 3600

{
  "type":    "https://errors.prod.prevop.alseda.eu/errors/quota-exceeded",
  "code":    "QUOTA_EXCEEDED",
  "title":   "Quota exhausted for current period",
  "status":  429,
  "detail":  "Monthly quota of 100000 + extra 5000 reached; resets 2026-05-01"
}

So beheben Sie das Problem

1. Lesen Sie das detail-Feld — es nennt die Kontingent-Einheit und, falls möglich, das Reset-Datum.
2. Warten Sie bis zum Reset. Monatliche Kontingente setzen sich am 1. des Folgemonats (Berliner Zeit) zurück; tägliche um Mitternacht Berlin.
3. Für längerfristigen Mehrbedarf kontaktieren Sie alseda — wir prüfen eine Anhebung oder ein zusätzliches Extra-Kontingent.
4. Bei unerwarteten Spitzen prüfen Sie Ihr eigenes Caching + Deduplizierung — wiederholte Verifikationen desselben Empfängers sind meist vermeidbar.
5. Beobachten Sie den Header X-Quota-Extra in erfolgreichen Antworten — true bedeutet, dass Sie bereits Extra-Kontingent verbrauchen und sich dem Ende nähern.

Verwandte Themen

• Customer API Contract §3 — Kontingent-Header (X-Quota-Extra, Retry-After)
• Siehe auch: CUSTOMER_BLOCKED — administrative Drosselung, unterscheidet sich von der mengenbasierten Drosselung dieser Seite.