Pular para o conteúdo principal

Stripe Connect onboarding refresh callback

GET 
/company/payment/onboarding/refresh

Endpoint de callback para o qual o Stripe redireciona quando o link de integração expirou ou quando o processo precisa ser retomado com informações adicionais.

Objetivo​

Atualizar os requisitos pendentes da integração no banco de dados e exibir uma página com os campos que a empresa deve preencher.

Casos de Uso​

  • Link de integração expirado (>5 minutos)
  • Empresa que interrompeu o processo e precisa retomá-lo
  • Stripe detecta informações incompletas ou incorretas
  • Exibir lista de campos pendentes (currently_due, past_due)

Fluxo de Validação​

flowchart TD
  A[Receber Solicitação - account_id] --> B{account_id válido?}
  B -->|Não| 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?}
  G -->|Não| H[404 CIA_NOT_FOUND]
  G -->|Sim| I[Definir status = requirements_needed]
  I --> J[Salvar no BD]
  J --> K[Renderizar HTML com lista de requisitos]

Observações​

  • Não requer autenticação (é um callback público do Stripe)
  • Sempre define onboarding_status = 'requirements_needed'
  • Para gerar um novo link: chamar GET /bank_account_link
  • Inclui currently_due, past_due e eventually_due no template
  • Retorna HTML, não JSON

Request​

Responses​

Página HTML com os requisitos pendentes do onboarding

Response Headers