Pular para o conteúdo principal

Set up new payment method

POST 
/truckers/payment/setup_payment_method

Objetivo​

Gerar uma URL do portal do Stripe para que a empresa possa adicionar um novo método de pagamento (cartão de crédito/débito) de forma segura.

Objetivo Específico​

Redirecionar o usuário para o portal do Stripe, onde ele pode registrar suas informações de cartão sem expor dados sensíveis ao backend.

Casos de Uso​

  • Adicionar o primeiro cartão de crédito/débito
  • Adicionar métodos de pagamento adicionais (máx. 10)
  • Substituir cartões expirados por novos

Fluxo de Validação​

flowchart TD
  A[Receber Solicitação - returnUrl] --> B{returnUrl fornecido?}
  B -->|Não| C[400 MISSING_RETURN_URL]
  B -->|Sim| D{Usuário autenticado?}
  D -->|Não| E[404 USER_NOT_FOUND]
  D -->|Sim| F{Empresa encontrada?}
  F -->|Não| G[401 CIA_NOT_FOUND]
  F -->|Sim| H{stripe_customer existe?}
  H -->|Não| I[404 STRIPE_CUSTOMER_NOT_FOUND]
  H -->|Sim| J{Contagem < 10?}
  J -->|Não| K[200 - String vazia]
  J -->|Sim| L[Criar portal de métodos de pagamento]
  L --> M[200 - URL do portal]

Observações​

  • Requer autenticação JWT (bearerAuth)
  • Limite de 10 métodos de pagamento por empresa; se atingido, retorna `` (string vazia)
  • Requer que a empresa tenha stripe_customer (usar /register_stripe primeiro)
  • A returnUrl é para onde o Stripe redireciona o usuário após adicionar o método

Request​

Responses​

URL do portal ou string vazio se o limite de 10 for atingido

Response Headers