Guida / Pagamenti

Configurare Stripe

Aggiornato il 2026-10-01

Impostazioni → Integrazioni → Pagamenti → Stripe

Con Stripe accetti carte di credito, Apple Pay e Google Pay nel tuo widget di prenotazione e in ogni link di pagamento che BedFlow invia. Non servono conoscenze tecniche: bastano mezz'ora e i dati della tua azienda a portata di mano.

Un solo provider di carte alla volta. Per ogni struttura scegli Stripe oppure Mollie, non entrambi. Bancontact / WERO può restare attivo insieme all'uno o all'altro. Non sai quale scegliere? Leggi Configurare Mollie.

Cosa chiede Stripe quando ti registri (e cosa compilare)

Durante la registrazione Stripe pone una serie di domande per conoscere la tua attività. È obbligatorio presso ogni istituto di pagamento in Europa. Ecco cosa significano:

Stripe chiede Cosa compili
Tipo di attività Ditta individuale o società, come registrata presso la Banca-Crocevia delle Imprese (KBO). È possibile registrarsi anche come privato, ma in tal caso valgono limiti più bassi
Numero d'impresa / partita IVA Il tuo numero KBO (BE 0xxx.xxx.xxx)
Cosa vendi? (settore) Travel & lodging → Hotels, inns & resorts (oppure Vacation rentals per una casa vacanze)
Descrizione del prodotto Basta una frase: "Affitto di alloggi per vacanze con pernottamento, pagamento di acconto e saldo."
Sito web L'URL del tuo sito BedFlow o del tuo sito personale
Conto bancario (IBAN) Dove Stripe accredita i tuoi incassi
Statement descriptor Il nome che l'ospite vede sull'estratto conto della carta. Usa qui il nome del tuo alloggio, non quello della tua azienda, altrimenti avrai contestazioni inutili
Verifica dell'identità (KYC) Una foto della tua carta d'identità o del passaporto + un selfie. Richiesta per legge, si fa nel browser e richiede pochi minuti

Non ti serve un ambiente di test. Ogni account Stripe ha una modalità test, ma serve agli sviluppatori. Inserisci semplicemente i tuoi dati reali e completa l'attivazione; il tuo account è allora in modalità live e ricevi subito pagamenti reali.

Lungo il percorso Stripe può chiedere prove aggiuntive (una visura KBO, un certificato bancario). È normale e non blocca la registrazione. Nel frattempo puoi proseguire con il collegamento qui sotto; solo gli accrediti attendono il completamento della verifica.

Collegare Stripe a BedFlow

Incolli in BedFlow tre valori dalla tua dashboard di Stripe. Una volta che il tuo account Stripe è attivo:

  1. Recupera le chiavi. Dashboard di Stripe → Developers → API keys. Imposta l'interruttore in alto a destra su live (non test) e copia:
    • Publishable key: inizia con pk_live_
    • Secret key: inizia con sk_live_ (clicca "Reveal"; viene mostrata per intero una sola volta)
  2. Crea il webhook. Dashboard di Stripe → Developers → Webhooks → Add endpoint:
    • URL: https://bedflow.eu/webhooks/stripe-payment (BedFlow mostra lo stesso URL nel campo URL del webhook (copialo in Stripe))
    • Eventi: checkout.session.completed, payment_intent.succeeded e payment_intent.payment_failed
    • Poi copia il Signing secret: inizia con whsec_
  3. Inseriscili in BedFlow. Vai su Impostazioni → Integrazioni, categoria Pagamenti, e clicca Configura sul riquadro di Stripe. Attiva Attiva Stripe e incolla i tre valori in 1. Publishable key, 2. Secret key e 3. Webhook secret. Clicca Salva.

Il riquadro resta su Impostazioni incomplete finché manca la Publishable key o la Secret key. Solo quando passa a Collegato un ospite può davvero pagare con esso.

Il webhook è l'elemento che dice a BedFlow che un pagamento è stato effettuato. Senza un webhook secret l'ospite paga comunque, ma da parte tua la sua prenotazione resta in "in attesa di pagamento". Anche il riquadro ti avvisa di questo.

Verificare che funzioni

Fai una prenotazione di prova sulla tua pagina di prenotazione per un piccolo importo e pagala con una carta reale. Dovresti vedere:

  • il pagamento nella tua dashboard di Stripe, in Payments;
  • lo stesso pagamento in BedFlow, in Giornaliero → Pagamenti, entro pochi secondi;
  • la prenotazione che si segna come pagata e l'e-mail di conferma che parte.

Se la prenotazione resta in "in attesa di pagamento" mentre Stripe mostra il denaro, l'errore sta quasi sempre nel passaggio 2: un URL sbagliato, un evento mancante o il signing secret di un altro endpoint. In Webhooks su Stripe vedi per ogni tentativo se ha ricevuto un 200.

Puoi poi semplicemente rimborsare l'importo da Stripe.

Quanto costa?

Per ogni pagamento riuscito Stripe addebita una commissione che dipende dal tipo di carta e dal paese della carta; le carte extraeuropee e Amex costano di più. Consulta le tariffe attuali sul sito di Stripe. BedFlow non aggiunge nulla: colleghi il tuo account Stripe e il denaro va direttamente sul tuo conto bancario.

Domande frequenti

Posso passare da Stripe a Mollie? Sì. Nel riquadro di Stripe disattiva Attiva Stripe e salva, poi attiva Mollie. Vedi Configurare Mollie.

Posso addebitare il saldo di un ospite di Booking.com sulla sua carta? Sì, al check-out, per le prenotazioni arrivate tramite un canale, a condizione che il tuo account Stripe sia collegato e che la carta del canale sia stata memorizzata presso Stripe. Quest'ultima parte la configura il supporto per te, una volta sola. Vedi Gestione dei pagamenti per canale.

Correlati

← Torna alla categoria