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
string
erforderlich
JWT-Access-Token (Sitzungsauth). Format:
Bearer YOUR_ACCESS_TOKENPfadparameter
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
- 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: