Pagamenti online con Stripe

Integrando Stripe con DiveManager puoi accettare pagamenti con carta di credito direttamente dalla pagina di prenotazione pubblica. I clienti pagano online; i pagamenti vengono registrati automaticamente nelle prenotazioni.

Cos'è Stripe?

Stripe è una piattaforma di pagamento online usata da milioni di aziende nel mondo. DiveManager si integra con Stripe per gestire:

• Pagamenti online delle prenotazioni (checkout pubblico)
• Acquisto di pacchetti immersioni online
• Pagamenti di caparre online

Stripe gestisce la sicurezza dei dati della carta — DiveManager non vede mai i numeri di carta dei tuoi clienti.

Di cosa hai bisogno

Per configurare Stripe devi avere un account Stripe (gratuito da creare su stripe.com). Una volta creato e verificato l'account, ti servono tre valori:

Valore	Dove trovarlo	Descrizione
Chiave pubblicabile	Stripe Dashboard → Sviluppatori → Chiavi API	Inizia con pk_live_ (produzione) o pk_test_ (test)
Chiave segreta	Stripe Dashboard → Sviluppatori → Chiavi API	Inizia con sk_live_ (produzione) o sk_test_ (test). Non condividerla mai.
Segreto webhook	Stripe Dashboard → Sviluppatori → Webhook → dettaglio endpoint	Inizia con whsec_. Generato da Stripe quando configuri l'endpoint.

:::caution Usa prima la modalità test Prima di passare alla modalità live, configura Stripe con le chiavi di test (pk_test_ / sk_test_) e verifica che i pagamenti funzionino. Puoi usare la carta di test 4242 4242 4242 4242 con qualsiasi data futura e qualsiasi CVC. :::

Cos'è un webhook?

Un webhook è una notifica automatica che Stripe invia a DiveManager ogni volta che avviene un evento di pagamento — ad esempio quando un cliente completa un pagamento o quando un pagamento fallisce.

Senza webhook, DiveManager non saprebbe che il pagamento è andato a buon fine e non potrebbe confermare la prenotazione automaticamente. Il webhook è quindi obbligatorio per il corretto funzionamento dei pagamenti online.

DiveManager genera automaticamente l'URL del webhook per il tuo centro diving. Devi solo copiarlo in Stripe.

Configurazione passo per passo

Step 1 — Crea un account Stripe

Vai su stripe.com, registrati e completa la verifica dell'identità. Stripe richiede dati aziendali per attivare i pagamenti reali.

Step 2 — Ottieni le chiavi API

1. Accedi alla Stripe Dashboard.
2. Nel menu laterale, vai su Sviluppatori → Chiavi API.
3. Copia la Chiave pubblicabile e la Chiave segreta.

Step 3 — Incolla le chiavi in DiveManager

1. In DiveManager, vai su Impostazioni e scorri fino alla sezione Stripe.
2. Incolla la Chiave pubblicabile nel campo apposito.
3. Incolla la Chiave segreta nel campo apposito.
4. Clicca Salva — non ancora il webhook, ci arriviamo dopo.

Step 4 — Configura il webhook in Stripe

Dopo aver salvato le chiavi, DiveManager mostra il tuo URL webhook (es. https://iltuocentro.divemanager.it/api/webhooks/stripe). Questo URL è unico per il tuo centro.

1. Torna sulla Stripe Dashboard.
2. Vai su Sviluppatori → Webhook.
3. Clicca + Aggiungi endpoint.
4. Incolla l'URL webhook di DiveManager nel campo URL endpoint.
5. In Seleziona gli eventi, aggiungi almeno questi:
   • checkout.session.completed
   • payment_intent.succeeded
   • payment_intent.payment_failed
6. Clicca Aggiungi endpoint.
7. Stripe mostra il Segreto di firma dell'endpoint — copialo.

Step 5 — Incolla il segreto webhook in DiveManager

1. Torna in DiveManager, Impostazioni → Stripe.
2. Incolla il Segreto webhook nel campo apposito.
3. Clicca Salva.

Step 6 — Testa il flusso

1. Usa le chiavi di test (pk_test_ / sk_test_).
2. Vai sulla tua pagina di prenotazione pubblica e completa una prenotazione usando la carta di test 4242 4242 4242 4242.
3. Verifica che la prenotazione appaia confermata nella dashboard di DiveManager.
4. Quando tutto funziona, sostituisci le chiavi di test con quelle live (pk_live_ / sk_live_) e aggiorna il webhook con un nuovo endpoint live.

Indicatore di stato

Nella sezione Stripe di DiveManager trovi un indicatore che mostra se la configurazione è Attiva (tutte e tre le chiavi sono presenti) o Non configurata. Se l'indicatore è arancione, manca almeno una delle chiavi.

Domande frequenti

I pagamenti Stripe sostituiscono la cassa fisica? No. Stripe gestisce solo i pagamenti online (prenotazioni dal sito pubblico). I pagamenti al banco (contanti, carte POS) si registrano manualmente come sempre.

Ci sono commissioni extra da DiveManager? No. DiveManager non applica commissioni sui pagamenti. Paghi solo le commissioni standard di Stripe (tipicamente 1,5%–2,9% + una quota fissa per transazione, a seconda del piano).

Posso usare un diverso provider di pagamento? Al momento DiveManager supporta solo Stripe per i pagamenti online. Puoi sempre registrare pagamenti manuali con qualsiasi metodo.