Skip to main content
GET

Überblick

Nach erfolgreichem Checkout können Sie mit diesem Endpunkt prüfen, ob die Zahlung verarbeitet und Credits dem Konto gutgeschrieben wurden. Nützlich als Fallback, wenn der Webhook nicht verarbeitet wurde.
Credits werden üblicherweise automatisch per Stripe-Webhooks gutgeschrieben. Dieser Endpunkt ermöglicht eine manuelle Verifikation für Sonderfälle oder eine clientseitige Bestätigung.
Für Drittanbieter-Integrationen: Verwenden Sie GET /credits/verify-session/{sessionId}/api mit API-Schlüssel-Authentifizierung.

Authentifizierung

string
erforderlich
JWT-Access-Token (Sitzungsauth). Format: Bearer YOUR_ACCESS_TOKEN

Pfadparameter

string
erforderlich
Stripe-Checkout-Sitzungs-ID aus der Antwort von /credits/checkout.

Antwortfelder

boolean
Ob die Sitzungsverifikation erfolgreich war.
integer
Anzahl der Credits aus dem Kauf.
string
Die verifizierte Sitzungs-ID.

Fehlerantworten

Ungültige Anfrage – Zahlung nicht abgeschlossen oder ungültige Sitzungs-Metadaten.
Nicht autorisiert – Ungültiges oder fehlendes Token.
Verboten – Sitzung gehört nicht zum authentifizierten Nutzer.

Idempotenz

Der Aufruf ist idempotent. Wurden Credits bereits per Webhook gutgeschrieben, erfolgt keine erneute Gutschrift. Es wird weiterhin Erfolg mit dem Credit-Betrag zurückgegeben.

Typischer Ablauf

  1. Nutzer schließt den Checkout bei Stripe ab
  2. Stripe leitet zu Ihrer successUrl weiter
  3. Rufen Sie diesen Endpunkt auf, um Credits zu bestätigen
  4. Zeigen Sie dem Nutzer eine Bestätigung
  5. Aktualisieren Sie den Credit-Saldo in der Oberfläche
Empfohlen bleibt, Stripe-Webhooks zu nutzen und die Oberfläche basierend auf /credits/balance zu aktualisieren. Dieser Endpunkt ergänzt diesen Ablauf.

GET /credits/verify-session//api

Verifiziert eine Checkout-Sitzung mit API-Schlüssel-Authentifizierung. Geeignet für Drittanbieter-Integrationen.

Authentifizierung

API-Schlüssel erforderlich. Übergeben Sie ihn im Header Authorization:

Pfadparameter

Wie oben.

Antwort

Wie oben.