Enable or disable payments with Stripe
POST/company/payment/withStripe
Objetivo
Habilita ou desabilita a integração de pagamentos com Stripe para a empresa do usuário autenticado.
Objetivo
Dar controle total ao administrador da empresa sobre se os pagamentos eletrônicos estão ativos, com criação automática do cliente Stripe se ativado pela primeira vez.
Casos de Uso
- Ativar o Stripe pela primeira vez para começar a receber pagamentos
- Desabilitar temporariamente os pagamentos eletrônicos
- Reativar pagamentos após um período de inatividade
Fluxo de Validação
flowchart TD
A[Receber Solicitação - enabled] --> 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[Definir withStripe = enabled]
F --> G{enabled=true E sem stripe_customer?}
G -->|Sim| H[Criar cliente Stripe automaticamente]
H --> I{Criado com sucesso?}
I -->|Não| J[500 Error]
I -->|Sim| K[Salvar empresa]
G -->|Não| K
K --> L[200 success: true]
Observações
- Requer autenticação JWT (bearerAuth)
- Se
enabled=truee não existirstripe_customer, cria automaticamente usandoinvoice_data.email - Se
enabled=false, apenas desabilita sem excluir o cliente Stripe nem os métodos de pagamento
Request
Responses
- 200
- 401
- 404
- 500
Configuração do Stripe atualizada
Response Headers
Empresa não encontrada
Response Headers
Usuário não encontrado
Response Headers
Erro ao criar cliente Stripe ou salvar configuração