Configura la tua piattaforma di pagamento premium
Le piattaforme di pagamento premium integrate con Avantio permettono di automatizzare gli incassi legati alle tue prenotazioni e di gestire le transazioni in modo sicuro.
La procedura di connessione varia a seconda del fornitore. In alcuni casi dovrai prima creare un account e completare l’onboarding direttamente sulla piattaforma. In altri, sarà necessario richiedere determinate credenziali o link di connessione al team Customer Experience di Avantio.
In questo articolo troverai il processo di integrazione per ogni fornitore, i dati necessari e i tempi indicativi di attivazione.
Cosa imparerai in questo articolo?
In questo articolo imparerai a:
Preparare le informazioni necessarie prima di iniziare una connessione.
Completare l’onboarding con il fornitore dei pagamenti.
Richiedere ad Avantio i link o gli identificatori necessari.
Fornire correttamente le credenziali di integrazione.
Verificare la connessione tramite una prenotazione di prova.
Individuare i principali errori durante il processo.
Vantaggi
Collegare una piattaforma di pagamento premium ti permetterà di:
Automatizzare gli incassi relativi alle prenotazioni.
Ridurre l’intervento manuale del team.
Centralizzare la configurazione dei pagamenti.
Rafforzare la sicurezza tramite sistemi come il 3D Secure.
Migliorare la tracciabilità delle transazioni.
Facilitare il monitoraggio di incassi, rimborsi e problematiche.
Adattare la soluzione di pagamento al paese in cui opera la tua azienda.
Quando dovresti effettuare questa configurazione?
Dovresti effettuare questa configurazione quando:
Hai scelto la piattaforma di pagamento che utilizzerà la tua azienda.
Hai confermato che il fornitore opera nel tuo paese.
Vuoi iniziare a gestire gli incassi delle prenotazioni tramite la nuova piattaforma.
Hai bisogno di sostituire una piattaforma utilizzata in precedenza.
Vuoi automatizzare pagamenti che attualmente gestisci manualmente.
Il fornitore ha approvato l’account della tua azienda.
Prima di iniziare
È utile verificare prima:
Che la piattaforma scelta sia disponibile nel tuo paese.
Che tu abbia attivato il servizio direttamente con il fornitore.
Che l’account sia registrato a nome dell’azienda corretta.
Che tu abbia completato le verifiche legali e bancarie richieste.
Che tu abbia accesso amministrativo all’account.
Che tu abbia pronti i dati e le credenziali necessarie.
Che tu sappia quale azienda, uffici o alloggi utilizzeranno la connessione.
Che la persona responsabile della configurazione abbia i permessi necessari su Avantio.
È inoltre consigliabile stabilire internamente chi si occuperà di controllare gli incassi, i rimborsi, le riconciliazioni e le eventuali problematiche.
Non inviare mai credenziali sensibili tramite canali non autorizzati. Quando è necessario fornire dati ad Avantio, fallo tramite un ticket indirizzato al team Customer Experience.
Collega la tua piattaforma premium scelta con Avantio
Comercia Global Payments
Comercia Global Payments
Prima di iniziare
Per utilizzare Comercia Global Payments devi prima avviare il processo di attivazione e onboarding direttamente con Comercia.
Segui questi passaggi
Contatta Comercia Global Payments tramite il tuo referente commerciale.
Comunica che desideri utilizzare Comercia Global Payments con Avantio.
Fornisci la documentazione aziendale e bancaria richiesta.
Completa il processo di onboarding con Comercia.
Attendi che Comercia validi e approvi l’account.
Comercia si metterà in contatto con Avantio per fornire i dati necessari all’integrazione.
Conferma con il team Customer Experience di Avantio che la richiesta è in corso.
Quando la connessione sarà disponibile, effettua una prenotazione di prova.
Verifica che la transazione compaia correttamente sia su Avantio che sull’interfaccia di Comercia.
Tempo di attivazione
Il processo di solito si completa in circa una settimana, anche se i tempi possono variare in base alla documentazione e alle verifiche richieste durante l’onboarding.
Stripe
Stripe
Prima di iniziare
Per collegare Stripe hai bisogno di:
Un account Stripe di tipo Standard.
Aver completato il processo di verifica richiesto da Stripe.
Accesso all’account con i permessi necessari.
Un link di connessione fornito da Avantio.
Segui questi passaggi
Accedi al sito di Stripe e crea un account di tipo Standard.
Completa i dati aziendali, fiscali e bancari richiesti.
Termina il processo di verifica dell’account.
Apri un ticket per il team Customer Experience di Avantio.
Indica nel ticket che desideri collegare il tuo account Standard di Stripe.
Attendi di ricevere il link di connessione.
Apri il link ed effettua l’accesso con l’account Stripe corrispondente.
Autorizza la connessione tra Stripe e Avantio.
Conferma con il team Customer Experience che il processo è stato completato.
Effettua una prenotazione di prova e verifica che il pagamento venga processato correttamente.
Tempo di attivazione
La connessione può essere attiva anche in giornata, purché l’account Standard di Stripe sia verificato e pronto per l’uso.
SysPay
SysPay
Prima di iniziare
Per avviare la connessione con SysPay dovrai completare il loro processo di onboarding.
Durante questo processo, SysPay richiederà due identificativi che ti deve fornire Avantio:
Account ID.
Merchant ID.
Segui questi passaggi
Contatta il team commerciale di SysPay.
Comunica che vuoi utilizzare l’integrazione con Avantio.
Fornisci a SysPay la documentazione aziendale e bancaria richiesta.
Apri un ticket per il team Customer Experience di Avantio.
Richiedi il tuo Account ID e Merchant ID per la connessione con SysPay.
Fornisci questi due identificativi a SysPay.
Completa le verifiche richieste dal fornitore.
Attendi che SysPay attivi il modulo di gestione pagamenti tramite API.
Quando SysPay conferma che il modulo è pronto, comunicalo al team Customer Experience di Avantio tramite il ticket.
Avantio completerà la configurazione dell’integrazione.
Effettua una prenotazione di prova.
Verifica che la transazione venga processata e compaia correttamente su entrambe le piattaforme.
Tempo di attivazione
L’attivazione richiede solitamente alcuni giorni, a seconda del tempo necessario per completare l’onboarding e attivare il modulo pagamenti tramite API.
Mercado Pago
Mercado Pago
Prima di iniziare
Per collegare Mercado Pago hai bisogno di:
Un account aziendale attivo.
Accesso alla sezione integrazioni.
Lo User ID dell’account.
La chiave segreta configurata per i webhook.
L’Access Token di produzione.
L’URL del webhook fornito da Avantio.
Segui questi passaggi
Accedi al tuo account aziendale di Mercado Pago.
Vai alla sezione La tua azienda.
Seleziona Integrazioni.
Trova il pannello delle applicazioni collegate.
Accedi all’applicazione che userai per la connessione con Avantio.
Trova il campo User ID.
Copia il valore e conservalo in un luogo sicuro.
Apri un ticket per il team Customer Experience di Avantio.
Richiedi l’URL da utilizzare per configurare i webhook.
Torna su Mercado Pago e vai alla sezione Webhooks.
Inserisci l’URL fornito da Avantio.
Nella sezione eventi, seleziona Pagamenti.
Trova il campo Chiave segreta.
Copia il valore corrispondente alla chiave segreta dei webhook.
Vai su Credenziali di produzione.
Trova il campo Access Token.
Copia il valore e conservalo in modo sicuro.
Verifica di avere i seguenti dati:
User ID.
Webhooks Secret Key.
Access Token.
Fornisci questi dati al team Customer Experience di Avantio tramite il ticket e il canale sicuro indicato.
Attendi che Avantio inserisca le credenziali nell’assistente di connessione.
Quando la configurazione è terminata, effettua una prenotazione di prova.
Verifica che l’incasso venga processato e registrato correttamente.
Tempo di attivazione
L’attivazione può essere immediata una volta che Avantio riceve le credenziali corrette e completa la configurazione.
Dopo l’attivazione, è necessario effettuare una prenotazione di prova per verificare che gli incassi funzionino correttamente.
Tilopay
Tilopay
Prima di iniziare
Per collegare Tilopay devi prima completare il loro processo di onboarding e ottenere le credenziali di produzione.
I dati necessari sono:
Tilopay Key.
Tilopay Password.
Tilopay Proxy Key.
Tilopay User.
Dovrai anche scegliere la modalità di operazione che utilizzerai.
Modalità di operazione disponibili
3DS v.2
Con questa modalità, l’ospite dovrà autorizzare tramite 3D Secure ciascun pagamento associato alla prenotazione.
Può essere adatta quando vuoi che tutti gli addebiti richiedano un’autenticazione individuale da parte del titolare della carta.
E-commerce: CIT e MIT
Con questa modalità, l’ospite autorizza tramite 3D Secure solo il primo pagamento.
I pagamenti successivi associati alla prenotazione possono essere processati automaticamente come operazioni avviate dal commerciante, purché vengano rispettate le condizioni stabilite dal fornitore.
Può essere adatta per prenotazioni con più scadenze o pagamenti rateali.
Segui questi passaggi
Contatta direttamente Tilopay per avviare il processo di onboarding.
Comunica che utilizzerai l’integrazione con Avantio.
Fornisci la documentazione aziendale e bancaria richiesta.
Completa le verifiche richieste da Tilopay.
Conferma con Tilopay quale modalità di operazione è più adatta alla tua azienda: 3DS v.2 oppure E-commerce con CIT e MIT.
Richiedi le credenziali di produzione.
Verifica di avere Tilopay Key, Tilopay Password, Tilopay Proxy Key e Tilopay User.
Crea un ticket per il team Customer Experience di Avantio.
Inserisci le credenziali necessarie tramite il canale sicuro indicato dal team.
Indica la modalità di operazione scelta.
Attendi che Avantio configuri l’integrazione.
Effettua una prenotazione di prova.
Verifica il primo addebito e, se previsto, il funzionamento dei pagamenti successivi.
Tempo di attivazione
L’attivazione di solito si completa in pochi giorni, a seconda del tempo necessario per concludere l’onboarding e ottenere le credenziali.
Ascent Payment Solutions
Ascent Payment Solutions
Prima di iniziare
Per collegare Ascent Payment Solutions devi completare il loro processo di onboarding e avere a disposizione le seguenti credenziali:
Client ID.
Site ID.
Key.
Password.
Price ID.
Segui questi passaggi
Contatta direttamente Ascent Payment Solutions.
Comunica che desideri utilizzare l’integrazione con Avantio.
Completa il processo di attivazione e onboarding.
Fornisci la documentazione aziendale e bancaria richiesta.
Attendi che Ascent approvi l’account e generi le credenziali.
Verifica di avere Client ID, Site ID, Key, Password e Price ID.
Crea un ticket per il team Customer Experience di Avantio.
Fornisci le credenziali tramite il canale sicuro indicato.
Attendi che Avantio completi la configurazione.
Effettua una prenotazione di prova.
Verifica che l’addebito compaia correttamente sia in Avantio che nell’interfaccia di Ascent.
Tempo di attivazione
La connessione di solito si completa in pochi giorni, a seconda dell’avanzamento del processo di onboarding con Ascent.
Risultato atteso
Al termine del processo relativo al tuo fornitore:
La piattaforma di pagamento sarà collegata con Avantio.
Potrai gestire gli addebiti associati alle prenotazioni.
Le transazioni verranno inviate alla piattaforma configurata.
Potrai consultare i movimenti da Avantio e, se previsto, dal pannello del fornitore.
I pagamenti utilizzeranno le misure di sicurezza e autenticazione disponibili sulla piattaforma.
L’integrazione deve essere considerata conclusa solo dopo aver effettuato e verificato correttamente una prenotazione di prova.
Prossimi passi consigliati
Dopo aver attivato la connessione:
Effettua una prenotazione di prova con un importo ridotto.
Verifica che il pagamento venga registrato correttamente in Avantio.
Controlla che la transazione compaia sulla piattaforma di pagamento.
Verifica lo stato del pagamento e la valuta utilizzata.
Controlla il funzionamento del 3D Secure.
Verifica i pagamenti successivi se lavori con addebiti rateali.
Effettua un rimborso di prova quando il fornitore lo consente.
Conferma quali membri del team hanno accesso al pannello dei pagamenti.
Documenta internamente la procedura per gestire contestazioni e chargeback.
Informa il team prima di iniziare a gestire prenotazioni reali.
Principali dati e credenziali
A seconda del fornitore, potresti aver bisogno dei seguenti elementi:
Stripe: account Standard e link di collegamento.
Comercia Global Payments: account approvato e dati gestiti direttamente tra Comercia e Avantio.
Tilopay: Tilopay Key, Tilopay Password, Tilopay Proxy Key e Tilopay User.
Ascent Payment Solutions: Client ID, Site ID, Key, Password e Price ID.
SysPay: Account ID e Merchant ID.
Mercado Pago: User ID, Webhooks Secret Key e Access Token.
Tratta sempre queste credenziali come informazioni riservate.
Limitazioni e considerazioni
Tieni presente che:
Avantio non può completare l’integrazione finché il fornitore non ha approvato l’account.
I tempi di attivazione sono indicativi.
La documentazione richiesta dipende dal fornitore e dal paese.
Le credenziali devono appartenere all’ambiente di produzione, salvo diversa indicazione.
Una credenziale incompleta, scaduta o copiata in modo errato può impedire la connessione.
L’integrazione può richiedere la partecipazione sia del fornitore che di Avantio.
Alcune operazioni devono essere gestite dal pannello esterno della piattaforma.
L’attivazione tecnica non garantisce che tutti i metodi di pagamento siano abilitati.
La configurazione del 3D Secure può variare in base alla piattaforma e alla modalità di operazione.
Gli addebiti successivi possono richiedere una configurazione specifica.
Non dovresti iniziare a gestire pagamenti reali senza aver completato una prova.
Prima di cambiare una piattaforma già in uso, verifica l’impatto sulle prenotazioni esistenti e sugli addebiti ancora in sospeso.
Buone pratiche
Utilizza un account aziendale e non un account personale.
Completa l’onboarding prima di richiedere l’attivazione in Avantio.
Controlla attentamente ogni credenziale prima di inviarla.
Non condividere password o token su canali non autorizzati.
Mantieni aggiornato il contatto amministrativo della piattaforma.
Limita gli accessi solo alle persone che devono realmente gestire i pagamenti.
Attiva l’autenticazione a due fattori nel pannello del fornitore quando disponibile.
Effettua sempre una prenotazione di prova.
Verifica sia il primo pagamento che quelli successivi.
Controlla periodicamente le transazioni rifiutate.
Documenta internamente il processo di rimborso e chargeback.
Informa Avantio e il fornitore se modifichi il conto bancario, la ragione sociale o le credenziali.
Evita di sostituire una connessione attiva durante periodi con un alto volume di addebiti in sospeso.
Caso pratico
Un’azienda decide di utilizzare Tilopay per gestire prenotazioni con più pagamenti.
L’azienda completa l’onboarding e sceglie la modalità E-commerce con CIT e MIT, perché desidera che l’ospite autorizzi il primo pagamento tramite 3D Secure e che gli addebiti successivi vengano processati automaticamente.
Dopo aver ricevuto le credenziali di produzione, l’azienda fornisce ad Avantio la Tilopay Key, Tilopay Password, Tilopay Proxy Key e Tilopay User.
Avantio completa la configurazione e l’azienda effettua una prenotazione di prova con due scadenze. Prima verifica l’autenticazione del pagamento iniziale e poi controlla che il secondo addebito venga processato secondo la configurazione concordata.
Solo dopo aver validato entrambi i pagamenti inizia a utilizzare l’integrazione con prenotazioni reali.
Errori frequenti
La connessione non può essere attivata
Verifica che l'account sia stato completamente approvato dal fornitore e che tu abbia completato tutte le verifiche in sospeso.
Le credenziali non sono valide
Controlla di aver copiato tutti i valori per intero, senza spazi aggiuntivi, interruzioni di riga o caratteri mancanti.
Assicurati anche che siano credenziali di produzione e non di un ambiente di test.
Il pagamento non appare sulla piattaforma
Verifica che la prenotazione utilizzi la piattaforma corretta e che la transazione sia stata effettivamente inviata.
Controlla anche lo stato del pagamento e i possibili messaggi di errore.
3D Secure non viene visualizzato
L'autenticazione può dipendere dal tipo di carta, dal paese, dall'emittente e dalla configurazione della piattaforma.
Verifica con il fornitore che il 3D Secure sia attivo sull'account.
I pagamenti successivi non vengono processati
Verifica che la piattaforma e la modalità operativa consentano di effettuare addebiti successivi.
Su Tilopay, controlla se è stata impostata la modalità E-commerce con CIT e MIT quando necessario.
Mercado Pago non riceve le notifiche
Controlla che:
L'URL del webhook sia corretta.
L'evento Pagos sia selezionato.
La chiave segreta sia valida.
Le credenziali di produzione siano attive.
SysPay non completa l'attivazione
Verifica che SysPay abbia ricevuto il corretto Account ID e Merchant ID.
Quando SysPay attiva il modulo API, avvisa Avantio così possiamo completare l'integrazione.
Se qualcosa non funziona
Se l'integrazione non funziona come previsto, controlla questi punti prima di contattare il team di Customer Experience:
Verifica che l'account sia approvato e attivo.
Assicurati che non ci siano validazioni in sospeso con il fornitore.
Controlla che le credenziali siano corrette e complete.
Assicurati di utilizzare credenziali di produzione.
Verifica che il fornitore abbia attivato l'integrazione o il modulo API.
Controlla che la piattaforma corretta sia associata alla configurazione dei pagamenti.
Verifica lo stato della transazione su Avantio e nel pannello del fornitore.
Aggiorna la pagina e controlla nuovamente il risultato.
Effettua una nuova prenotazione di prova se necessario.
Se il problema persiste, apri un ticket e includi:
Nome dell'azienda.
Piattaforma di pagamento utilizzata.
Data e ora approssimative dell'operazione.
Identificativo della prenotazione.
Importo e valuta.
Stato del pagamento.
Messaggio di errore completo.
Screenshot.
Conferma che l'onboarding sia stato completato.
Non includere password, token completi o altre credenziali sensibili negli screenshot.
Domande frequenti
Devo attivare la piattaforma prima di collegarla con Avantio?
Devo attivare la piattaforma prima di collegarla con Avantio?
Sì. Devi creare o attivare l'account direttamente con il fornitore e completare il processo di onboarding e verifica richiesto.
Avantio si occupa della connessione tecnica, ma non sostituisce il contratto tra la tua azienda e la piattaforma di pagamento.
Quanto tempo richiede l'attivazione?
Quanto tempo richiede l'attivazione?
I tempi dipendono da ciascun fornitore:
Stripe può essere attivato in giornata se l'account Standard è già pronto.
Comercia Global Payments può richiedere circa una settimana.
Tilopay, Ascent e SysPay solitamente richiedono alcuni giorni.
Mercado Pago può essere attivato subito dopo aver ricevuto e configurato le credenziali corrette.
Questi tempi sono indicativi e possono variare.
Posso inviare le credenziali via email?
Posso inviare le credenziali via email?
Utilizza sempre il canale sicuro indicato dal team di Customer Experience.
Non condividere password, token o chiavi sensibili tramite canali non autorizzati.
È obbligatorio effettuare una prenotazione di prova?
È obbligatorio effettuare una prenotazione di prova?
Sì, è fortemente consigliato.
La prenotazione di prova permette di verificare che la piattaforma sia collegata, che il pagamento venga registrato correttamente e che l'autenticazione funzioni prima di gestire prenotazioni reali.
Chi configura la connessione?
Chi configura la connessione?
Dipende dalla piattaforma.
In alcuni casi, Avantio fornisce un link o configura le credenziali. In altri, il fornitore deve prima attivare un modulo o comunicare direttamente con Avantio.
Posso cambiare piattaforma di pagamento?
Posso cambiare piattaforma di pagamento?
Sì, ma prima controlla gli incassi in sospeso e le prenotazioni già esistenti.
Non disattivare la piattaforma precedente finché non hai verificato come verranno gestiti i pagamenti ancora non processati.
Cosa devo fare se cambio una credenziale?
Cosa devo fare se cambio una credenziale?
Contatta il team di Customer Experience di Avantio per aggiornare la configurazione.
Una credenziale modificata o revocata può interrompere l'elaborazione dei pagamenti.
Posso utilizzare più piattaforme contemporaneamente?
Posso utilizzare più piattaforme contemporaneamente?
La disponibilità di questa opzione dipende dalla configurazione del tuo account, dalla struttura della tua azienda e dall'uso previsto.
Contatta il team di Customer Experience così possiamo valutare il tuo caso.