Collegare il Suo fornitore di pagamento

Ha un account presso un fornitore di pagamento. Ora dice a Passavo che può usare quell'account. Ci vogliono due minuti.

Se non ha ancora un account, vada prima a Creare un account Mollie, Creare un account Stripe oppure Richiedere Bancontact Pro.

Che cosa Le serve prima di cominciare

• Il ruolo Proprietario. Solo un proprietario accede a questa schermata. Nemmeno un amministratore: chi può cambiare fornitore decide dove va a finire il denaro. Veda Collaboratori e ruoli.
• Con Mollie: l'accesso alla Sua dashboard di Mollie, perché è lì che copia la Sua chiave API.
• Con Stripe: i Suoi dati di accesso a Stripe. Durante il collegamento accede da loro, quindi tenga a portata di mano la Sua password e la Sua verifica in due passaggi.
• Con Bancontact Pro: la Sua chiave API e la consapevolezza se è per l'ambiente di test o per la produzione.
• Cinque minuti davanti a un computer. Non lo faccia di fretta su un telefono tra due riunioni.

La schermata

Vada su Impostazioni → Pagamenti nel menu di sinistra.

Vede ora tre riquadri uno sotto l'altro: Mollie, Stripe e Bancontact Pro. Sotto ogni nome compare la situazione: Non ancora collegato, oppure Collegato seguito da

• con Mollie, il nome del Suo profilo presso Mollie;
• con Stripe, il numero del Suo account Stripe (comincia con acct_);
• con Bancontact Pro, l'ambiente della Sua chiave: EXT oppure PROD.

Sotto il nome possono comparire due badge: uno verde Attivo per la biglietteria presso il fornitore che la Sua biglietteria usa, e uno arancione Modalità di prova quando un collegamento non incassa ancora denaro vero. Veda Modalità di prova qui sotto.

Con Stripe, al posto di un pulsante compare la frase in rosso Questo fornitore non è ancora configurato sulla piattaforma, quindi il collegamento non è ancora possibile.? Allora Stripe non è ancora attivato su questa installazione. Non è una Sua impostazione: scriva al supporto. Mollie e Bancontact Pro si possono collegare sempre.

Collegare Mollie

Con Mollie incolla la Sua chiave API. Nessun accesso, niente da approvare: la chiave nel campo, fatto.

Passaggio 1 — Copi la Sua chiave su Mollie

1. Acceda alla Sua dashboard di Mollie, su mollie.com.
2. Vada in Sviluppatori → Chiavi API (Developers → API keys).
3. Lì vede due chiavi:
   • la chiave API live, che comincia con live_. Con questa i Suoi visitatori pagano davvero;
   • la chiave API di test, che comincia con test_. Con questa tutto funziona dall'inizio alla fine, ma non passa denaro vero.
4. Copi la chiave che vuole usare con il pulsante di copia accanto.

Quale scegliere? Se vuole vendere subito e il Suo account Mollie è approvato, prenda la chiave API live. Se vuole prima provare tutto, o se aspetta ancora l'approvazione di Mollie, prenda la chiave API di test. Può sempre cambiare in seguito.

Attenzione: copi la chiave vera e propria, non l'ID del profilo (pfl_…) né un token di organizzazione (access_…). Una chiave API comincia sempre con live_ o test_.

Passaggio 2 — La incolli in Passavo

1. In Passavo vada su Impostazioni → Pagamenti, nel riquadro Mollie.
2. Incolli la chiave nel campo Chiave API Mollie (live_… o test_…). Non vede i caratteri mentre incolla; è normale.
3. Clicchi su Salva la chiave.

Passaggio 3 — Passavo controlla subito la Sua chiave

Passavo chiede a Mollie se la chiave funziona, ancora prima di salvarla. Se tutto è a posto, vede il messaggio La Sua chiave Mollie è stata salvata. e il riquadro dice Collegato, seguito dal nome del Suo profilo presso Mollie. Sotto compare Metodi di pagamento attivi su Mollie, con i metodi attivi nella Sua dashboard di Mollie — per esempio Bancontact, iDEAL e carta. Così vede subito di aver incollato la chiave giusta.

Se non è ancora attivo nessun altro fornitore, Mollie diventa così il fornitore attivo della Sua biglietteria. Se Stripe o Bancontact Pro è già attivo, resta attivo quello; se vuole comunque usare Mollie, clicchi presso Mollie su Usa questo fornitore.

Se la chiave non va bene, non viene salvato nulla e vede il messaggio La Sua chiave Mollie non è stata salvata., con sotto il motivo. Veda E se … qui sotto.

Prosegua subito con Fare una prova con un pagamento da 1 centesimo.

Sostituire la chiave

Incolli una nuova chiave nello stesso campo e clicchi su Sostituisci la chiave. Anche questa viene controllata prima; se viene rifiutata, la chiave precedente continua semplicemente a funzionare. È così che passa, per esempio, dalla chiave API di test alla chiave API live.

Che cosa può fare Passavo con questa chiave?

Con la Sua chiave Passavo avvia i pagamenti della Sua biglietteria, della ricarica online e del Suo terminale di pagamento alla cassa, ne legge lo stato ed esegue i rimborsi. Il denaro va direttamente dal Suo visitatore al Suo account Mollie; non passa mai da un nostro conto.

La chiave viene conservata cifrata e sparisce dalla schermata dopo il salvataggio: nessuno può più leggerla lì, nemmeno Lei. Se pensa che qualcun altro conosca la Sua chiave, ne crei una nuova nella Sua dashboard di Mollie e la incolli qui con Sostituisci la chiave.

E il pulsante «Collega l'account Mollie»?

Su alcune installazioni accanto a Salva la chiave compare anche il pulsante Collega l'account Mollie. Con quello si collega tramite la schermata di accesso di Mollie invece che con una chiave. Funzionano entrambi; la chiave è la via abituale. Se il pulsante non c'è, non Le serve.

Collegare Stripe

Con Stripe non incolla alcuna chiave. Dà il consenso tramite la loro schermata di accesso.

Passaggio 1 — Clicchi sul pulsante

Nel riquadro di Stripe clicchi su Collega l'account Stripe.

Passaggio 2 — Acceda a Stripe

Lascia Passavo e arriva su una schermata di Stripe stesso. Dia un'occhiata alla barra degli indirizzi del browser: deve esserci scritto stripe.com. Così sa di digitare la password nel posto giusto.

Acceda come fa di solito, con la Sua verifica in due passaggi.

Passaggio 3 — Dia il consenso

Vede ora una schermata che elenca che cosa autorizza. Un collegamento standard tramite Stripe Connect dà accesso al Suo account Stripe. Passavo lo usa solo per avviare pagamenti, consultarne lo stato ed eseguire rimborsi. Lo revoca in qualsiasi momento con Scollega.

Se su Stripe ha più account, scelga quello giusto. Clicchi poi sul pulsante che dà il consenso (Connect my Stripe account, o qualcosa di simile).

Passaggio 4 — Di nuovo in Passavo

Torna automaticamente su Impostazioni → Pagamenti, con in alto il messaggio Il collegamento è riuscito. Il riquadro di Stripe dice ora Collegato.

Un nuovo collegamento Stripe diventa subito il fornitore attivo della Sua biglietteria: riceve l'etichetta verde Attivo per la biglietteria, anche se era già attivo un altro fornitore.

Modalità di prova

Se nel riquadro di un fornitore compare il badge arancione Modalità di prova, quel collegamento non incassa denaro vero.

Mollie in modalità di prova

Se ha salvato la Sua chiave API di test (test_…), il Suo collegamento Mollie è in modalità di prova. Lo vede dal badge Modalità di prova e dal messaggio Questo collegamento è in modalità di prova nel riquadro di Mollie, e in alto nella Sua dashboard dal messaggio in rosso Il Suo negozio è in modalità di prova. Durante il pagamento Mollie mostra una pagina di prova in cui sceglie Lei se il pagamento riesce.

In modalità di prova non si paga davvero, nemmeno i Suoi visitatori. Un ordine pagato così è un ordine di prova:

• porta la dicitura TEST: nell'elenco degli ordini, nell'e-mail di conferma, sul PDF e sul pass del wallet;
• non rientra nella Sua dashboard e non viene inviato come webhook alle Sue integrazioni;
• i suoi biglietti non danno accesso: l'app di scansione li rifiuta;
• non viene emessa fattura, e un codice sconto o un buono regalo usato non viene scalato.

Lo vede anche il Suo visitatore: la pagina di pagamento del Suo negozio indica che non si paga davvero.

Passare in produzione significa incollare la chiave API live e cliccare su Sostituisci la chiave. È la chiave a determinare la modalità: finché è salvata la chiave API di test, tutto resta una prova, anche dopo che Mollie ha approvato il Suo account.

Se incolla una chiave API live quando Mollie non ha ancora approvato il Suo profilo, viene salvata, ma vede il messaggio Mollie non ha ancora approvato il Suo profilo. Fino ad allora Mollie rifiuta i pagamenti reali. Nel frattempo usi la chiave API di test.

Ha collegato Mollie in passato tramite la schermata di accesso di Mollie? Allora quel collegamento passa da solo in produzione non appena Mollie approva il Suo profilo, e nel riquadro di Mollie c'è un pulsante Passa in produzione per non dover aspettare.

Stripe e Bancontact Pro

