IntegrazioniStripe

Colleghi il Suo account Stripe

Autentichi il Suo account Stripe una sola volta e i pagamenti con carta effettuati tramite il Motore di prenotazione verranno accreditati direttamente su di esso. Cosa comprende la connessione, come verificare che abbia funzionato, cosa significa la modalità di prova e quali sono le conseguenze della disconnessione.

Dove trovarlo
IntegrationsStripe
È necessaria l'autorizzazione
Connect or disconnect Stripe
Ultimo controllo
16 agosto 2026

Questa schermata consente di collegare il Suo account Stripe a questa struttura. Una volta effettuato il collegamento, i pagamenti con carta effettuati tramite il Suo Motore di prenotazione vengono accreditati su quel saldo Stripe: l’account è il Suo, il denaro vi viene versato e i rimborsi e i versamenti vengono gestiti dal Suo Cruscotto Stripe.

Si tratta di una sola decisione e di un solo pulsante. Non c’è nulla da configurare in seguito, nessuna chiave da incollare e nessuna mappatura da compilare.

La scheda "Stripe" nella schermata "Integrations" prima della configurazione, intitolata "Stripe" con la riga "Take booking engine card payments into your own Stripe account", un badge grigio "Not Connected" e un pulsante blu "Connect" che occupa l'intera larghezza della scheda.
Da dove parte il collegamento. La carta si limita a segnalare lo stato; è la schermata sottostante a svolgere il lavoro.

A cosa serve questa connessione

Le strutture ricettive ricevono i pagamenti in modi diversi e Prostay ne supporta più di uno. Questa connessione è l’opzione ideale per una struttura che dispone già di un conto Stripe e desidera continuare a utilizzarlo: il conto rimane a Suo nome, il denaro viene accreditato lì e gestite rimborsi e versamenti nel Cruscotto che già conosce.

L’alternativa è Prostay Pay, il sistema di elaborazione dei pagamenti proprio di Prostay. In questo caso, l’account viene configurato all’interno di Prostay, il denaro viene trasferito secondo il calendario dei pagamenti definito da Prostay Pay e i rimborsi vengono emessi dalle schermate di Prostay. Nessuna delle due soluzioni rappresenta un aggiornamento dell’altra. La domanda da porsi è dove desiderate che il denaro venga accreditato e su quale cruscotto preferite operare quando è necessario effettuare un rimborso.

Prima di iniziare

  • Un account Stripe a cui possa accedere. L’integrazione autorizza un account esistente; non ne crea uno per lei.
  • L’autorizzazione “Stripe Connect” nel proprio ruolo su Prostay. Senza di essa, la schermata si aprirà in modalità di sola lettura; questo aspetto verrà trattato alla fine.
  • Quindici secondi. Non c’è davvero nient’altro da preparare.

Connessione

Apra Integrations, quindi la scheda “Stripe”. Prima della configurazione, la schermata presenta un solo pulsante e tre spiegazioni relative alla funzione del pulsante stesso.

Se la scheda “Stripe” non è presente nella Sua pagina “Integrazioni”, il Suo ruolo non include l’autorizzazione necessaria. Un amministratore può aggiungerla da “Users” nelle Impostazioni di sistema, alla voce “Integrations” › “Stripe connection”.

La schermata “Stripe” prima della connessione. Una scheda dell’account Stripe con un badge grigio Not Connected, la riga “Verrà reindirizzato a Stripe per autorizzare la connessione, quindi tornerà qui” e un pulsante blu Connect with Stripe. Sotto di essa, una scheda «Come funziona» elenca tre passaggi: «Clicchi su Connect with Stripe», «Autorizzi su Stripe» e «Riceva il pagamento direttamente». A destra, una scheda «Cosa ottiene» elenca i fondi che vengono accreditati sul Suo conto, l’accesso con un solo clic a connect, i rimborsi e i versamenti da Lei controllati, nonché la sicurezza garantita da Stripe; sopra di essa, una riga che recita: «Prostay non memorizza mai le Sue chiavi di elaborazione delle carte».
La schermata completa prima della connessione. Tutto ciò che vi è riportato è o il pulsante stesso o una spiegazione della sua funzione.
  1. Clicchi su «Connect with Stripe». Il pulsante si trasforma in « Redirecting...» e, successivamente, il Suo browser uscirà da Prostay.
  2. Ora si trova sul sito di Stripe. Effettui l’accesso e approvi la connessione all’account sul quale desidera che venga versato il pagamento relativo a questa struttura. Prostay non vede mai la Sua password Stripe e non vi sono chiavi API o segreti da copiare in nessuna delle due direzioni.
  3. Stripe vi reindirizza a questa schermata e il badge riporta la scritta " Connected ".

