Enable or disable Stripe payments
POST/company/payment/withStripe
Abilita o disabilita l'integrazione dei pagamenti con Stripe per l'azienda dell'utente autenticato.
Obiettivo
Concedere il controllo totale all'amministratore dell'azienda sull'attivazione dei pagamenti elettronici, con creazione automatica del cliente Stripe se attivato per la prima volta.
Casi d'Uso
- Attivare Stripe per la prima volta per iniziare a ricevere pagamenti
- Disabilitare temporaneamente i pagamenti elettronici
- Riattivare i pagamenti dopo un periodo di inattività
Flusso di Validazione
flowchart TD
A[Ricevi Richiesta - enabled] --> B{Utente autenticato?}
B -->|No| C[404 USER_NOT_FOUND]
B -->|Si| D{Azienda trovata?}
D -->|No| E[401 CIA_NOT_FOUND]
D -->|Si| F[Imposta withStripe = enabled]
F --> G{enabled=true E nessun stripe_customer?}
G -->|Si| H[Crea automaticamente cliente Stripe]
H --> I{Creazione OK?}
I -->|No| J[500 Errore]
I -->|Si| K[Salva azienda]
G -->|No| K
K --> L[200 success: true]
Note
- Richiede autenticazione JWT (bearerAuth)
- Se
enabled=truee non esistestripe_customer, lo crea automaticamente utilizzandoinvoice_data.email - Se
enabled=false, disabilita solo senza eliminare il cliente Stripe né i metodi di pagamento
Request
Responses
- 200
- 401
- 404
- 500
Configurazione di Stripe aggiornata
Response Headers
Società non trovata
Response Headers
Utente non trovato
Response Headers
Errore nella creazione del cliente Stripe o nel salvataggio della configurazione