Pagamenti online & Stripe
La versione Pro di Simple Bike Rental permette di accettare pagamenti online tramite Stripe. Il sistema è progettato per essere semplice, affidabile e conforme agli standard di sicurezza di Stripe.
Dopo aver attivato la versione Pro, puoi configurare il sistema di pagamento online andando nelle impostazioni del plugin in Biciclette → Impostazioni.
Qui troverai i seguenti campi:
Vediamoli uno per uno.
Abilitare i pagamenti online
Abilita questa opzione per attivare i pagamenti online. Quando questa opzione è attiva:
- l’utente deve completare il pagamento Stripe per confermare la prenotazione;
- la prenotazione rimane "In attesa" finché Stripe non conferma il pagamento;
- il modulo frontend mostra il pulsante "Paga ora".
Se disattivi questa opzione:
- le prenotazioni vengono confermate tramite email (sistema dei token);
- Stripe non viene coinvolto nel processo.
Abilitare i pagamenti parziali
La versione Pro di Simple Bike Rental consente di abilitare il pagamento parziale del noleggio. Questa funzione permette ai clienti di pagare solo un acconto online, invece dell'intero importo.
- Se attivo, il cliente potrà pagare solo una parte dell'importo totale al momento della prenotazione.
- Se disattivo, verrà richiesto il pagamento completo, come nel comportamento standard.
Tipo di pagamento parziale
Definisce il tipo di pagamento parziale da applicare.
Opzioni disponibili:
- Percentage: l'acconto viene calcolato come percentuale del totale.
- Fixed amount: l'acconto è un importo fisso.
Valore del pagamento parziale
Specifica il valore dell'acconto in base al tipo selezionato.
- Se è impostato su Percentage, inserire un valore da 1 a 100 (es. 20 = 20% del totale).
- Se è impostato su Fixed amount, inserire un importo maggiore di zero.
Abilitare il noleggio di accessori (opzionale)
Se attivo, il modulo di prenotazione mostra gli eventuali accessori configurati (es. caschi, seggiolini, lucchetti) e li include nel totale.
Valuta di pagamento
Seleziona la valuta in cui vuoi ricevere i pagamenti.
Esempi:
- Euro (EUR)
- US Dollar (USD)
- altre valute supportate da Stripe
La valuta deve coincidere con quella configurata nel tuo account Stripe.
Posizione del simbolo della valuta
puoi scegliere dove visualizzare il simbolo della valuta , prima o dopo l'importo, direttamente dalle impostazioni del plugin.
Ciò rende la formattazione dei prezzi più accurata per i Paesi in cui il simbolo della valuta è posizionato dopo il numero (ad esempio: 100 zł), pur supportando formati come €100 o $100.
Metodi di pagamento aggiuntivi
Oltre alle carte di credito tradizionali, Simple Bike Rental Pro supporta due metodi aggiuntivi (se disponibili nel tuo account Stripe):
✔ Stripe BLIK
Consente agli utenti polacchi di pagare con BLIK. Usa lo stesso Webhook dei pagamenti normali, quindi non richiede configurazioni aggiuntive.
✔ Stripe Przelewy24 (P24)
Consente pagamenti tramite P24 (molto diffusi in Polonia). Anche in questo caso il Webhook è lo stesso.
Nota: questi metodi richiedono che tu li abbia abilitati anche nella dashboard Stripe.
Pagina di pagamento
La pagina in cui verrà visualizzato il riepilogo della prenotazione, insieme al pulsante di pagamento.
In questa pagina, è necessario inserire lo shortcode:
Crea una nuova pagina "Pagamento" e inserisci lo shortcode al suo interno.
Pagina di ringraziamento post-pagamento
La pagina visualizzata dall'utente dopo un pagamento andato a buon fine. In questa pagina è necessario inserire lo shortcode:
Crea una nuova pagina, ad esempio "Pagamento confermato" , e inserisci al suo interno lo shortcode.
Chiave pubblica/segreta Stripe
La chiave pubblica del tuo account Stripe viene utilizzata per avviare il processo di pagamento. La chiave segreta viene utilizzata per comunicare con Stripe in modo sicuro.
Puoi trovarlo nella dashboard di Stripe, nella sezion Sviluppatori → API Keys
Chiave segreta del webhook Stripe
La chiave segreta per il webhook, necessaria per ricevere le conferme di pagamento da Stripe. Puoi ottenerla creando un webhook nella dashboard di Stripe, in Developers → Webhook.
Il webhook Stripe consente al tuo sito web di ricevere una notifica quando un pagamento è stato completato con successo.
Sebbene Simple Bike Rental Pro funzioni anche senza abilitare il webhook, consigliamo vivamente di attivarlo. Perché?
Perché in rari casi, ad esempio quando si verifica un errore durante il reindirizzamento da Stripe al tuo sito, la prenotazione potrebbe non aggiornarsi correttamente, anche se il pagamento è andato a buon fine. Questo potrebbe lasciare la prenotazione nello stato "pagamento in sospeso".
Abilitando il webhook, ti assicuri che:
- La prenotazione viene automaticamente contrassegnata come confermata una volta che Stripe elabora il pagamento.
- Le notifiche e-mail vengono inviate ugualmente anche se il re-indirizzamento al sito dovesse fallire.
- Maggiore affidabilità e precisione nella gestione delle prenotazioni.
Crea il nuovo webhook in Stripe Dashboard → Developers → Webhooks → + Add endpoint :
1 – Copia l'URL del webhook
Sostituire yourdomain.com con il tuo dominio effettivo.*
2 – Accedi alla tua dashboard Stripe
- Vai su dashboard.stripe.com.
- Seleziona il progetto utilizzato per il tuo plugin.
- Dalla barra laterale sinistra, vai su Sviluppatori → Webhook.
3 – Crea un nuovo endpoint
- Fare clic su "Aggiungi endpoint".
- Incolla l'URL del webhook copiato nel passaggio 1.
- In Eventi da inviare, seleziona solo: checkout.session.completed
- Fare clic su "Aggiungi endpoint" per salvare.
4 – Copia il segreto del webhook
Una volta creato l'endpoint, Stripe ti mostrerà la chiave segreta.
- Copiala.
- Torna alla dashboard di WordPress e vai alle impostazioni del plugin
- Incolla la chiave segreta nel campo Stripe Webhook Secret.
- Salva le impostazioni.
5 – Testare l’integrazione
Effettua una prenotazione di prova e completa il pagamento. Verifica che:
- La prenotazione viene contrassegnata come completata nel pannello di amministrazione.
- L'utente viene reindirizzato alla pagina di ringraziamento.
- Stripe non rimuove più il webhook (finché il server restituisce HTTP 200).
Stripe disattiva automaticamente un webhook se il tuo server non risponde con un codice HTTP 200 alle notifiche Per questo è importante verificare che il plugin risponda correttamente quando Stripe invia gli eventi.
Come controllare che il tuo server risponde con HTTP 200
- Vai in Stripe → Developers → Webhooks.
- Clicca sull’endpoint che hai configurato.
- Troverai la sezione "Recent events":
- se tutto funziona, ogni evento mostrerà una spunta verde con scritto "200 OK";
- se c’è un problema vedrai messaggi come "500 error", "404 not found", "Endpoint unavailable", ecc.
- Puoi cliccare su ogni evento per vedere:
- la richiesta inviata da Stripe,
- la risposta del tuo server (incluso il codice HTTP).
- Se Stripe riceve ripetuti errori (es. 400, 404, 500), dopo alcuni tentativi disabilita automaticamente l’endpoint per evitare invii continui.
Finché la tua integrazione risponde correttamente con HTTP 200, Stripe continuerà a considerare il webhook attivo e valido.
Suggerimenti per la modalità di test
È possibile utilizzare la modalità di test Stripe con la scheda di test:
- Numero carta: 4242 4242 4242 4242
- Data di scadenza: qualsiasi data futura (es. 12/30)
- CVC: 3 cifre qualsiasi (es. 123)
Ecco tutto ciò che ti serve per impostare il pagamento online.
Errori comuni del webhook
Quando Stripe invia una notifica al tuo sito, si aspetta una risposta HTTP 200. Se il tuo server restituisce un errore, Stripe lo registra e dopo diversi tentativi potrebbe disattivare l’endpoint.
Ecco gli errori più frequenti e come risolverli.
404 – Endpoint not found
Cosa significa:
L’URL del webhook non esiste o non è raggiungibile.
Possibili cause:
- URL copiato male in Stripe
- plugin disattivato
- permalinks WordPress non funzionanti o endpoint bloccato da plugin di sicurezza
Soluzione: - ricopia l’endpoint corretto dalle impostazioni del plugin - salva di nuovo i permalink WordPress (Impostazioni → Permalink → Salva)
401 / 403 – Unauthorized / Forbidden
Cosa significa:
Stripe non ha accesso all’URL o viene bloccato.
Possibili cause:
- firewall dell’hosting (Aruba, SiteGround ecc.)
- plugin di sicurezza che bloccano richieste POST esterne
Soluzione:
- aggiungi gli IP di Stripe alla allowlist del tuo hosting & firewall
- disabilita momentaneamente plugin come Wordfence / iThemes Security per verificare
400 – Bad Request
Cosa significa:
Stripe riesce a raggiungere il tuo server, ma la richiesta viene interpretata come non valida.
Possibili cause:
- chiave webhook errata nel plugin
- payload mancante o incompatibile
Soluzione:
- ricopia la chiave segreta Webhook da Stripe → Developers → Webhooks → Endpoint → “Signing Secret”
Webhook deactivated (disattivato automaticamente da Stripe)
Cosa significa:
Stripe ha ricevuto troppi errori consecutivi.
Soluzione:
- risolvi l’errore nell’endpoint
Come verificare se tutto funziona correttamente
Vai in Stripe → Developers → Webhooks → Endpoint → Recent events:
- se vedi “200 OK” → tutto funziona
- se vedi errori → clicca sull’evento per leggere richiesta e risposta del server
Una volta che il tuo server risponde costantemente con 200, Stripe non disattiverà più il webhook.