Skip to main content
POST

Vue d’ensemble

Crée une session Stripe Checkout pour souscrire à une formule. Renvoie une URL vers laquelle rediriger l’utilisateur pour finaliser le paiement. Nécessite une authentification par session (jeton d’accès JWT).
Pour les intégrations tierces : utilisez POST /subscriptions/checkout/api avec authentification par clé d’API.

Authentification

string
requis
Jeton d’accès JWT. Format : Bearer YOUR_ACCESS_TOKEN

Corps de la requête

string
requis
Identifiant de la formule : starter, professional, business ou agency.
string
défaut:"monthly"
Fréquence de facturation : monthly ou yearly.
string
URL de redirection après paiement réussi. Par défaut : tableau de bord de l’application.
string
URL de redirection si l’utilisateur annule le paiement. Par défaut : page tarifs.

Champs de réponse

string
Identifiant de session Stripe Checkout. Permet une vérification ultérieure.
string
URL de redirection vers la page de paiement hébergée par Stripe.
object
Détails de la formule sélectionnée.

Déroulement du checkout

  1. Créer la session : appeler ce point de terminaison avec la formule souhaitée
  2. Rediriger l’utilisateur : envoyer vers l’url renvoyée
  3. Paiement : l’utilisateur paie sur Stripe
  4. Webhook : Stripe notifie votre endpoint webhook
  5. Redirection succès : l’utilisateur arrive sur successUrl
  6. Vérification (facultatif) : contrôler l’abonnement via /subscriptions/current

Réponses d’erreur

Requête incorrecte : identifiant de formule invalide ou abonnement déjà actif.
Non autorisé : jeton manquant ou invalide.
Si l’utilisateur a déjà un abonnement actif, il doit utiliser le portail de facturation (/subscriptions/portal) pour changer de formule.

POST /subscriptions/checkout/api

Crée une session Stripe 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 :

Corps de la requête

Identique à /subscriptions/checkout ci-dessus.

Réponse

Identique à /subscriptions/checkout ci-dessus.