Pular para o conteúdo principal

Stripe Connect Onboarding Callback

GET 
/company/payment/onboarding/return

Finalidade​

Endpoint de callback para o qual o Stripe redireciona a empresa após completar (ou tentar completar) o processo de onboarding do Stripe Connect.

Objetivo​

Atualizar o status do onboarding no banco de dados, registrar a conta bancária vinculada se existir, e exibir uma página HTML de confirmação.

Casos de Uso​

  • Confirmação após completar o onboarding do Stripe Connect
  • Detecção de requisitos pendentes após retornar do Stripe
  • Atualização automática do onboarding_status na empresa
  • Registro do stripe_bankaccount se uma conta bancária foi vinculada

Fluxo de Validação​

flowchart TD
  A[Receber Requisição - account_id, lang] --> B{account_id formato válido?}
  B -->|Não - não é acct_...| C[400 STRIPE_ACCOUNT_ID_INVALID]
  B -->|Sim| D[Buscar conta Stripe]
  D --> E{Conta encontrada?}
  E -->|Não| F[404 STRIPE_ACCOUNT_NOT_FOUND]
  E -->|Sim| G{Empresa encontrada por stripe_account?}
  G -->|Não| H[404 CIA_NOT_FOUND]
  G -->|Sim| I{Conta bancária no Stripe?}
  I -->|Sim| J[Salvar ID stripe_bankaccount]
  I -->|Não| K[Continuar]
  J --> K
  K --> L{requirements.currently_due vazio?}
  L -->|Sim| M[status = completed + redirect_url]
  L -->|Não| N[status = requirements_needed]
  M --> O[Renderizar template HTML]
  N --> O

Observações​

  • Não requer autenticação (é callback público do Stripe)
  • O account_id deve começar com acct_
  • lang controla o idioma da página HTML renderizada (padrão: es)
  • Atualiza payment_settings.onboarding_status e payment_settings.onboarding_last_update
  • Se houver conta bancária, atualiza payment_settings.stripe_bankaccount
  • Ret

Request​

Responses​

Página HTML com o resultado do onboarding

Response Headers