Configura la tua piattaforma di pagamento
Avantio permette di collegare diverse piattaforme di pagamento per automatizzare gli incassi associati alle prenotazioni.
Il processo di integrazione dipende da ciascun fornitore. Alcune piattaforme richiedono configurazioni specifiche da parte della tua banca, mentre altre necessitano di credenziali di produzione, tokenizzazione, webhooks o un sito web attivo per completare i test.
Prima di iniziare il processo tecnico, devi confermare la compatibilità, formalizzare il contratto relativo e completare l’onboarding richiesto dal fornitore.
Cosa imparerai in questo articolo?
In questo articolo imparerai a:
Preparare le informazioni necessarie prima di iniziare la connessione.
Richiedere le attivazioni necessarie alla tua banca o al fornitore.
Identificare le credenziali richieste per ogni piattaforma.
Configurare webhooks e tokenizzazioni.
Completare la connessione con il supporto di Avantio.
Effettuare i test necessari prima di processare pagamenti reali.
Risolvere gli errori più comuni durante l’integrazione.
Vantaggi
Collegare una piattaforma di pagamento con Avantio ti permetterà di:
Automatizzare gli incassi delle prenotazioni.
Ridurre le operazioni manuali.
Applicare sistemi di autenticazione come 3D Secure.
Centralizzare la configurazione dei pagamenti.
Migliorare la tracciabilità delle transazioni.
Effettuare preautorizzazioni quando la piattaforma lo consente.
Gestire pagamenti successivi secondo la configurazione concordata.
Ricevere notifiche di pagamento in tempo reale.
Facilitare la gestione di rimborsi e problematiche.
Quando dovresti effettuare questa configurazione?
Dovresti iniziare questa configurazione quando:
Hai scelto la piattaforma di pagamento.
Hai confermato che opera nel tuo paese.
Conosci i costi associati.
Il fornitore ha approvato il conto della tua azienda.
Hai le credenziali di produzione.
La tua banca ha effettuato le attivazioni necessarie.
Vuoi sostituire una connessione precedente.
Hai bisogno di automatizzare gli incassi tramite Avantio.
Prima di iniziare
È consigliabile verificare prima:
Che l’azienda sia registrata in un paese compatibile.
Che tu abbia formalizzato il contratto con il fornitore.
Che il processo di onboarding sia completato.
Che tu abbia accesso amministrativo al conto.
Che le credenziali siano relative all’ambiente di produzione.
Che il tuo POS sia compatibile con i protocolli richiesti.
Che tu abbia un sito web attivo quando necessario.
Che tu abbia definito chi gestirà i test.
Che tu conosca i metodi di pagamento che utilizzerai.
Che tu abbia confermato se hai bisogno di preautorizzazioni o tokenizzazione.
È inoltre consigliabile coordinare l’attivazione con il team responsabile di prenotazioni, pagamenti e riconciliazione.
Non condividere mai credenziali sensibili tramite canali non autorizzati. Fornisci le informazioni richieste tramite un ticket indirizzato al team Customer Experience.
Collega la piattaforma scelta con Avantio
Redsys tramite Worldline
Redsys tramite Worldline
L’integrazione permette di collegare un POS Redsys con Avantio Payments utilizzando il connettore fornito da Worldline.
Prima di iniziare
Contatta il team Customer Experience di Avantio per verificare che la tua banca e il tuo POS siano compatibili.
Attualmente, questa integrazione non è disponibile con Banco Sabadell.
Una volta confermata la compatibilità, Avantio ti fornirà il contratto relativo.
Richiedi le attivazioni alla tua banca
Dopo aver firmato il contratto, chiedi alla tua banca le seguenti configurazioni:
Attivazione del protocollo SIS REST PSPS.
Associazione dell’esercente Redsys a PSP OGONE SIS REST CON MPI ESTERNO.
Attivazione delle operazioni MIT.
Attivazione delle operazioni MOTO.
Abilitazione di 3D Secure v2.
Attivazione delle preautorizzazioni.
Le operazioni MOTO sono necessarie per alcune transazioni legate ai portali.
Le preautorizzazioni permettono di effettuare blocchi e sblocchi di importi, ad esempio per la gestione delle cauzioni.
Configurazione aggiuntiva per BBVA
Se la banca acquirente è BBVA, devi richiedere anche l’attivazione del protocollo CVC opzionale.
Se la tua banca necessita di ulteriori informazioni tecniche, può contattare Avantio tramite:
Dati necessari
Una volta che la banca ha confermato le attivazioni, apri un ticket per il team Customer Experience e fornisci:
Merchant ID o FUC.
Codice MCC o categoria dell’esercente.
Numero di terminale.
Metodi di pagamento disponibili.
Acquirer BIN di Visa.
Acquirer BIN di Mastercard.
Indica anche se il POS supporta altri metodi, come American Express.
Segui questi passaggi
Contatta il team Customer Experience di Avantio.
Richiedi la verifica di compatibilità della tua banca.
Conferma che la tua banca può lavorare con il protocollo richiesto.
Rivedi e firma il contratto fornito da Avantio.
Chiedi alla banca l’attivazione del protocollo SIS REST PSPS.
Richiedi l’associazione dell’esercente a PSP OGONE SIS REST CON MPI ESTERNO.
Chiedi l’attivazione di MIT e MOTO.
Richiedi l’abilitazione di 3D Secure v2.
Richiedi l’attivazione delle preautorizzazioni se devi gestire cauzioni.
Se lavori con BBVA, richiedi il CVC opzionale.
Attendi la conferma di tutte le attivazioni da parte della banca.
Raccogli Merchant ID, MCC, numero di terminale e Acquirer BIN.
Fornisci i dati ad Avantio tramite ticket.
Attendi il completamento della configurazione tecnica.
Effettua una prenotazione di prova.
Verifica il funzionamento del pagamento.
Prova le operazioni successive o le preautorizzazioni quando necessario.
Tempo stimato di attivazione
Il processo può richiedere da alcuni giorni a diverse settimane.
La tempistica dipende da:
La velocità di risposta della banca.
La configurazione preesistente del POS.
L’attivazione del protocollo richiesto.
La validazione degli identificativi tecnici.
L’attivazione finale della piattaforma.
Axerve
Axerve
Prima di iniziare
Contatta Axerve per formalizzare il contratto e richiedere l’attivazione del conto.
Quando contatti il fornitore, richiedi anche il servizio di Tokenization se hai bisogno di utilizzare carte tokenizzate per pagamenti successivi.
Una volta approvato il contratto, Axerve ti fornirà l’accesso alla sua intranet o backoffice.
Credenziali necessarie
Dal pannello Axerve devi ottenere:
ShopLogin.
ApiKey.
Inoltre, dovrai configurare una URL di webhook per ricevere le notifiche di pagamento.
Configura il webhook
Il webhook permette ad Axerve di comunicare ad Avantio i cambi di stato delle transazioni in tempo reale.
Richiedi la URL ad Avantio
Apri un ticket per il team Customer Experience.
Indica che stai configurando Axerve.
Richiedi la URL del webhook relativa al tuo account.
Conserva la URL esattamente come ti viene fornita.
Aggiungi la URL in Axerve
Accedi al pannello Axerve.
Vai su Configurazione.
Seleziona Ambiente.
Trova il campo Url server to server.
Copia la URL fornita da Avantio.
Salva la configurazione.
Non modificare la URL e non aggiungere spazi extra.
Segui questi passaggi
Contatta Axerve.
Indica che utilizzerai l’integrazione con Avantio.
Formalizza il contratto.
Richiedi il servizio di tokenizzazione quando necessario.
Completa le verifiche del conto.
Accedi al backoffice di Axerve.
Recupera lo ShopLogin.
Ottieni la ApiKey.
Apri un ticket per il team Customer Experience.
Richiedi la URL del webhook.
Accedi a Configurazione → Ambiente → Url server to server.
Inserisci la URL fornita.
Salva la configurazione.
Fornisci ad Avantio ShopLogin e ApiKey.
Attendi il completamento dell’integrazione.
Effettua una prenotazione di prova.
Verifica che Axerve invii le notifiche di pagamento.
Controlla che lo stato della transazione venga aggiornato in Avantio.
Tempo stimato di attivazione
La connessione può essere completata nello stesso giorno in cui Avantio riceve e valida i dati forniti da Axerve.
La tempistica può aumentare quando:
Il contratto non è ancora approvato.
La tokenizzazione non è attiva.
Le credenziali sono errate.
Il webhook non è configurato.
Il conto non è abilitato per operare in produzione.
Amazon Payment Services
Amazon Payment Services
Prima di iniziare
Contatta Amazon Payment Services per formalizzare il contratto e avviare il processo di onboarding.
Durante questa fase, specifica chiaramente che hai bisogno di utilizzare la tokenizzazione.
La tokenizzazione è necessaria per conservare in modo sicuro un riferimento della carta e poter effettuare le operazioni consentite dalla piattaforma senza memorizzare direttamente i dati sensibili.
Credenziali necessarie
Per attivare la connessione ti servono:
MerchantId.
AccessCode.
ShaRequest.
ShaResponse.
Le credenziali devono essere relative all’ambiente di produzione, a meno che non vengano richiesti prima dati specifici per i test.
Segui questi passaggi
Contatta Amazon Payment Services.
Conferma che la piattaforma sia disponibile nel tuo paese.
Comunica che utilizzerai l’integrazione con Avantio.
Formalizza il contratto.
Completa la documentazione per l’onboarding.
Richiedi l’attivazione della tokenizzazione.
Attendi l’approvazione dell’account da parte di Amazon Payment Services.
Richiedi le credenziali di integrazione.
Verifica di avere MerchantId, AccessCode, ShaRequest e ShaResponse.
Apri 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.
Completa l’autenticazione 3D Secure.
Verifica che la transazione venga visualizzata correttamente.
Controlla il funzionamento della tokenizzazione quando necessario.
Attenzione ai dettagli
Tutti i pagamenti elaborati tramite questo gateway utilizzeranno di default il 3D Secure.
Assicurati che il flusso di prenotazione consenta all’ospite di completare correttamente l’autenticazione.
Tempo stimato di attivazione
L’attivazione richiede solitamente alcuni giorni.
I tempi dipendono principalmente dal completamento dell’onboarding, dall’attivazione della tokenizzazione e dalla consegna delle credenziali.
PowerTranz
PowerTranz
PowerTranz è la versione di FAC compatibile con 3D Secure v2.
Sostituisce la precedente integrazione FAC, che supportava solo 3D Secure v1.
Prima di iniziare
Per completare l’integrazione devi avere un sito web funzionante.
Il sito verrà utilizzato per effettuare i test:
Nell’ambiente di test.
Nell’ambiente reale o di produzione.
Conferma con PowerTranz che il tuo account e il tuo mercato siano compatibili con la versione che supporta 3D Secure v2.
Credenziali necessarie
Richiedi a PowerTranz:
PowerTranzId.
PowerTranzPassword.
Le credenziali devono essere relative all’ambiente indicato per ogni fase dei test.
Segui questi passaggi
Contatta PowerTranz per avviare il processo di onboarding.
Comunica che utilizzerai l’integrazione con Avantio.
Conferma che attiverai la versione compatibile con 3D Secure v2.
Fornisci a PowerTranz la documentazione richiesta.
Prepara un sito web funzionante.
Richiedi le credenziali per l’ambiente di test.
Ottieni PowerTranzId e PowerTranzPassword.
Apri un ticket per il team Customer Experience di Avantio.
Fornisci le credenziali tramite il canale sicuro indicato.
Coordina con Avantio i test nell’ambiente di prova.
Verifica che il processo di autenticazione funzioni correttamente.
Completa con PowerTranz l’attivazione dell’ambiente di produzione.
Fornisci le credenziali definitive se sono diverse.
Effettua un test nell’ambiente reale.
Verifica che il pagamento sia visibile sia in Avantio che in PowerTranz.
Conferma con Avantio che l’integrazione può essere utilizzata.
Risultato atteso
Al termine del processo:
PowerTranz sarà collegato con Avantio.
I pagamenti utilizzeranno 3D Secure v2.
Potrai elaborare carte nelle valute supportate.
Le transazioni saranno registrate nel pannello del fornitore.
Il sito sarà pronto per completare il flusso di autenticazione.
Risultato atteso
Al termine della connessione della piattaforma selezionata:
Il gateway sarà collegato con Avantio.
Potrai gestire i pagamenti delle prenotazioni.
Gli incassi utilizzeranno l’autenticazione disponibile.
Le transazioni saranno inviate al fornitore corrispondente.
I cambi di stato verranno aggiornati tramite il meccanismo configurato.
Potrai effettuare le operazioni previste dal tuo contratto.
I pagamenti successivi o le preautorizzazioni funzioneranno quando abilitati.
Non considerare conclusa l’integrazione finché non hai completato correttamente una prenotazione di prova.
Prossimi passi consigliati
Dopo aver attivato la piattaforma:
Effettua una prenotazione di prova con un importo ridotto.
Verifica che il pagamento sia visibile in Avantio.
Controlla che l’operazione sia presente nel pannello del fornitore.
Conferma che importo e valuta siano corretti.
Verifica il funzionamento del 3D Secure.
Controlla le notifiche del webhook quando previsto.
Prova la tokenizzazione se l’hai attivata.
Verifica i pagamenti successivi.
Prova una preautorizzazione se la piattaforma lo consente.
Controlla la procedura di rimborso.
Conferma i permessi degli utenti interni.
Documenta la procedura per gestire eventuali problemi.
Informa il tuo team prima di iniziare a gestire pagamenti reali.
Dati e opzioni principali
A seconda della piattaforma, ti serviranno:
Redsys tramite Worldline: Merchant ID o FUC, MCC, numero di terminale, metodi di pagamento e Acquirer BIN.
PowerTranz: PowerTranzId e PowerTranzPassword.
Amazon Payment Services: MerchantId, AccessCode, ShaRequest e ShaResponse.
Axerve: ShopLogin, ApiKey e URL del webhook.
Potresti inoltre aver bisogno di:
Attivazione MIT.
Attivazione MOTO.
Configurazione 3D Secure v2.
Attivazione delle preautorizzazioni.
Tokenizzazione.
Sito web funzionante.
Credenziali di test e produzione.
Configurazione server-to-server.
Limitazioni e considerazioni
Tieni presente che:
L’integrazione non può essere completata finché il fornitore non approva l’account.
I tempi dipendono dal fornitore o dalla banca.
Le credenziali devono essere relative all’ambiente corretto.
Dati errati possono impedire la connessione.
L’attivazione del 3D Secure dipende dalla configurazione dell’account.
La tokenizzazione va richiesta quando necessaria.
Le operazioni MIT e MOTO richiedono autorizzazione specifica.
Le preautorizzazioni non sono disponibili se la banca non le abilita.
I webhook devono essere configurati esattamente con la URL fornita.
PowerTranz richiede un sito web funzionante per i test.
Redsys necessita di configurazioni specifiche da parte della banca.
Amazon Payment Services utilizza di default il 3D Secure.
Non gestire pagamenti reali prima di aver completato i test.
La modifica di una credenziale può interrompere gli incassi.
Prima di sostituire un gateway esistente, verifica cosa succede ai pagamenti in sospeso delle prenotazioni già create.
Buone pratiche
Conferma la compatibilità prima di iniziare il processo.
Utilizza sempre un account aziendale.
Completa l’onboarding prima di richiedere la connessione.
Richiedi credenziali di produzione.
Non condividere password o chiavi su canali non autorizzati.
Copia le credenziali senza spazi aggiuntivi.
Salva le chiavi in un gestore sicuro.
Limita gli accessi amministrativi.
Attiva l’autenticazione a due fattori quando disponibile.
Configura correttamente il 3D Secure v2.
Richiedi la tokenizzazione fin dall’inizio se ti serve.
Effettua test in tutti gli ambienti necessari.
Verifica i webhook dopo l’attivazione.
Controlla sia i pagamenti iniziali che quelli successivi.
Documenta le modifiche effettuate dalla tua banca.
Non disattivare la connessione precedente finché non hai validato la nuova.
Caso pratico
Un’azienda spagnola vuole mantenere le condizioni del suo POS Redsys e automatizzare gli incassi tramite Avantio Payments.
Per prima cosa, contatta Avantio per confermare che la sua banca sia compatibile.
Dopo aver firmato il contratto, richiede alla banca l’attivazione del protocollo SIS REST PSPS, MIT, MOTO, 3D Secure v2 e preautorizzazioni.
Quando la banca conferma la configurazione, l’azienda fornisce ad Avantio il Merchant ID, l’MCC, il numero di terminale e gli Acquirer BIN.
Avantio completa la configurazione e l’azienda effettua una prenotazione di prova. Verifica anche una preautorizzazione per assicurarsi di poter bloccare e sbloccare correttamente una cauzione.
Dopo aver verificato tutte le operazioni, inizia a utilizzare la connessione con prenotazioni reali.
Errori frequenti
La banca non conosce il protocollo richiesto
Fornisci alla banca il nome completo del protocollo e le operazioni che deve abilitare.
Se necessario, la banca può contattare Avantio tramite [email protected].
Redsys non processa i pagamenti successivi
Verifica che le operazioni MIT siano attivate.
Controlla anche la configurazione MOTO quando le transazioni sono collegate a determinati portali.
La preautorizzazione non funziona
Conferma con la banca che le preautorizzazioni siano abilitate sul terminale corrispondente.
L’attivazione generale del POS non implica necessariamente che questa operazione sia disponibile.
Il pagamento non completa il 3D Secure
Verifica che il 3D Secure v2 sia attivo sull’account e che il fornitore abbia configurato correttamente l’autenticazione.
PowerTranz non riesce a completare i test
Verifica che la pagina web sia operativa e accessibile.
Controlla anche di utilizzare la versione di PowerTranz compatibile con 3D Secure v2.
Le credenziali di PowerTranz non funzionano
Conferma se le credenziali appartengono all’ambiente di test o a quello reale.
Non utilizzare credenziali di test per processare pagamenti in produzione.
Amazon Payment Services rifiuta la connessione
Verifica che MerchantId, AccessCode, ShaRequest e ShaResponse siano completi e appartengano allo stesso account.
Controlla anche che l’onboarding sia stato completato.
Non è possibile processare pagamenti successivi con Amazon Payment Services
Conferma che la tokenizzazione sia attivata.
Aver attivato la piattaforma non implica necessariamente che il servizio di tokenizzazione sia abilitato.
Axerve non aggiorna lo stato dei pagamenti
Controlla la configurazione del webhook.
L’URL deve essere aggiunta in:
Configurazione → Ambiente → Url server to server
L’ApiKey di Axerve non è valida
Verifica che la chiave sia di produzione e che non contenga spazi o caratteri aggiuntivi.
La prenotazione di prova funziona, ma il pagamento reale no
Conferma che la prova non sia stata effettuata solo in ambiente di test.
Verifica che l’account e le credenziali di produzione siano attivi.
Se qualcosa non funziona
Prima di contattare il team di Customer Experience:
Verifica che il contratto sia stato formalizzato.
Controlla che l’onboarding sia completo.
Conferma che l’account sia stato approvato.
Verifica che le credenziali siano corrette.
Controlla se appartengono all’ambiente di test o produzione.
Verifica che il 3D Secure v2 sia attivo.
Conferma che la tokenizzazione sia abilitata quando necessario.
Controlla le configurazioni effettuate dalla banca.
Verifica l’URL del webhook.
Conferma che la pagina web sia operativa.
Controlla lo stato della transazione nel pannello del fornitore.
Aggiorna la pagina e ricontrolla il risultato.
Effettua una nuova prenotazione di prova.
Se il problema persiste, apri un ticket e includi:
Nome dell’azienda.
Piattaforma utilizzata.
Banca o acquirer, se applicabile.
Identificativo della prenotazione.
Data e ora dell’operazione.
Importo e valuta.
Stato della transazione.
Messaggio di errore completo.
Screenshot.
Ambiente in cui si è verificato l’errore.
Conferma delle attivazioni effettuate.
Non includere password, ApiKey complete o altre credenziali sensibili negli screenshot.
Domande frequenti
Devo stipulare il contratto della piattaforma prima di collegarla?
Devo stipulare il contratto della piattaforma prima di collegarla?
Sì. Devi formalizzare il contratto e completare l’onboarding direttamente con la banca o il fornitore.
Avantio si occupa dell’integrazione tecnica, ma non sostituisce il contratto commerciale.
Quanto tempo richiede l’attivazione?
Quanto tempo richiede l’attivazione?
Dipende dalla piattaforma:
Redsys tramite Worldline può richiedere giorni o settimane.
PowerTranz può richiedere diversi giorni e varie fasi di test.
Amazon Payment Services solitamente richiede alcuni giorni.
Axerve può essere attivato in giornata dopo aver ricevuto i dati corretti.
I tempi sono indicativi.
Cos’è la tokenizzazione?
Cos’è la tokenizzazione?
La tokenizzazione sostituisce i dati di una carta con un riferimento sicuro.
Permette di effettuare alcune operazioni successive senza memorizzare direttamente le informazioni sensibili della carta.
Cos’è un webhook?
Cos’è un webhook?
Un webhook è un URL che permette alla piattaforma di inviare notifiche automatiche ad Avantio quando cambia lo stato di un pagamento.
In Axerve, deve essere configurato nella sezione Url server to server.
Qual è la differenza tra MIT e MOTO?
Qual è la differenza tra MIT e MOTO?
MIT sono transazioni avviate dall’esercente su una carta precedentemente autorizzata.
MOTO viene utilizzato per alcune operazioni in cui il pagamento viene avviato tramite canali come email o telefono. In questa integrazione, può essere necessario per processare alcune transazioni provenienti da portali.
A cosa servono le preautorizzazioni?
A cosa servono le preautorizzazioni?
Permettono di bloccare temporaneamente un importo senza effettuare l’addebito definitivo.
Possono essere utilizzate, ad esempio, per gestire cauzioni e successivamente liberare l’importo bloccato.
È obbligatorio effettuare una prenotazione di prova?
È obbligatorio effettuare una prenotazione di prova?
Sì, è fortemente consigliato.
La prenotazione di prova permette di verificare il pagamento, l’autenticazione, le notifiche e le operazioni successive prima di lavorare con prenotazioni reali.
Posso inviare le credenziali via email?
Posso inviare le credenziali via email?
Utilizza solo il canale sicuro indicato dal team di Customer Experience.
Non inviare password o chiavi sensibili tramite canali non autorizzati.
Chi può aiutarmi durante la connessione?
Chi può aiutarmi durante la connessione?
Puoi contattare il tuo Account Manager o il team di Customer Experience di Avantio.
Possiamo aiutarti tramite ticket di supporto o, se necessario, con una videochiamata.