Configurazione Stripe
Come collegare il tuo account Stripe al booking engine di Hotely tramite Stripe Connect — onboarding passo-passo, indicatori di stato, modalità test e live, e perché i fondi vanno direttamente sul tuo conto.
Perché Stripe
Hotely utilizza Stripe come processore di pagamento per tutte le transazioni del booking engine. Stripe è la piattaforma di pagamento utilizzata da milioni di aziende in tutto il mondo, con copertura in oltre 40 paesi, supporto per tutte le principali carte di credito e debito, e standard di sicurezza PCI DSS di livello 1.
La scelta di Stripe non è casuale. A differenza dei sistemi tradizionali che fungono da intermediari nei pagamenti — trattenendo i fondi e rilasciandoli alla struttura con ritardi di giorni o settimane — Hotely utilizza Stripe Connect in modalità diretta. Questo significa che i fondi delle prenotazioni vanno direttamente sul tuo account Stripe, senza passare per conti intermedi di terze parti.
Il tuo denaro è sempre tuo. Hotely non lo tocca, non lo trattiene e non lo gestisce. Il booking engine si limita a creare la sessione di pagamento e lascia che Stripe gestisca il flusso finanziario direttamente verso il tuo conto.
Come funziona Stripe Connect
Stripe Connect è il sistema che permette a piattaforme come Hotely di offrire funzionalità di pagamento ai propri utenti senza gestire direttamente il denaro. Quando colleghi il tuo account Stripe a Hotely, stai autorizzando il booking engine a creare pagamenti per tuo conto — ma il destinatario dei fondi sei sempre tu.
Architettura dei pagamenti
Il flusso è trasparente:
- L'ospite completa il checkout nel booking engine
- Hotely crea una sessione di pagamento su Stripe per conto della tua struttura
- Stripe elabora il pagamento con la carta dell'ospite
- I fondi vengono accreditati direttamente sul tuo account Stripe
- Dal tuo account Stripe, i fondi vengono trasferiti automaticamente al tuo conto bancario secondo la schedulazione che hai configurato (tipicamente 2-7 giorni lavorativi)
In nessun momento Hotely ha accesso ai fondi o alla possibilità di trattenerli. Questa architettura ti dà il controllo completo sulle tue finanze.
Onboarding passo-passo
Prerequisiti
Per completare l'onboarding Stripe hai bisogno di:
- Un conto bancario intestato alla struttura (o al titolare)
- Un documento di identità del legale rappresentante
- Il codice fiscale o la partita IVA della struttura
- Circa 10-15 minuti per completare la procedura
Procedura di collegamento
Passo 1 — Avvia il collegamento
Dalla dashboard del booking engine, accedi a Proprietà → Impostazioni → Pagamenti. Clicca su "Collega Stripe". Verrai reindirizzato alla pagina di onboarding di Stripe.
Passo 2 — Crea o collega il tuo account Stripe
Se hai già un account Stripe, puoi collegarlo direttamente accedendo con le tue credenziali. Se non ne hai uno, Stripe ti guiderà nella creazione. Il processo include:
- Inserimento dei dati aziendali (ragione sociale, indirizzo, partita IVA)
- Verifica dell'identità del legale rappresentante
- Collegamento del conto bancario per i trasferimenti
Passo 3 — Completa la verifica
Stripe potrebbe richiedere documentazione aggiuntiva per completare la verifica (KYC — Know Your Customer). Questo è un requisito normativo e non dipende da Hotely. I documenti tipicamente richiesti includono:
| Documento | Quando richiesto | Note |
|---|---|---|
| Documento di identità | Sempre | Carta d'identità, passaporto o patente |
| Prova di indirizzo | Per alcune tipologie aziendali | Bolletta, visura camerale |
| Statuto societario | Per società | Solo se la forma giuridica lo richiede |
| Coordinate bancarie | Sempre | IBAN del conto destinatario |
Passo 4 — Torna alla dashboard
Dopo aver completato l'onboarding, verrai reindirizzato automaticamente alla dashboard di Hotely. Il sistema verificherà lo stato del collegamento e mostrerà gli indicatori di stato.
I tre indicatori di stato
Dopo il collegamento, la dashboard mostra tre indicatori che riflettono lo stato del tuo account Stripe:
| Indicatore | Significato | Impatto |
|---|---|---|
| Account collegato | L'account Stripe è stato collegato con successo a Hotely | Prerequisito per tutto il resto |
| Dettagli inviati | Hai completato l'invio di tutti i dati richiesti da Stripe | Senza questo passaggio, alcune funzionalità potrebbero essere limitate |
| Pagamenti attivi | Stripe ha verificato i tuoi dati e i pagamenti possono essere elaborati | Solo con questo indicatore attivo puoi ricevere pagamenti reali |
Cosa significa ogni stato
Tutti e tre verdi: il tuo account è pienamente operativo. Puoi ricevere pagamenti, emettere rimborsi e gestire dispute.
Collegato ma dettagli non completati: hai iniziato l'onboarding ma non l'hai terminato. Torna alla sezione Pagamenti e clicca su "Completa la configurazione Stripe" per riprendere da dove ti eri fermato.
Dettagli inviati ma pagamenti non attivi: Stripe sta ancora verificando i tuoi dati. Il processo di verifica richiede generalmente 24-48 ore. In alcuni casi, Stripe potrebbe richiedere documentazione aggiuntiva via email.
Cosa succede senza Stripe
Se non hai collegato Stripe, il booking engine funziona comunque con alcune limitazioni:
| Funzionalità | Senza Stripe | Con Stripe |
|---|---|---|
| Pubblicazione pagina di prenotazione | Disponibile | Disponibile |
| Ricerca disponibilità | Disponibile | Disponibile |
| Prenotazioni con pagamento online | Non disponibile | Disponibile |
| Garanzia carta di credito | Non disponibile | Disponibile |
| Prenotazioni "paga in struttura" | Disponibile | Disponibile |
| Rimborsi automatici | Non disponibile | Disponibile |
| Addebiti per no-show | Non disponibile | Disponibile |
In pratica, senza Stripe puoi accettare solo prenotazioni con pagamento in struttura (policy "Paga in struttura"). Tutte le altre policy di pagamento richiedono un account Stripe collegato e con pagamenti attivi.
Questa limitazione è intenzionale: non ha senso offrire all'ospite l'opzione di pagare online se non c'è un account in grado di ricevere il pagamento.
Modalità test vs modalità live
Stripe offre due ambienti separati:
Modalità test
La modalità test ti permette di simulare l'intero flusso di pagamento senza transazioni reali. Le carte di test di Stripe (come 4242 4242 4242 4242) funzionano esattamente come carte reali, ma nessun addebito viene effettuato.
Usa la modalità test per:
- Verificare che il flusso di checkout funzioni correttamente
- Testare le email di conferma con i dettagli di pagamento
- Provare le policy di cancellazione con rimborso
- Formare il personale sull'uso della dashboard pagamenti
Modalità live
La modalità live elabora transazioni reali con carte di credito reali. Attivala solo quando sei pronto a ricevere prenotazioni.
Il passaggio da test a live avviene dalla dashboard Stripe e non richiede interventi nella configurazione di Hotely. Il booking engine rileva automaticamente la modalità dell'account collegato.
Commissioni di elaborazione
Stripe applica le proprie commissioni standard per l'elaborazione dei pagamenti. Le tariffe tipiche per l'area SEPA sono:
| Tipo di carta | Commissione |
|---|---|
| Carte europee | 1,4% + 0,25 EUR |
| Carte UK | 2,5% + 0,25 EUR |
| Carte internazionali | 2,9% + 0,25 EUR |
Queste commissioni sono addebitate direttamente da Stripe sul tuo account e sono visibili nella dashboard Stripe. Hotely non aggiunge alcun markup sulle commissioni di Stripe.
In aggiunta alle commissioni Stripe, Hotely applica una commissione piattaforma dell'1,5% sul transato di ogni prenotazione — senza canone mensile, senza moduli extra. L'1,5% include l'accesso completo a tutta la piattaforma: booking engine, website builder, agente AI, revenue management, analytics.
Per fare un confronto concreto: su una prenotazione da 200 EUR con carta europea, il costo totale è di circa 6,05 EUR (3 EUR Hotely + 3,05 EUR Stripe). La stessa prenotazione su un'OTA al 18% costerebbe 36 EUR — quasi 6 volte tanto.
Sicurezza e conformità
L'integrazione con Stripe garantisce:
- PCI DSS Livello 1 — il più alto standard di sicurezza per i pagamenti con carta. I dati delle carte non transitano mai per i server di Hotely
- 3D Secure — autenticazione forte del cliente (SCA) conforme alla direttiva PSD2 europea
- Tokenizzazione — i dati sensibili delle carte vengono sostituiti da token sicuri
- Crittografia TLS — tutte le comunicazioni sono protette con crittografia in transito
Domande frequenti
Posso usare un account Stripe esistente? Sì. Se hai già un account Stripe con verifica completata, il collegamento richiede pochi secondi.
Posso collegare lo stesso account Stripe a più proprietà? Sì. Un singolo account Stripe può ricevere pagamenti da più proprietà configurate in Hotely.
Cosa succede se Stripe richiede documentazione aggiuntiva? Stripe ti contatterà direttamente via email. Finché la documentazione non è completa, i pagamenti potrebbero essere temporaneamente sospesi. Completa la verifica il prima possibile per evitare interruzioni.
Hotely ha accesso ai miei fondi? No. Hotely non ha in nessun caso accesso ai fondi sul tuo account Stripe. Il collegamento tramite Stripe Connect autorizza solo la creazione di sessioni di pagamento, non la gestione dei fondi.