Se qualcosa va storto durante il ritorno, la schermata lo segnala con un banner rosso intitolato «Stripe connection error», che riporta il motivo per cui l’operazione non è andata a buon fine. Il caso più comune è che l’autorizzazione sia stata annullata anziché approvata; in tal caso, clicchi su « Connect with Stripe» e ripeta la procedura.

Verifica del corretto funzionamento

Una schermata connessa mostra un badge verde con la scritta "Connected" e l’ identificativo dell’account a cui è collegata.

La scheda dell’account Stripe dopo la connessione, con un badge verde Connected, la riga “Il Suo account Stripe è connected e booking engine” card payments reindirizza direttamente a Lei, una schermata dell’account Connected che mostra l’identificativo dell’account acct_1QMarloweDemo00 in un carattere a spaziatura fissa e un pulsante Disconnect.
Connesso. L’identificativo dell’account è l’unico elemento da verificare: dovrebbe corrispondere all’account con cui ha effettuato l’accesso.

Vale la pena leggere attentamente tale identificativo anziché limitarsi a dargli un'occhiata. Si tratta dell’account fornito da Stripe, che inizia con acct_. Se il Suo gruppo possiede più di un account Stripe, questo è l’unico punto in Prostay che Le indica a quale di essi è ora associata la Struttura. Lo confronti con l’ID dell’account presente nel Cruscotto di Stripe prima di accettare una prenotazione effettiva.

La schermata Integrations mostra la stessa informazione in modo più sintetico: la scheda Stripe diventa verde e il relativo pulsante cambia da Connect a Configure.

Modalità di prova

Gli account Stripe dispongono di una sezione live e di una sezione di test. Se la connessione è stata autorizzata nella sezione di test, la schermata lo indica tramite un banner color ambra.

La stessa scheda “connected” con un banner color ambra tra il pannello dell’account e il pulsante “Disconnect”, intitolata “Account in modalità di prova” e recante la dicitura: “Questo account Stripe è connected in modalità di prova, pertanto le carte reali non saranno addebitate.”
Il banner appare solo su un account di prova. Una struttura che lo visualizza è connessa, ma non a un sistema in grado di incassare denaro.

Questa è la trappola che vale la pena segnalare. Una connessione di prova appare esattamente come una reale in ogni altro aspetto: il badge è verde, la carta nella schermata Integrazioni è verde e nessun altro elemento in Prostay vi avvisa. La differenza sta nel fatto che una vera carta di un ospite utilizzata tramite un account di prova non viene mai addebitata, quindi la prenotazione viene registrata ma il pagamento non viene effettuato.

Se vede il banner e intendevate utilizzare l’account attivo, ricollegatevi dal lato “live” del Suo account Stripe. Il banner non è un’impostazione in Prostay e non vi è alcun interruttore qui che lo attivi o lo disattivi; esso riporta semplicemente quanto comunicato da Stripe riguardo all’ account da voi autorizzato.

Dove vengono attivati i pagamenti con carta

La connessione determina dove vengono indirizzati i pagamenti con carta nel motore di prenotazione. Non decide, di per sé, se il Suo motore di prenotazione offra o meno il pagamento con carta. Ciò viene gestito su Settings, poi in “Opzioni di pagamento”, dove ogni tipo di carta è contrassegnato dal tag Booking engine quando viene proposto agli ospiti online.

Pertanto, una struttura che ha collegato Stripe ma non vede alcuna opzione di pagamento con carta sul proprio Motore di prenotazione dovrebbe controllare lì anziché qui, mentre una struttura che cambia idea sulle modalità di pagamento deve consultare due schermate, non una sola. Questa schermata non riporta mai le impostazioni di pagamento del Motore di prenotazione, e la schermata “Opzioni di pagamento” non riporta mai informazioni relative a questa integrazione.

Disconnessione

