Vai al contenuto

Pagamenti online (Stripe)

Il plugin Simple BnB Rental Pro consente di accettare pagamenti online tramite Stripe Checkout, un sistema sicuro e veloce che permette ai clienti di completare la prenotazione pagando direttamente con carta di credito, Apple Pay o Google Pay.

stripe pyments settings

1. Attivare i pagamenti online

Per abilitare Stripe nel plugin:

  1. Vai in Impostazioni → Pagamenti (Stripe).
  2. Attiva l’opzione Abilita pagamenti online (Stripe Checkout).
  3. Compila i campi richiesti (vedi sezione successiva).
  4. Salva le modifiche.

Da questo momento, al termine del modulo di prenotazione, gli utenti potranno procedere al pagamento direttamente tramite Stripe.

2. Configurare le chiavi Stripe

Per collegare il plugin al tuo account Stripe, servono due chiavi API:

  • Publishable key → inizia con pk_
  • Secret key → inizia con sk_

Puoi trovarle nel tuo dashboard Stripe in Developers → API keys.

Copia e incolla le due chiavi nei campi corrispondenti in Impostazioni → Pagamenti del plugin:

Campo Descrizione
Stripe publishable key Chiave pubblica per il front end.
Stripe secret key Chiave privata per le operazioni di pagamento.

💡 Suggerimento: se vuoi provare il sistema in modalità test, usa le chiavi della sezione Test data di Stripe. Quando sei pronto a ricevere pagamenti reali, sostituiscile con le chiavi Live.

3. Scelta del tipo di incasso

Puoi decidere se richiedere il totale dell’importo o soltanto un deposito al momento della prenotazione:

Opzione Descrizione
Totale L’utente paga subito l’intero importo.
Deposito (%) L’utente paga solo una percentuale dell’importo totale.
Deposito fisso (€) L’utente paga una quota fissa, indipendente dal totale.

Se scegli l’opzione “Deposito”, indica il valore (percentuale o importo fisso) nel campo dedicato.

4. Configurare il Webhook

Il webhook permette a Stripe di comunicare automaticamente al plugin l’esito del pagamento.

Non è strettamente obbligatorio, ma fortemente consigliato, perché garantisce che la prenotazione venga segnata come confermata anche in caso di ritardi o interruzioni durante il reindirizzamento dopo il pagamento.

Senza webhook, il plugin segna comunque la prenotazione come confermata subito dopo il ritorno dalla pagina di Stripe “Success”, ma il webhook aggiunge un livello di sicurezza e affidabilità in più.

Come configurarlo

  1. Accedi al tuo dashboard Stripe.
  2. Vai su Developers → Webhooks.
  3. Clicca su Add endpoint (Aggiungi endpoint).
  4. Inserisci l’URL del webhook, nel formato: 
https://tuodominio.com/wp-json/simpbnb/v1/stripe/webhook

(sostituisci tuodominio.com con l’indirizzo del tuo sito)

  1. Nella sezione Events to send, seleziona checkout.session.completed.

  2. Clicca su Add endpoint per salvare.

Stripe ti mostrerà un valore chiamato Signing secret (inizia con whsec_). Copia quel codice e incollalo nel campo Stripe webhook signing secret nelle impostazioni del plugin.

5. Pagine di successo e annullamento

Quando un utente completa (o annulla) il pagamento, Stripe lo reindirizza automaticamente alle pagine che hai indicato.

Nelle impostazioni Stripe del plugin troverai questi campi:

Campo Descrizione
Success page Pagina mostrata dopo un pagamento riuscito. È la pagina che contiene lo shortcode [simpbnb_success]
Cancel page Pagina mostrata se l’utente annulla o abbandona il pagamento. Qui metterai lo shortcode [simpbnb_cancel]
“Back to search” link Link di ritorno mostrato nella pagina di annullamento (es. alla pagina di prenotazione).
“Contact us” link Link verso una pagina di contatto o assistenza.

Occorre creare le due pagine WordPress dedicate, una per il successo e una per la cancellazione, in modo da personalizzare i messaggi per i clienti e inserire gli shortcode.

6. Flusso di pagamento

Ecco come avviene il processo quando Stripe è attivo:

  1. L’utente compila il modulo di prenotazione sul tuo sito.
  2. Viene reindirizzato a Stripe Checkout per completare il pagamento.
  3. Stripe elabora la transazione.
  4. All’esito positivo, Stripe invia la conferma al plugin tramite il webhook (se configurato).
  5. La prenotazione cambia automaticamente stato in Confermata.
  6. Le email di conferma vengono inviate a gestore e cliente.

7. Modalità di test

Puoi provare l’intero flusso di pagamento senza usare carte reali.

  1. Attiva la modalità test in Stripe.
  2. Usa le chiavi di test (pk_test_... e sk_test_...).
  3. Esegui una prenotazione sul tuo sito e, al momento del pagamento, inserisci una carta di prova, ad esempio: 
numero carta: 4242 4242 4242 4242
data scadenza: es. 12/30 (o qualsiasi data futura)
CVC: es. 123

Il sistema simulerà un pagamento riuscito e potrai verificare che tutto funzioni correttamente prima di passare in modalità reale.

8. Note finali

  • Tutte le transazioni sono gestite in modo sicuro da Stripe; nessun dato della carta viene salvato sul tuo sito.
  • Puoi gestire rimborsi, ricevute e imposte direttamente dal tuo account Stripe.
  • Assicurati che la valuta configurata nel plugin corrisponda a quella impostata nel tuo account Stripe.

Con queste impostazioni, il tuo sito sarà pronto a ricevere pagamenti online in modo semplice, sicuro e professionale.