Aller au contenu principal

Get checkout URLs for subscription plans

GET 
/company/payment/urls

Génère des URL de session de paiement Stripe pour chaque plan d'abonnement disponible, prêtes à rediriger l'utilisateur.

Objectif​

Fournir au frontend les liens directs vers Stripe Checkout pour que l'entreprise puisse sélectionner et payer un plan d'abonnement.

Cas d'utilisation​

  • Afficher des cartes de plans avec des boutons S'abonner
  • Rediriger l'utilisateur vers Stripe Checkout pour finaliser le paiement
  • Présenter une comparaison des plans disponibles avec leurs prix

Flux de validation​

flowchart TD
  A[Reçoit la requête] --> B{Utilisateur authentifié ?}
  B -->|Non| C[404 USER_NOT_FOUND]
  B -->|Oui| D{Entreprise trouvée ?}
  D -->|Non| E[401 CIA_NOT_FOUND]
  D -->|Oui| F[Récupère les plans depuis la BD]
  F --> G[Récupère les prix Stripe]
  G --> H[Crée des sessions Checkout par plan]
  H --> I[200 OK - Plans + URLs]

Notes​

  • Requiert une authentification JWT (bearerAuth)
  • Si l'entreprise a un stripe_customer, l'associe à la session
  • Si elle n'a pas de stripe_customer, utilise l'email de invoice_data.email
  • L'URL de retour est fixe : ${HOST_FRONT}/admin/config
  • Mode d'abonnement : subscription (pas de paiement unique)
  • Inclut un client_reference_id avec la référence de l'entreprise

Request​

Responses​

Liste des plans avec les URLs de paiement Stripe

Response Headers