Delete payment method
DELETE/company/payment/payment_method/:id
Objetivo
Eliminar permanentemente um método de pagamento (cartão) da conta Stripe da empresa.
Objetivo
Permitir a depuração do portfólio de métodos de pagamento removendo cartões obsoletos que não estão atualmente em uso.
Casos de Uso
- Remover um cartão expirado
- Remover um cartão adicionado por engano
- Depurar a lista de métodos de pagamento (máx. 10)
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{PM ativo em deliveries?}
J -->|Sim| K[401 PAYMENT_METHOD_IN_USE]
J -->|Não| L[Excluir do Stripe]
L --> M[200 success: true]
Observações
- Requer autenticação JWT (bearerAuth)
- Não pode ser excluído se estiver ativo em deliveries com
payment_intentpagos - Não pode ser excluído se for o método padrão (
is_default: true) - A exclusão no Stripe é permanente (não recuperável)
Request
Responses
- 200
- 401
- 404
- 500
Método de pagamento removido com sucesso
Response Headers
Empresa não encontrada, método inexistente ou em uso ativo
Response Headers
Usuário ou cliente Stripe não encontrado.
Response Headers
Erro ao excluir no Stripe