Aller au contenu principal

Access Stripe customer portal to manage subscription

POST 
/company/payment/changePlans

Génère une session du portail client Stripe où l'entreprise peut gérer son abonnement, changer de plan, mettre à jour sa carte ou consulter les factures.

Objectif​

Fournir un accès au portail en libre-service de Stripe avec validation que le compte est actif et non expiré.

Cas d'utilisation​

  • Changer du plan Basic à Professional ou vice versa
  • Annuler un abonnement actif
  • Mettre à jour le mode de paiement de l'abonnement
  • Consulter l'historique des factures Stripe
  • Télécharger les factures en PDF

Flux de validation​

flowchart TD
  A[Recevoir la requête - returnUrl] --> B{returnUrl fourni ?}
  B -->|Non| C[400 MISSING_RETURN_URL]
  B -->|Oui| D{Utilisateur authentifié ?}
  D -->|Non| E[404 USER_NOT_FOUND]
  D -->|Oui| F{Entreprise trouvée ?}
  F -->|Non| G[401 CIA_NOT_FOUND]
  F -->|Oui| H{UserActivity existe ?}
  H -->|Non| I[404 USER_NOT_FOUND]
  H -->|Oui| J{Compte non expiré ?}
  J -->|Expiré| K[404 USER_EXPIRED]
  J -->|Actif| L[Créer une session du Portail Client]
  L --> M[200 URL du Portail]

Notes​

  • Requiert une authentification JWT (bearerAuth)
  • Contrairement au module truckers, valide que le compte n'est pas expiré
  • Vérifie userActivity.dateEnd > now avant de créer la session
  • L'URL de retour (returnUrl) est obligatoire dans le corps de la requête
  • La session du portail expire en ~5 minutes (comportement de Stripe)
  • Requiert stripe_customer configuré pour l'entreprise

Request​

Responses​

URL du portail client Stripe

Response Headers