• Stripe riceve il badge Modalità di prova quando il collegamento è stato fatto con l'ambiente di test di Stripe. Questo non può cambiarlo Lei: scriva al supporto. Un account Stripe non ancora attivato non riceve quel badge; semplicemente non può ancora accettare pagamenti.
• Bancontact Pro riceve il badge Modalità di prova finché ha salvato una chiave dell'Ambiente di prova (ext). Per il denaro vero salvi una chiave di Produzione (prod).

Collegare Bancontact Pro

Anche con Bancontact Pro incolla una chiave.

1. Incolli la Sua chiave API nel campo Chiave API Bancontact Pro. Non vede i caratteri mentre incolla; è normale.
2. Nel menu a tendina accanto scelga l'ambiente: Ambiente di prova (ext) oppure Produzione (prod).
3. Clicchi su Salva la chiave.

Se non è ancora attivo nessun altro fornitore, Bancontact Pro diventa così il fornitore attivo della Sua biglietteria. Se Mollie o Stripe è già attivo, resta attivo quello; se vuole comunque usare Bancontact Pro, clicchi presso Bancontact Pro su Usa questo fornitore. A differenza di Mollie, Passavo non controlla una chiave Bancontact Pro al momento del salvataggio: solo al primo pagamento si vede se funziona. Faccia quindi subito un pagamento di prova.

Attenzione: una chiave appartiene a un solo ambiente. Una chiave di test in produzione produce messaggi di errore che sembrano non rimandare a nulla. Meglio quindi controllare una volta di troppo.

La chiave viene conservata cifrata e sparisce dalla schermata. Se in seguito vuole sostituirla, ne incolla semplicemente una nuova e clicca su Sostituisci la chiave. Il fornitore attivo non cambia per questo.

Quale fornitore usa la Sua biglietteria?

Può collegarne più di uno, ma la Sua biglietteria ne usa uno alla volta. Il Suo visitatore vede quindi solo i metodi di pagamento di quell'unico fornitore.

Riconosce il fornitore attivo dall'etichetta verde Attivo per la biglietteria. Se ne vuole un altro, clicchi in corrispondenza di quello su Usa questo fornitore. L'etichetta si sposta di conseguenza.

Gli ordini esistenti restano presso il fornitore con cui sono stati pagati. Un rimborso passa sempre tramite quel fornitore, anche se nel frattempo la Sua biglietteria ne usa un altro — finché quel vecchio fornitore resta collegato.

L'URL del webhook

Appena è collegato, nel riquadro compare un URL del webhook, qualcosa nella forma https://{domein}/webhooks/mollie.

Un webhook è un indirizzo a cui il fornitore ci manda un messaggino non appena succede qualcosa a un pagamento. È così che entro un secondo sappiamo che è stato pagato, senza che nessuno debba cliccare su aggiorna.

Lei non deve farci nulla; è scritto anche sotto l'indirizzo: Non deve inserire questo URL da nessuna parte: ce ne occupiamo noi.

Fornitore	Come l'indirizzo arriva al fornitore
Mollie	Viene trasmesso automaticamente a ogni pagamento
Stripe	È configurato a livello di piattaforma
Bancontact Pro	Viene trasmesso automaticamente a ogni pagamento

Un pagamento resta da Lei su In attesa mentre il fornitore dice che è andato a buon fine? Allora quel messaggino non è arrivato. Ogni webhook in entrata viene registrato, quindi è verificabile — ci scriva e guardiamo insieme. Veda anche Quando un pagamento non riesce.

Scollegare

Con Scollega interrompe il collegamento. Riceve prima una richiesta di conferma.

Che cosa succede:

• la Sua biglietteria non può più avviare nuovi pagamenti tramite quel fornitore;
• con Mollie e Bancontact Pro la Sua chiave viene cancellata da noi. Se vuole renderla inutilizzabile anche su Mollie, crei una nuova chiave nella Sua dashboard di Mollie;
• con Stripe il consenso viene revocato anche presso Stripe stesso, così la nostra applicazione sparisce dalla Sua dashboard;
• i Suoi ordini esistenti restano tranquillamente, con il rimando al fornitore con cui sono stati pagati.

Se scollega il fornitore attivo mentre ne è collegato ancora un altro, la Sua biglietteria usa quell'altro, anche se l'etichetta verde allora non compare da nessuna parte. Clicchi quindi subito su Usa questo fornitore presso il fornitore che vuole usare.

Attenzione: non scolleghi un fornitore con cui ha ancora venduto biglietti per un evento che deve ancora svolgersi. Un rimborso di quegli ordini passa per quel fornitore. Dopo averlo scollegato non potrà più avviarlo da Passavo: riceve il messaggio Questa organizzazione non ha alcun fornitore di pagamento collegato. e dovrà rimborsare nella dashboard di quel fornitore. Con Mollie basta incollare di nuovo la stessa chiave.

Errori frequenti

