Enable or disable payments with Stripe
POST/company/payment/withStripe
Scopo
Abilita o disabilita l'integrazione dei pagamenti con Stripe per la società dell'utente autenticato.
Obiettivo
Concedere il controllo completo all'amministratore della società 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 -->|Sì| D{Società trovata?}
D -->|No| E[401 CIA_NOT_FOUND]
D -->|Sì| F[Imposta withStripe = enabled]
F --> G{enabled=true E nessun stripe_customer?}
G -->|Sì| H[Crea automaticamente cliente Stripe]
H --> I{Creazione OK?}
I -->|No| J[500 Errore]
I -->|Sì| K[Salva società]
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 soltanto 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