Pular para o conteúdo principal

Set default payment method

POST 
/company/payment/default_payment_method/:id

Designa um método de pagamento existente como o padrão para todas as operações de pagamento futuras da empresa.

Objetivo​

Atualizar payment_settings.default_payment_method na empresa para que os pagamentos de entregas sejam processados com esse cartão.

Casos de Uso​

  • Selecionar o cartão principal após adicionar um novo
  • Alterar o método padrão após renovar um cartão
  • Designar um método ativo antes de processar uma entrega

Fluxo de Validação​

flowchart TD
  A[Receber Solicitação - id] --> 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{stripe_customer existe?}
  F -->|Não| G[404 STRIPE_CUSTOMER_NOT_FOUND]
  F -->|Sim| H{PM pertence ao cliente?}
  H -->|Não| I[401 PAYMENT_METHOD_NOT_FOUND]
  H -->|Sim| J[Definir como default_payment_method]
  J --> K[Salvar empresa]
  K --> L[200 success: true]

Observações​

  • Requer autenticação JWT (bearerAuth)
  • Apenas um método pode ser o padrão por vez
  • A validação de propriedade verifica se o PM pertence ao stripe_customer da empresa
  • A alteração é imediata e se aplica aos próximos pagamentos de entrega

Request​

Responses​

Método de pagamento definido como padrão

Response Headers