Accettare pagamenti online con Stripe
Collegare Stripe perché gli ospiti possano pagare online acconti e saldi. Spiega entrambi i modi di collegarsi, quali eventi webhook selezionare esattamente, il segreto di firma, come provare il pagamento con la modalità di test di Stripe e cosa controllare se una prenotazione pagata resta non pagata.
Ultimo aggiornamento: 18 novembre 2026
Gli ospiti pagano direttamente il campeggio. Il denaro passa dalla loro carta all'account Stripe del campeggio, e Campiamo non lo trattiene mai né applica alcuna commissione. Perché funzioni, l'account Campiamo deve essere collegato all'account Stripe, cosa che si fa una volta sola in Impostazioni → Pagamenti nel pannello di controllo.
Ci sono due modi per collegare Stripe. Ne basta uno.
| Stripe Connect | Le proprie chiavi Stripe | |
|---|---|---|
| Ideale se | Non si ha ancora un account Stripe, o si preferisce non toccare le impostazioni per sviluppatori | Si ha già un account Stripe che si vuole continuare a usare esattamente com'è |
| Configurazione | Fare clic su un pulsante e seguire la registrazione guidata di Stripe | Incollare due chiavi, aggiungere un webhook in Stripe, incollare un segreto di firma |
| Webhook | Niente da fare | Se ne configura uno (passaggi più sotto) |
| Dove va il denaro | Nel proprio account Stripe | Nel proprio account Stripe |
Se si preferisce usare PayPal, si trova nella stessa pagina delle impostazioni: vedere accettare pagamenti online con PayPal. Campiamo usa un solo fornitore di pagamenti per account, quindi è l'uno o l'altro.
Opzione 1: Stripe Connect
- Andare su Impostazioni → Pagamenti e scegliere Stripe Connect.
- Fare clic su Connetti account Stripe. Si viene portati su Stripe.
- Seguire i passaggi di Stripe. Verranno chieste informazioni sull'attività, sul conto bancario e una prova di identità. È un obbligo di legge di Stripe, non nostro, e i dati vanno soltanto a Stripe.
- Al termine, Stripe rimanda a Campiamo. Lo stato diventa attivo una volta che Stripe ha completato la verifica, il che spesso è immediato e a volte richiede un giorno o due.
L'account Stripe viene creato nel paese impostato per la struttura, quindi prima di iniziare conviene controllare che il paese sia corretto in Impostazioni → Dettagli. Il paese di un account Stripe non può essere cambiato in seguito.
Se lo stato indica che servono altre informazioni, fare di nuovo clic sul pulsante. Stripe mostrerà esattamente cosa manca.
Opzione 2: le proprie chiavi Stripe
Richiede circa dieci minuti. Si passerà tra due schede del browser: le impostazioni dei pagamenti di Campiamo e la dashboard di Stripe. I passaggi vanno eseguiti in quest'ordine, perché Campiamo ha bisogno del segreto di firma del passaggio 3 prima di poter salvare.
1. Copiare le chiavi API da Stripe
In Stripe, andare su Developers → API keys (Sviluppatori → Chiavi API). Assicurarsi di avere davanti le chiavi live, non quelle di test.
- La chiave pubblicabile inizia con
pk_live_ - La chiave segreta inizia con
sk_live_. Fare clic su Reveal (Rivela) per vederla.
Tenere aperta questa scheda.
2. Aggiungere il webhook in Stripe
Un webhook è il modo in cui Stripe comunica a Campiamo che un ospite ha pagato. Senza di esso gli ospiti possono pagare, ma le loro prenotazioni non verranno segnate come pagate.
-
In Campiamo, andare su Impostazioni → Pagamenti, scegliere Le tue chiavi Stripe e copiare Il tuo URL del webhook.
-
In Stripe, andare su Developers → Webhooks e fare clic su Add endpoint (Aggiungi endpoint; Stripe a volte lo chiama Add destination, Aggiungi destinazione).
-
Incollare l'URL.
-
Stripe chiede ora quali eventi inviare. Selezionare questi due:
checkout.session.completedcheckout.session.expired
Digitando
checkout.sessionnella casella di ricerca di Stripe compaiono entrambi, il che è più rapido che scorrere l'intero elenco. In Campiamo, un clic sul nome di un evento lo copia. -
Se Stripe chiede una versione dell'API, lasciare quella predefinita.
-
Salvare l'endpoint.
Cosa fanno questi due eventi. Il primo comunica a Campiamo che un ospite ha pagato, così la prenotazione viene confermata e parte l'email di conferma. Il secondo comunica a Campiamo che un ospite ha iniziato a pagare e ha rinunciato, così le date vengono liberate per qualcun altro.
Eventi facoltativi. Se si desidera che le carte rifiutate compaiano nel pannello di controllo, selezionare anche charge.failed e payment_intent.payment_failed. Non sono obbligatori, e si possono aggiungere all'endpoint in qualsiasi momento.
3. Copiare il segreto di firma
Sempre in Stripe, aprire l'endpoint appena creato. Sotto Signing secret (Segreto di firma), fare clic su Reveal e copiare il valore. Inizia con whsec_.
Questo segreto è ciò che permette a Campiamo di verificare che un messaggio provenga davvero da Stripe. È diverso dalla chiave segreta dell'API, e ogni endpoint webhook ha il proprio.
4. Salvare tutto in Campiamo
Di nuovo in Impostazioni → Pagamenti, incollare la chiave pubblicabile, la chiave segreta e il segreto di firma del webhook, poi salvare. Lo stato cambia per indicare che le chiavi sono configurate e attive.
5. Fare una prova
Fare una prenotazione reale sul proprio sito web per un importo ridotto, pagare con una carta reale e controllare che:
- la prenotazione risulti pagata nel pannello di controllo
- arrivi l'email di conferma
Poi rimborsare il pagamento dalla dashboard di Stripe. Stripe trattiene la commissione sulla carta in caso di rimborso, quindi conviene mantenere basso l'importo. Se si preferisce non pagare nulla, usare invece la modalità di test di Stripe. Le carte di prova come 4242 4242 4242 4242 funzionano solo con le chiavi di test, quindi vengono rifiutate finché sono inserite le chiavi live.
Provare con la modalità di test di Stripe
Usando le proprie chiavi Stripe si può eseguire l'intero pagamento senza denaro reale, inserendo per qualche minuto in Campiamo le chiavi di test di Stripe. Per Campiamo è indifferente quale serie di chiavi riceve: con le chiavi di test inserite, la pagina di pagamento si apre nella modalità di test di Stripe, le carte di prova di Stripe funzionano e non vengono addebitate commissioni sulle carte.
La modalità di test ha i propri endpoint webhook, separati da quelli live, quindi oltre alle due chiavi servono un endpoint in modalità di test e il relativo segreto di firma. Cambiare soltanto le chiavi e mantenere il segreto di firma live è l'errore abituale: il pagamento di prova va a buon fine su Stripe, ma Campiamo non riesce a verificare il messaggio e la prenotazione resta non pagata.
- In Stripe, passare alla modalità di test (l'interruttore in cima alla dashboard di Stripe, oppure la propria sandbox).
- Andare su Developers → Webhooks e aggiungere un endpoint esattamente come nel passaggio 2 più sopra: lo stesso Il tuo URL del webhook di Campiamo, con
checkout.session.completedecheckout.session.expiredselezionati. - Aprire il nuovo endpoint e copiarne il segreto di firma. È un valore
whsec_diverso da quello live. - Andare su Developers → API keys, sempre in modalità di test, e copiare la chiave pubblicabile di test (
pk_test_) e la chiave segreta di test (sk_test_). - In Campiamo, andare su Impostazioni → Pagamenti, incollare i tre valori di test al posto di quelli live e salvare.
- Fare una prenotazione sulla propria pagina di prenotazione e pagare con il numero di carta
4242 4242 4242 4242, una qualsiasi data di scadenza futura e un qualsiasi codice di tre cifre. La pagina delle carte di prova di Stripe elenca altri numeri per i rifiuti e per 3D Secure, se si vogliono provare anche quelli. - Controllare che la prenotazione risulti pagata nel pannello di controllo e che arrivi l'email di conferma.
- Reinserire la chiave pubblicabile live, la chiave segreta live e il segreto di firma live, e salvare. Poi eliminare le prenotazioni di prova, perché non restino nel calendario.
Finché sono inserite le chiavi di test, la pagina di prenotazione è in modalità di test per tutti. Un ospite reale che prenota in quell'intervallo non paga nulla di reale e riceve comunque una prenotazione confermata: conviene quindi farlo in un momento tranquillo e ripristinare subito le chiavi live. Un link di pagamento già inviato via email a un ospite con le chiavi live non si aprirà finché le chiavi live non vengono reinserite, perché quel pagamento appartiene al lato live dell'account Stripe.
La modalità di test non è disponibile con Stripe Connect, perché il collegamento riguarda soltanto l'account Stripe live. Se ci si è collegati in quel modo, fare la prova con una piccola prenotazione reale e rimborsarla, come nel passaggio 5 più sopra.
Acconti e saldi
Una volta collegato Stripe, il resto della pagina dei pagamenti stabilisce cosa viene addebitato agli ospiti e quando: un acconto in percentuale o di importo fisso, quanti giorni prima dell'arrivo è dovuto il saldo, se le prenotazioni dell'ultimo minuto devono pagare per intero e se si accetta anche il pagamento all'arrivo. I promemoria del saldo vengono inviati automaticamente. Nella stessa pagina si trova la politica di cancellazione, che può rimborsare automaticamente gli ospiti sulla loro carta quando annullano.
Se qualcosa non funziona
Un ospite ha pagato, ma la prenotazione risulta ancora non pagata. Quasi sempre è il webhook. In Stripe, aprire Developers → Webhooks, fare clic sull'endpoint e guardare le consegne recenti.
- Nessuna consegna. L'endpoint non è in ascolto di
checkout.session.completed. Modificare l'endpoint e aggiungerlo. - Consegne fallite con errore 400. Il segreto di firma in Campiamo non corrisponde a questo endpoint. Rivelare di nuovo il segreto in Stripe e salvarlo ancora in Campiamo. Una causa comune è aver copiato il segreto da un endpoint in modalità di test mentre si usano le chiavi live, o viceversa.
- Consegne fallite con errore 404. L'URL è sbagliato. Copiarlo di nuovo da Campiamo.
Una volta risolto, Stripe permette di inviare di nuovo una consegna fallita dalla stessa schermata, il che segnerà la prenotazione come pagata senza che l'ospite debba fare nulla.
Gli ospiti vedono un errore quando provano a pagare. Controllare che le chiavi siano chiavi live dello stesso account Stripe, e che l'account abbia completato la verifica di Stripe. Stripe mostra un banner nella dashboard se manca qualcosa.
Si vuole passare dalle proprie chiavi a Stripe Connect, o viceversa. Rimuovere prima il metodo attuale nella pagina dei pagamenti, poi configurare l'altro. Le prenotazioni esistenti e i pagamenti passati non subiscono modifiche.
In caso di difficoltà, contattarci indicando cosa compare nell'elenco delle consegne dell'endpoint in Stripe. Di solito basta a darci subito la risposta.
Ha ancora dubbi?
Se questa pagina non ha risposto alla sua domanda, è la nostra pagina a dover essere corretta. Ce lo faccia sapere.
Contattaci