Saltar al contenido principal

Callback de retorno del onboarding de Stripe Connect

GET 
/company/payment/onboarding/return

Purpose​

Endpoint de callback al que Stripe redirige a la compañía tras completar (o intentar completar) el proceso de onboarding de Stripe Connect.

Objective​

Actualizar el estado del onboarding en la base de datos, registrar la cuenta bancaria vinculada si existe, y mostrar una página HTML de confirmación.

Use Cases​

  • Confirmación tras completar el onboarding de Stripe Connect
  • Detección de requisitos pendientes tras retornar de Stripe
  • Actualización automática de onboarding_status en la compañía
  • Registro de stripe_bankaccount si se vinculó una cuenta bancaria

Validation Flow​

flowchart TD
  A[Receive Request - account_id, lang] --> B{account_id valid format?}
  B -->|No - not acct_...| 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 by stripe_account?}
  G -->|No| H[404 CIA_NOT_FOUND]
  G -->|Yes| I{Bank account in Stripe?}
  I -->|Yes| J[Save stripe_bankaccount ID]
  I -->|No| K[Continue]
  J --> K
  K --> L{requirements.currently_due empty?}
  L -->|Yes| M[status = completed + redirect_url]
  L -->|No| N[status = requirements_needed]
  M --> O[Render HTML template]
  N --> O

Notes​

  • No requiere autenticación (es callback público de Stripe)
  • El account_id debe comenzar con acct_
  • lang controla el idioma de la página HTML renderizada (default: es)
  • Actualiza payment_settings.onboarding_status y payment_settings.onboarding_last_update
  • Si hay cuenta bancaria, actualiza payment_settings.stripe_bankaccount
  • Retorna HTML, no JSON

Request​

Responses​

Página HTML con el resultado del onboarding

Response Headers