Aller au contenu principal

Set up new payment method

POST 
/truckers/payment/setup_payment_method

Objectif​

Générer une URL du portail Stripe permettant à l'entreprise d'ajouter un nouveau moyen de paiement (carte de crédit/débit) de manière sécurisée.

Objectif​

Rediriger l'utilisateur vers le portail Stripe où il peut enregistrer ses informations de carte sans exposer de données sensibles au backend.

Cas d'utilisation​

  • Ajouter la première carte de crédit/débit
  • Ajouter des moyens de paiement supplémentaires (max. 10)
  • Remplacer des cartes expirées par de nouvelles

Flux de validation​

flowchart TD
  A[Reçoit la requête - returnUrl] --> B{returnUrl fournie ?}
  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{stripe_customer existe ?}
  H -->|Non| I[404 STRIPE_CUSTOMER_NOT_FOUND]
  H -->|Oui| J{Nombre < 10 ?}
  J -->|Non| K[200 - Chaîne vide]
  J -->|Oui| L[Créer le portail de moyens de paiement]
  L --> M[200 - URL du portail]

Notes​

  • Nécessite une authentification JWT (bearerAuth)
  • Limite de 10 moyens de paiement par entreprise ; si atteinte, retourne `` (chaîne vide)
  • Nécessite que l'entreprise ait un stripe_customer (utiliser /register_stripe d'abord)
  • La returnUrl est l'URL vers laquelle Stripe redirige l'utilisateur après l'ajout du moyen de paiement

Request​

Responses​

URL du portail ou chaîne vide si la limite de 10 est atteinte

Response Headers