Hotely Logo

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:

  1. L'ospite completa il checkout sulla pagina di prenotazione (o paga con un link di pagamento)
  2. Hotely crea una sessione di pagamento su Stripe per conto della tua struttura
  3. Stripe elabora il pagamento con la carta dell'ospite
  4. I fondi vengono accreditati direttamente sul tuo account Stripe, in attesa per i giorni previsti dal programma bonifici del tuo conto
  5. 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:

VoceCosa vuol dire
In attesaIncassato, trattenuto da Stripe fino al giorno indicato («disponibile dal»)
DisponibileSul saldo, parte con il prossimo bonifico automatico
Verso la bancaBonifici creati o partiti, non ancora arrivati
Prossimo bonificoGiorno 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:

DocumentoQuando richiestoNote
Documento di identitàSempreCarta d'identità, passaporto o patente
Prova di indirizzoPer alcune tipologie aziendaliBolletta, visura camerale
Statuto societarioPer societàSolo se la forma giuridica lo richiede
Coordinate bancarieSempreIBAN 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:

IndicatoreSignificatoImpatto
Account collegatoL'account Stripe è stato collegato con successo a HotelyPrerequisito per tutto il resto
Dettagli inviatiHai completato l'invio di tutti i dati richiesti da StripeSenza questo passaggio, alcune funzionalità potrebbero essere limitate
Pagamenti attiviStripe ha verificato i tuoi dati e i pagamenti possono essere elaboratiSolo 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 StripeCon Stripe
Pubblicazione pagina di prenotazioneDisponibileDisponibile
Ricerca disponibilitàDisponibileDisponibile
Prenotazioni con pagamento onlineNon disponibileDisponibile
Garanzia carta di creditoNon disponibileDisponibile
Prenotazioni "paga in struttura"DisponibileDisponibile
Rimborsi automaticiNon disponibileDisponibile
Addebiti per no-showNon disponibileDisponibile

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.