Aller au contenu principal

Register company as Stripe customer

POST 

/company/payment/register_stripe

Créez un client Stripe pour l'utilisateur authentifié s'il n'en a pas encore un enregistré, et retournez l'ID du client.

Objectif

Initialiser la relation entre l'utilisateur de l'entreprise et Stripe, en obtenant l'ID stripe_customer nécessaire pour toutes les opérations de paiement ultérieures.

Cas d'utilisation

  • Premier enregistrement avant de configurer les méthodes de paiement
  • Vérifier si l'utilisateur est déjà enregistré sur Stripe
  • Prérequis pour les abonnements et les paiements

Flux de validation

flowchart TD
A[Reception de la requête] --> B{Utilisateur authentifié ?}
B -->|Non| C[404 USER_NOT_FOUND]
B -->|Oui| D{Utilisateur en base de données ?}
D -->|Non| E[401 USER_NOT_FOUND]
D -->|Oui| F{stripe_customer existe ?}
F -->|Oui| G[Retourner l'ID existant]
F -->|Non| H[Créer un client Stripe]
H --> I{Création réussie ?}
I -->|Non| J[401 STRIPE_ACCOUNT_NOT_CREATED]
I -->|Oui| K[Sauvegarder l'ID dans user.payment_settings]
K --> L[200 succès + stripe_customer]
G --> L

Notes

  • Requiert une authentification JWT (bearerAuth)
  • Idempotent : si stripe_customer existe déjà, retourne l'ID existant
  • Opère sur le company_user, et non directement sur l'entreprise
  • Aucun corps de requête requis

Request

Responses

Client Stripe enregistré avec succès ou déjà existant.

Response Headers