Clicchi su “Disconnect”. Prostay Le chiederà di confermare, avvertendola che i pagamenti con carta tramite questo account verranno sospesi fino a quando non si ricollegherà, dopodiché la schermata tornerà allo stato in cui si trovava prima della connessione: un badge grigio “ Not Connected” e il pulsante che propone di ricominciare da capo.

La disconnessione rimuove il collegamento tra questa struttura e quell’account Stripe . Non influisce in alcun modo sui dati all’interno di Stripe. I Pagamenti già ricevuti, i Versamenti già programmati, i Suoi Clienti, il Suo saldo e la Sua cronologia rimangono esattamente dove si trovano, poiché sono sempre stati nel Suo account piuttosto che in Prostay.

Chi può effettuare la connessione

Sia la connessione che la disconnessione sono controllate dall’autorizzazione “Stripe connect” assegnata al Suo ruolo. Senza di essa, la schermata si apre comunque e Le indica se la Struttura è connessa, ma il pulsante che consentirebbe di apportare modifiche risulta disattivato, con una riga sottostante che indica quale autorizzazione manca.

La scheda dell’account Stripe così come appare senza l’autorizzazione: lo stesso badge Not Connected e la stessa spiegazione, ma il pulsante Connect with Stripe è disattivato out e una piccola linea grigia sotto di esso recita: “È necessaria l’autorizzazione Stripe connect per eseguire questa operazione”.
Senza l’autorizzazione, la schermata si apre comunque. Solo il pulsante che consente di apportare modifiche risulta inaccessibile.

Si tratta di una scelta deliberata. Questa impostazione determina il conto bancario su cui vengono versati i fondi dei Suoi ospiti; pertanto, non si tratta di un diritto associato alla semplice possibilità di effettuare l’accesso. Un amministratore lo assegna a livello di ruolo anziché a livello di persona, in Settings, quindi Users, come illustrato nella sezione dedicata a utenti, ruoli e autorizzazioni.

Domande frequenti

  • Devo fornire a Prostay le mie chiavi API di Stripe?

    No, e non c’è alcun campo in cui inserirla. La connessione viene autorizzata sul sito di Stripe e Stripe restituisce un riferimento dell’account, che è l’identificativo visualizzato sullo schermo. Se una pagina, ovunque essa sia, Le chiede di incollare una chiave segreta di Stripe in Prostay, non si tratta di questa integrazione.

  • È possibile collegare Stripe e utilizzare Prostay Pay contemporaneamente?

    Si tratta di due risposte diverse alla stessa domanda, ovvero dove vengono accreditati i fondi della carta di credito; pertanto, una struttura ricettiva utilizza solitamente l’una o l’altra opzione. Questa schermata riporta solo le informazioni relative alla connessione Stripe e non indica quali altre opzioni siano attivate. Se non è sicuro di quale opzione sia attiva per il Suo Motore di prenotazione, verifichi le «Opzioni di pagamento» e confermi con una prenotazione di prova prima di un periodo di grande affluenza.

  • Perché la mia carta Stripe risulta come "Connettata" quando nessuno qui l'ha collegata?

    Il badge descrive la struttura, non Lei. Chiunque ricopra un ruolo con l’autorizzazione “Stripe Connect” può autorizzare la connessione, e la schermata non registra chi l’ha effettuata né quando. Se l’identificativo dell’account non Le risulta familiare, si disconnetta e si ricolleghi dall’account sul quale desidera ricevere il pagamento.

  • La connessione ha funzionato, ma gli ospiti non riescono ancora a pagare con la carta. Qual è il problema?

    Devono verificarsi due condizioni: questo collegamento deve essere attivo e il pagamento con carta deve essere offerto dal Suo Motore di prenotazione. La seconda opzione si trova in Impostazioni, quindi in Opzioni di pagamento. Verifichi inoltre se l’account collegato sia un account di prova, poiché il banner color ambra su questa schermata indica che le carte reali non vengono mai addebitate.

Questo articolo Le è stato utile?

Articoli correlati

È ancora in difficoltà?

È possibile ricevere assistenza anche direttamente dall'app; pertanto, se ha già effettuato l'accesso, riceverà una risposta più rapida in quella sede. In caso contrario, ci invii il nome dell'immobile e ci descriva cosa stava cercando di fare.