Credits
Checkout-Sitzung verifizieren
Eine abgeschlossene Checkout-Sitzung prüfen und sicherstellen, dass Credits gutgeschrieben wurden.
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
JWT-Access-Token (Sitzungsauth). Format:
Bearer YOUR_ACCESS_TOKENPfadparameter
Stripe-Checkout-Sitzungs-ID aus der Antwort von
/credits/checkout.Antwortfelder
Ob die Sitzungsverifikation erfolgreich war.
Anzahl der Credits aus dem Kauf.
Die verifizierte Sitzungs-ID.
Fehlerantworten
400
Ungültige Anfrage – Zahlung nicht abgeschlossen oder ungültige Sitzungs-Metadaten.
401
Nicht autorisiert – Ungültiges oder fehlendes Token.
403
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
- Nutzer schließt den Checkout bei Stripe ab
- Stripe leitet zu Ihrer
successUrlweiter - Rufen Sie diesen Endpunkt auf, um Credits zu bestätigen
- Zeigen Sie dem Nutzer eine Bestätigung
- Aktualisieren Sie den Credit-Saldo in der Oberfläche
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 HeaderAuthorization: