Passa al contenuto principale

Stripe Connect Onboarding Callback

GET 
/company/payment/onboarding/return

Scopo​

Endpoint di callback a cui Stripe reindirizza l'azienda dopo aver completato (o tentato di completare) il processo di onboarding di Stripe Connect.

Obiettivo​

Aggiornare lo stato dell'onboarding nel database, registrare il conto bancario collegato se presente e mostrare una pagina HTML di conferma.

Casi d'uso​

  • Conferma dopo il completamento dell'onboarding di Stripe Connect
  • Rilevamento di requisiti pendenti dopo il ritorno da Stripe
  • Aggiornamento automatico di onboarding_status nell'azienda
  • Registrazione di stripe_bankaccount se è stato collegato un conto bancario

Flusso di validazione​

flowchart TD
  A[Ricevi Richiesta - account_id, lang] --> B{account_id formato valido?}
  B -->|No - non acct_...| C[400 STRIPE_ACCOUNT_ID_INVALID]
  B -->|Sì| D[Recupera account Stripe]
  D --> E{Account trovato?}
  E -->|No| F[404 STRIPE_ACCOUNT_NOT_FOUND]
  E -->|Sì| G{Azienda trovata tramite stripe_account?}
  G -->|No| H[404 CIA_NOT_FOUND]
  G -->|Sì| I{Conto bancario in Stripe?}
  I -->|Sì| J[Salva ID stripe_bankaccount]
  I -->|No| K[Continua]
  J --> K
  K --> L{requirements.currently_due vuoto?}
  L -->|Sì| M[status = completed + redirect_url]
  L -->|No| N[status = requirements_needed]
  M --> O[Render template HTML]
  N --> O

Note​

  • Non richiede autenticazione (è un callback pubblico di Stripe)
  • L'account_id deve iniziare con acct_
  • lang controlla la lingua della pagina HTML renderizzata (default: es)
  • Aggiorna payment_settings.onboarding_status e payment_settings.onboarding_last_update
  • Se c'è un conto bancario, aggiorna

Request​

Responses​

Pagina HTML con il risultato dell'onboarding

Response Headers