Passa al contenuto principale

Stripe Connect onboarding refresh callback

GET 
/company/payment/onboarding/refresh

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 pendenti 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 lista di campi pendenti (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 status = requirements_needed]
  I --> J[Salva nel DB]
  J --> K[Renderizza HTML con lista requisiti]

Note​

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

Request​

Responses​

Pagina HTML con i requisiti in sospeso dell'onboarding

Response Headers