Passa al contenuto principale

Stripe Connect Onboarding Refresh Callback

GET 
/company/payment/onboarding/refresh

Scopo​

Endpoint di callback a cui Stripe reindirizza quando il link di onboarding è scaduto o quando il processo deve essere ripreso con informazioni aggiuntive.

Obiettivo​

Aggiornare i requisiti in sospeso dell'onboarding nel database e mostrare una pagina con i campi che la società deve completare.

Casi d'Uso​

  • Link di onboarding scaduto (>5 minuti)
  • Società che ha interrotto il processo e deve riprenderlo
  • Stripe rileva informazioni incomplete o errate
  • Mostrare l'elenco dei campi in sospeso (currently_due, past_due)

Flusso di Validazione​

flowchart TD
  A[Ricevi Richiesta - account_id] --> B{account_id valido?}
  B -->|No| 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{Società trovata?}
  G -->|No| H[404 CIA_NOT_FOUND]
  G -->|Sì| I[Imposta stato = requirements_needed]
  I --> J[Salva nel DB]
  J --> K[Renderizza HTML con elenco requisiti]

Note​

  • Non richiede autenticazione (è un callback pubblico di Stripe)
  • Imposta sempre onboarding_status = 'requirements_needed'
  • Per generare un nuovo link: chiamare GET /bank_account_link
  • Includere currently_due, past_due e eventually_due nel template
  • Restituisce HTML, non JSON

Request​

Responses​

Pagina HTML con i requisiti pendenti dell'onboarding

Response Headers