Aller au contenu principal

Stripe Connect onboarding return callback

GET 

/company/payment/onboarding/return

Endpoint de callback vers lequel Stripe redirige l'entreprise après avoir terminé (ou tenté de terminer) le processus d'intégration Stripe Connect.

Objectif

Mettre à jour l'état de l'intégration dans la base de données, enregistrer le compte bancaire lié s'il existe, et afficher une page HTML de confirmation.

Cas d'utilisation

  • Confirmation après avoir terminé l'intégration Stripe Connect
  • Détection des exigences en attente après le retour de Stripe
  • Mise à jour automatique du onboarding_status de l'entreprise
  • Enregistrement du stripe_bankaccount si un compte bancaire a été lié

Flux de validation

flowchart TD
A[Recevoir la requête - account_id, lang] --> B{Format de account_id valide ?}
B -->|Non - pas acct_...| C[400 STRIPE_ACCOUNT_ID_INVALID]
B -->|Oui| D[Récupérer le compte Stripe]
D --> E{Compte trouvé ?}
E -->|Non| F[404 STRIPE_ACCOUNT_NOT_FOUND]
E -->|Oui| G{Entreprise trouvée par stripe_account ?}
G -->|Non| H[404 CIA_NOT_FOUND]
G -->|Oui| I{Compte bancaire dans Stripe ?}
I -->|Oui| J[Sauvegarder l'ID stripe_bankaccount]
I -->|Non| K[Continuer]
J --> K
K --> L{requirements.currently_due vide ?}
L -->|Oui| M[status = completed + redirect_url]
L -->|Non| N[status = requirements_needed]
M --> O[Rendu du template HTML]
N --> O

Notes

  • Ne nécessite pas d'authentification (c'est un callback public de Stripe)
  • Le account_id doit commencer par acct_
  • lang contrôle la langue de la page HTML rendue (par défaut : es)
  • Met à jour payment_settings.onboarding_status et payment_settings.onboarding_last_update
  • S'il y a un compte banc

Request

Responses

Page HTML avec le résultat de l'intégration

Response Headers