Saltar al contenido principal

Stripe Connect onboarding refresh callback

GET 
/company/payment/onboarding/refresh

Endpoint de callback al que Stripe redirige cuando el enlace de onboarding ha expirado o cuando el proceso necesita ser retomado con información adicional.

Objective​

Actualizar los requisitos pendientes del onboarding en la base de datos y mostrar una página con los campos que la compañía debe completar.

Use Cases​

  • Enlace de onboarding expirado (>5 minutos)
  • Compañía que interrumpió el proceso y necesita retomarlo
  • Stripe detecta información incompleta o incorrecta
  • Mostrar lista de campos pendientes (currently_due, past_due)

Validation Flow​

flowchart TD
  A[Receive Request - account_id] --> B{account_id valid?}
  B -->|No| C[400 STRIPE_ACCOUNT_ID_INVALID]
  B -->|Yes| D[Fetch Stripe account]
  D --> E{Account found?}
  E -->|No| F[404 STRIPE_ACCOUNT_NOT_FOUND]
  E -->|Yes| G{Company found?}
  G -->|No| H[404 CIA_NOT_FOUND]
  G -->|Yes| I[Set status = requirements_needed]
  I --> J[Save to DB]
  J --> K[Render HTML with requirements list]

Notes​

  • No requiere autenticación (es callback público de Stripe)
  • Siempre establece onboarding_status = 'requirements_needed'
  • Para generar un nuevo enlace: llamar a GET /bank_account_link
  • Incluye currently_due, past_due y eventually_due en la plantilla
  • Retorna HTML, no JSON

Request​

Responses​

Página HTML con los requisitos pendientes del onboarding

Response Headers