Skip to main content
GET

Vue d’ensemble

Après un paiement réussi, utilisez ce point de terminaison pour vérifier que le paiement a été traité et que les crédits ont été ajoutés au compte. Utile en secours si le webhook n’a pas été traité.
Les crédits sont en général ajoutés automatiquement via les webhooks Stripe. Ce point de terminaison permet une vérification manuelle pour les cas limites ou une confirmation côté client.
Pour les intégrations tierces : utilisez GET /credits/verify-session/{sessionId}/api avec authentification par clé d’API.

Authentification

string
requis
Jeton d’accès JWT (auth session). Format : Bearer YOUR_ACCESS_TOKEN

Paramètres de chemin

string
requis
Identifiant de session Stripe Checkout renvoyé par /credits/checkout.

Champs de réponse

boolean
Indique si la vérification de la session a réussi.
integer
Nombre de crédits issus de l’achat.
string
Identifiant de session vérifié.

Réponses d’erreur

Requête incorrecte : paiement non finalisé ou métadonnées de session invalides.
Non autorisé : jeton manquant ou invalide.
Interdit : la session n’appartient pas à l’utilisateur authentifié.

Idempotence

Ce point de terminaison est idempotent. Si les crédits ont déjà été ajoutés (via webhook), ils ne seront pas ajoutés une seconde fois. La réponse reste un succès avec le montant en crédits.

Déroulement type

  1. L’utilisateur finalise le paiement sur Stripe
  2. Stripe redirige vers votre successUrl
  3. Appelez ce point de terminaison pour vérifier et confirmer les crédits
  4. Affichez la confirmation à l’utilisateur
  5. Actualisez le solde dans votre interface
Bien que ce point de terminaison soit disponible, le flux recommandé est d’écouter les webhooks Stripe et de mettre à jour l’interface à partir de /credits/balance.

GET /credits/verify-session//api

Vérifie une session Checkout avec authentification par clé d’API. Adapté aux intégrations tierces.

Authentification

Authentification par clé d’API obligatoire. Indiquez votre clé dans l’en-tête Authorization :

Paramètres de chemin

Identiques à ci-dessus.

Réponse

Identique à ci-dessus.