Pular para o conteúdo principal

Get checkout URLs for subscription plans

GET 
/company/payment/urls

Gera URLs de sessão de checkout do Stripe para cada plano de assinatura disponível, prontas para redirecionar o usuário.

Objetivo​

Fornecer ao frontend os links diretos para o Stripe Checkout, para que a empresa possa selecionar e pagar por um plano de assinatura.

Casos de Uso​

  • Exibir cards de planos com botões Assinar
  • Redirecionar o usuário para o Stripe Checkout para completar o pagamento
  • Apresentar comparação dos planos disponíveis com seus preços

Fluxo de Validação​

flowchart TD
  A[Receber Requisição] --> B{Usuário autenticado?}
  B -->|Não| C[404 USER_NOT_FOUND]
  B -->|Sim| D{Empresa encontrada?}
  D -->|Não| E[401 CIA_NOT_FOUND]
  D -->|Sim| F[Buscar planos no BD]
  F --> G[Buscar preços no Stripe]
  G --> H[Criar sessões de Checkout por plano]
  H --> I[200 OK - Planos + URLs]

Observações​

  • Requer autenticação JWT (bearerAuth)
  • Se a empresa tiver stripe_customer, associa-o à sessão
  • Se não tiver stripe_customer, usa o email de invoice_data.email
  • A URL de retorno é fixa: ${HOST_FRONT}/admin/config
  • Modo de assinatura: subscription (não pagamento único)
  • Inclui client_reference_id com a referência da empresa

Request​

Responses​

Lista de planos com URLs de checkout do Stripe

Response Headers