Pular para o conteúdo principal

Register company as a customer in Stripe

POST 
/company/payment/register_stripe

Propósito​

Criar um cliente no Stripe para o usuário autenticado se ele ainda não tiver um registrado, e retornar o ID do cliente.

Objetivo​

Inicializar a relação entre o usuário da empresa e o Stripe, obtendo o ID stripe_customer necessário para todas as operações de pagamento subsequentes.

Casos de Uso​

  • Primeiro registro antes de configurar métodos de pagamento
  • Verificar se o usuário já está registrado no Stripe
  • Pré-requisito para assinaturas e pagamentos

Fluxo de Validação​

flowchart TD
  A[Receber Solicitação] --> B{Usuário autenticado?}
  B -->|Não| C[404 USER_NOT_FOUND]
  B -->|Sim| D{Usuário no BD?}
  D -->|Não| E[401 USER_NOT_FOUND]
  D -->|Sim| F{stripe_customer existe?}
  F -->|Sim| G[Retornar ID existente]
  F -->|Não| H[Criar cliente Stripe]
  H --> I{Criado com sucesso?}
  I -->|Não| J[401 STRIPE_ACCOUNT_NOT_CREATED]
  I -->|Sim| K[Salvar ID em user.payment_settings]
  K --> L[200 sucesso + stripe_customer]
  G --> L

Observações​

  • Requer autenticação JWT (bearerAuth)
  • Idempotente: se stripe_customer já existir, retorna o ID existente
  • Opera sobre o company_user, não sobre a empresa diretamente
  • Sem corpo (body) obrigatório

Request​

Responses​

Cliente Stripe registrado com sucesso ou já existente

Response Headers