Lasciare la chiave API di test. Con una chiave test_ ogni pagamento è una prova, anche quello dei Suoi visitatori, e i loro biglietti non danno accesso. Prima di condividere il Suo link controlli che il badge Modalità di prova sia sparito.

Incollare qualcos'altro al posto della chiave. L'ID del profilo (pfl_…), la Sua password o un token di organizzazione (access_…) non funzionano. Una chiave comincia con live_ o test_.

Copiare solo una parte della chiave. Usi il pulsante di copia della Sua dashboard di Mollie invece di selezionare la chiave con il mouse.

Collegare un altro fornitore "per provare". Un nuovo collegamento Stripe diventa subito il fornitore attivo. Controlli quindi sempre dopo che l'etichetta verde Attivo per la biglietteria sia sul fornitore giusto.

Pensare che collegare basti. Quali metodi di pagamento vede il Suo visitatore lo attiva nella dashboard del fornitore, non qui.

Provarci come amministratore. In quel caso questo menu non lo vede nemmeno. Lo chieda al proprietario.

E se …

E se Passavo rifiuta la mia chiave Mollie?

Sotto il messaggio La Sua chiave Mollie non è stata salvata. c'è il motivo:

• Non sembra una chiave API di Mollie. Ha incollato qualcosa che non comincia con live_ o test_, oppure solo una parte. Copi di nuovo la chiave.
• Questo è un token di organizzazione di Mollie, non una chiave API. Ha incollato un token che comincia con access_. Prenda la chiave API live o di test da Sviluppatori → Chiavi API.
• Mollie non riconosce questa chiave. La chiave non è valida o nel frattempo è stata rinnovata su Mollie. Copi la chiave che compare ora nella Sua dashboard di Mollie.
• Mollie non è raggiungibile al momento. Allora non dipende da Lei. Riprovi tra qualche minuto.

In tutti questi casi non viene salvato nulla, e una chiave che funzionava già continua a funzionare.

E se sotto «Metodi di pagamento attivi su Mollie» non c'è niente?

Allora nella Sua dashboard di Mollie non è ancora attivo alcun metodo di pagamento, e nessuno può pagare. Ne attivi almeno uno — Bancontact, per esempio — e poi incolli di nuovo la chiave, così l'elenco si aggiorna.

E se con Stripe arrivo a un messaggio di errore?

Se torna con Il collegamento è stato interrotto., ha rifiutato nella schermata di consenso oppure ha chiuso la finestra. Se compare Il fornitore ha restituito un errore durante il collegamento., riprovi e verifichi su Stripe che il Suo account sia in regola.

Se riceve una pagina di errore invece della schermata Pagamenti, il Suo tentativo è scaduto: il collegamento deve concludersi entro un quarto d'ora. Ricominci semplicemente da Impostazioni → Pagamenti.

E se voglio cambiare fornitore nel mezzo di una prevendita?

Si può. Colleghi il nuovo e, se serve, clicchi su Usa questo fornitore. Lasci il vecchio collegato finché ha ancora biglietti in corso su di esso: un rimborso di quei vecchi ordini passa automaticamente tramite il vecchio fornitore.

E se ho perso la mia chiave Bancontact Pro?

Ne richieda una nuova alla Sua banca. Noi non possiamo mostrargliela: viene conservata cifrata e dopo il salvataggio sparisce dalla schermata. Per Mollie vale lo stesso, ma lì la copia semplicemente di nuovo dalla Sua dashboard di Mollie.

Domande frequenti

Vedete la mia password presso il fornitore? No. Con Mollie incolla una chiave, non una password. Con Stripe digita la password sul loro sito; noi riceviamo indietro solo un consenso, che revoca con Scollega.

Perché una chiave con Mollie, e non un pulsante come con Stripe? Perché è il modo più rapido e non deve approvare niente: copiare la chiave, incollarla, fatto. Il Suo denaro arriva altrettanto direttamente sul Suo account Mollie.

Posso fare il collegamento da un telefono? Tecnicamente sì, ma non lo faccia: copiare una chiave lunga o leggere con calma una schermata di consenso riesce meglio su un computer.

Posso fare delle prove prima di vendere davvero? Sì, ed è giusto così. Veda Fare una prova con un pagamento da 1 centesimo.

Perché vedo sia Bancontact Pay che Bancontact Pro? Perché sono due cose. Bancontact Pro è ciò che richiede e collega qui; da lì viene la Sua chiave. Bancontact Pay è l'app con cui il Suo visitatore scansiona il QR. Fino a marzo 2026 si chiamavano entrambi Payconiq. Veda Richiedere Bancontact Pro.

Che cosa succede ai miei biglietti se scollego? Nulla. Biglietti, ordini e scansioni restano. Solo i nuovi pagamenti tramite quel fornitore non sono più possibili.