Configurazione Stripe
Come collegare Stripe a Hotely — onboarding, indicatori di stato, dove vedere incassi e bonifici con le date di Stripe, come entrare nel tuo conto Stripe Express e perché i fondi vanno direttamente a te.
Perché Stripe
Hotely utilizza Stripe come processore di pagamento per i pagamenti online delle prenotazioni dirette. 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.
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 crea la sessione di pagamento e Stripe porta i fondi direttamente sul tuo conto, trattenendo la sola commissione piattaforma sulle prenotazioni dirette.
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 sulla pagina di prenotazione (o paga con un link di pagamento)
- 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, in attesa per i giorni previsti dal programma bonifici del tuo conto
- Quando diventano disponibili, Stripe li versa da solo sul tuo conto bancario con un bonifico automatico
Hotely legge saldo, incassi e bonifici del tuo conto per mostrarteli (vedi sotto), ma non può spostare né prelevare i tuoi fondi.
Dove sono i soldi: Incassi Stripe
Quando un ospite paga, l'incasso arriva subito sul tuo conto Stripe ma resta in attesa: è la regola di Stripe, uguale per tutti, non un problema del pagamento. Per esempio, con il programma «ogni giorno, 7 giorni dopo l'incasso» un pagamento del 30 ottobre diventa disponibile il 6 novembre e parte con il bonifico di quel giorno. Il programma del tuo conto lo decide Stripe, e Hotely lo legge e te lo mostra.
Il riquadro Incassi Stripe è in Operatività → Pagamenti di ogni struttura (con il conto che incassa per quella struttura) e in Impostazioni → Pagamenti (con il tuo conto). Mostra:
| Voce | Cosa vuol dire |
|---|---|
| In attesa | Incassato, trattenuto da Stripe fino al giorno indicato («disponibile dal») |
| Disponibile | Sul saldo, parte con il prossimo bonifico automatico |
| Verso la banca | Bonifici creati o partiti, non ancora arrivati |
| Prossimo bonifico | Giorno e importo previsti dal programma del conto |
Per ogni incasso vedi la prenotazione e l'ospite, il lordo pagato, la commissione di Stripe, la commissione Hotely, il netto e dove sono i soldi adesso: in attesa fino al giorno X, disponibile, bonifico in preparazione, in viaggio (con la data d'arrivo indicata da Stripe), accreditato, oppure bonifico fallito con il motivo. Sotto trovi i bonifici con stato, data d'arrivo in banca e IBAN di destinazione (ultime cifre).
Tutte le date vengono da Stripe. L'unica che Hotely calcola è il giorno previsto del bonifico di un incasso ancora in attesa, applicando il programma del tuo conto: è sempre indicata come «prevista», e appena Stripe crea il bonifico compare la sua data d'arrivo.
Se più strutture incassano sullo stesso conto Stripe, il saldo e i bonifici sono uno solo per tutte: nella pagina di una struttura vedi i suoi incassi, mentre gli altri movimenti del conto sono riassunti in una riga.
Nell'app mobile gli stessi dati sono nella sezione Incassi, con la scelta fra il tuo conto e le strutture di cui gestisci i pagamenti. Quando un bonifico arriva in banca o non riesce, ricevi una notifica.
Puoi anche chiederlo a Hotely Advance: «quando arrivano i soldi degli incassi online?» risponde con importi, commissioni e date lette su Stripe in quel momento.
Entrare nel tuo conto Stripe
Il conto che Hotely crea per te è un conto Stripe Express. Non si apre da dashboard.stripe.com: si entra da connect.stripe.com/express_login con l'email del titolare (Stripe manda un codice via SMS), oppure con il pulsante «Apri il conto Stripe» nel riquadro Incassi Stripe, che apre il conto direttamente. Il pulsante funziona solo per il titolare del conto, perché da lì si può cambiare anche l'IBAN dei bonifici; gli altri membri del team vedono gli incassi in Hotely ma non entrano nel conto.
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
Apri la struttura e vai su Operatività → Pagamenti, riquadro Collegamento Stripe. Clicca su "Collega Stripe". Verrai reindirizzato alla pagina di onboarding di Stripe.
Passo 2 — Completa il conto Stripe Express
Hotely crea per te un conto Stripe Express dedicato agli incassi delle prenotazioni. Se hai già un account Stripe puoi usare la stessa email e Stripe ti propone i dati già salvati, ma il conto per Hotely resta separato. 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
Senza Stripe la prenotazione diretta funziona con alcune limitazioni (e i pagamenti restano un elemento bloccante della prontezza al lancio):
| 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, oppure Nexi se incassi con il tuo contratto Nexi.
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
Stripe applica le proprie commissioni di elaborazione, secondo il listino del tuo account (variano per carte europee, extra-europee e aziendali); le trovi nella dashboard di Stripe. Hotely non aggiunge ricarichi sulle commissioni di Stripe.
Sulle prenotazioni dirette pagate online Hotely trattiene la commissione piattaforma dell'1,5%; sulle prenotazioni dei portali nessuna. Dettagli ed esempi in Commissioni e fee.
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? Hotely crea sempre un conto Stripe Express dedicato. Con la stessa email Stripe ti ripropone i dati già verificati, quindi l'onboarding è più rapido, ma il saldo e i bonifici di questo conto sono separati da quelli dell'altro.
L'ospite ha pagato ma su Stripe non vedo niente: perché? Quasi sempre per uno di due motivi. Il primo: stai guardando dashboard.stripe.com, mentre il conto di Hotely è Express e si apre da connect.stripe.com/express_login (o dal pulsante «Apri il conto Stripe»). Il secondo: l'incasso è in attesa, cioè sul conto ma non ancora bonificabile; in Incassi Stripe vedi il giorno da cui è disponibile e quello previsto per il bonifico.
Quando arrivano i soldi in banca? Dipende dal programma bonifici del tuo conto Stripe, che vedi in Incassi Stripe (per esempio «ogni giorno, 7 giorni dopo l'incasso»). La data d'arrivo esatta la fissa Stripe quando crea il bonifico, e compare accanto al bonifico.
Posso collegare lo stesso account Stripe a più proprietà? Sì. Un singolo account Stripe può ricevere pagamenti da più proprietà configurate in Hotely. Se le strutture appartengono a titolari diversi (ad esempio appartamenti in gestione), ognuna può avere il proprio account.
Posso fare i rimborsi dalla dashboard di Stripe? Emetti i rimborsi sempre da Hotely: un rimborso fatto direttamente su Stripe non viene riportato sulla prenotazione. Vedi Rimborsi e dispute.
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 crea le sessioni di pagamento e legge saldo, incassi e bonifici per mostrarteli, ma non può prelevare né spostare i fondi del tuo conto Stripe.