- Credenziali API
- Conto commerciante
- Chiave API
- Prefisso URL dell'API
- Chiave HMAC
Collegherai il tuo conto merchant Adyen a TourTask: quattro valori, un webhook e un pagamento di prova. Ti serve un account Adyen live, non di test, e per ottenerlo servono settimane.
Ottenere un account Adyen live
- 1
Contatta il team commerciale di Adyen
Usa il modulo di contatto commerciale di Adyen e indica che vendi tour. Adyen considera i tour operator un’attività soggetta a restrizioni, con documenti aggiuntivi e una verifica più lunga.
- 2
Chiedi del deposito cauzionale prima di firmare
Adyen può trattenere una parte dei tuoi accrediti come deposito cauzionale. Per tour pagati con mesi di anticipo, può essere consistente.
Copiare i tuoi dati Adyen
Accedi alla Customer Area live, ca-live.adyen.com, con un utente che ha il ruolo Merchant admin. Tieni ogni valore a portata di mano: li inserisci tutti quando aggiungi Adyen in TourTask, dopo il webhook.
- 1
Copia il conto merchant
In Settings → Merchant accounts, copia il codice del conto merchant, non quello dell’account aziendale. Va in Conto commerciante in TourTask.
- 2
Copia il prefisso dell’URL
In Developers → API URLs, copia il Prefix: solo il prefisso, non un indirizzo web completo. Va in Prefisso URL dell’API in TourTask.
- 3
Crea una credenziale API
Seleziona il tuo account aziendale, vai in Developers → API credentials e apri la scheda Payments. Seleziona Create new credential, scegli Web service user, poi Create credential.
- 4
Genera la chiave API
In Server settings → Authentication, apri la scheda API key e seleziona Generate API key. Adyen mostra la chiave una sola volta: copiala per Chiave API in TourTask, poi seleziona Save changes in Adyen.
Creare il webhook
Senza questo webhook, ai viaggiatori viene addebitato il pagamento ma le loro prenotazioni restano non confermate.
Il tuo indirizzo webhook TourTask per Adyen
https://api.tourtask.com/v1/payments/adyen/notifications/booking- 1
Aggiungi un webhook Standard
Nella Customer Area live, vai in Developers → Webhooks, seleziona Create new webhook, poi Add accanto a Standard webhook.
- 2
Abilitalo per il tuo conto merchant
In General, attiva Enabled e verifica che Merchant accounts includa il tuo.
- 3
Inserisci l’indirizzo TourTask
In Server configuration, incolla l’indirizzo TourTask qui sopra come URL.
- 4
Genera la chiave HMAC
In Security, seleziona l’icona di modifica accanto a HMAC Key, poi Generate. Adyen mostra la chiave una sola volta: copiala per Chiave HMAC in TourTask.
- 5
Seleziona Save configuration
Poi salta Test configuration: fallisce anche quando il webhook è corretto.
Aggiungere Adyen in TourTask
- 1
Apri il riquadro di Adyen
Vai su Configurazione → Opzioni di pagamento e fai clic sul riquadro Adyen in Pagamenti online → Gateway di pagamento. Non c’è? Scegli Mostra tutti i gateway sotto i riquadri.
- 2
Scegli il paese e la valuta
In Paese scegli il paese del tuo account Adyen e del relativo conto bancario, e in Valuta la valuta in cui pagano i viaggiatori. Fai clic su Aggiungi. Per cambiarli in seguito, rimuovi Adyen con Rimuovi e aggiungilo di nuovo.
- 3
Inserisci le tue credenziali API
In Autenticazione, il riquadro ha un campo per ciascuna:
Conto commerciante
Chiave API
Prefisso URL dell'API
Chiave HMACOgni campo si salva quando fai clic fuori da esso.
- 4
Attiva Adyen
Fai clic su Attiva quando tutti i campi sono compilati. Il riquadro passa a Attivo e i viaggiatori possono pagare con Adyen sulla tua pagina di prenotazione. Ogni pagamento arriva direttamente sul tuo account Adyen: TourTask non trattiene mai il tuo denaro.
Provare Adyen
TourTask non ha una modalità di test per Adyen, quindi fai una prova con una piccola prenotazione reale che poi rimborsi.
- 1
Paga una prenotazione
Prenota il tuo tour più economico sulla tua pagina di prenotazione, scegli Adyen e paga con la tua carta. Quando torni sulla pagina di prenotazione, la prenotazione si conferma da sola.
- 2
Rimborsa il pagamento
Nella prenotazione, scegli Rimborsa il pagamento nel menu delle azioni del pagamento, poi Rimborsa tramite Adyen.
- 3
Annulla la prenotazione di prova
Se il pagamento di prova non va a buon fine
- Il pagamento fallisce subito: verifica che tutti e quattro i valori provengano dalla Customer Area live. Conto commerciante deve contenere il codice del conto merchant, non quello dell’account aziendale.
- Hai pagato, ma la prenotazione non è confermata: nella Customer Area live, verifica che il webhook sia Enabled, includa il tuo conto merchant e abbia l’URL esattamente come sopra. Se è così, genera una nuova HMAC Key per il webhook e incollala in Chiave HMAC in TourTask. Poi seleziona Save configuration in Adyen.
Domande frequenti
Quelli attivati per il tuo conto merchant nella Customer Area di Adyen. TourTask non li filtra.
Di solito qualche giorno. TourTask registra subito il rimborso, e la tua Customer Area di Adyen mostra quando il denaro è stato restituito.
No. TourTask manda i viaggiatori alla pagina di pagamento di Adyen, quindi non c’è nulla da configurare per questo.