- API-toegangsgegevens
- Verkopersaccount
- API-sleutel
- API URL-voorvoegsel
- HMAC-sleutel
Je koppelt je verkopersaccount bij Adyen aan TourTask: vier waarden, één webhook en een testbetaling. Je hebt een live Adyen-account nodig, geen testaccount, en het duurt weken om dat te krijgen.
Een live Adyen-account krijgen
- 1
Neem contact op met het verkoopteam van Adyen
Gebruik het verkoopformulier van Adyen en vermeld dat je tours verkoopt. Adyen behandelt touroperators als een branche met beperkingen, met extra documenten en een langere beoordeling.
- 2
Vraag naar de borg voordat je tekent
Adyen kan een deel van je uitbetalingen als borg achterhouden. Bij tours die maanden vooruit worden betaald, kan die hoog zijn.
Je Adyen-gegevens kopiëren
Log in op de live Customer Area, ca-live.adyen.com, met een gebruiker die de rol Merchant admin heeft. Houd elke waarde bij de hand: je vult ze allemaal in wanneer je Adyen na de webhook in TourTask toevoegt.
- 1
Kopieer het verkopersaccount
Kopieer onder Settings → Merchant accounts de code van het verkopersaccount, niet die van het bedrijfsaccount. Die hoort in Verkopersaccount in TourTask.
- 2
Kopieer het URL-voorvoegsel
Kopieer onder Developers → API URLs de Prefix: alleen het voorvoegsel, geen volledig webadres. Die hoort in API URL-voorvoegsel in TourTask.
- 3
Maak een API-credential aan
Selecteer je bedrijfsaccount, ga naar Developers → API credentials en open het tabblad Payments. Selecteer Create new credential, kies Web service user en daarna Create credential.
- 4
Genereer de API-sleutel
Open onder Server settings → Authentication het tabblad API key en selecteer Generate API key. Adyen toont de sleutel maar één keer: kopieer hem voor API-sleutel in TourTask en selecteer daarna Save changes in Adyen.
De webhook aanmaken
Zonder deze webhook worden reizigers wel belast, maar blijven hun boekingen onbevestigd.
Je TourTask-webhookadres voor Adyen
https://api.tourtask.com/v1/payments/adyen/notifications/booking- 1
Voeg een Standard webhook toe
Ga in de live Customer Area naar Developers → Webhooks, selecteer Create new webhook en daarna Add naast Standard webhook.
- 2
Schakel hem in voor je verkopersaccount
Zet onder General de schakelaar Enabled aan en zorg dat je verkopersaccount bij Merchant accounts staat.
- 3
Vul het TourTask-adres in
Plak onder Server configuration het TourTask-adres hierboven als URL.
- 4
Genereer de HMAC-sleutel
Selecteer onder Security het bewerkicoon naast HMAC Key en daarna Generate. Adyen toont de sleutel maar één keer: kopieer hem voor HMAC-sleutel in TourTask.
- 5
Selecteer Save configuration
Sla Test configuration daarna over: die mislukt ook als de webhook goed is ingesteld.
Adyen toevoegen in TourTask
- 1
Open de kaart van Adyen
Ga naar Configuratie → Betaalmogelijkheden en klik onder Online betalingen → Betalingsgateways op de kaart Adyen. Staat hij er niet bij? Kies Toon alle gateways onder de kaarten.
- 2
Kies het land en de valuta
Kies bij Land het land waar je account bij Adyen en de bijbehorende bankrekening zijn, en bij Munteenheid de valuta waarin reizigers betalen. Klik op Toevoegen. Wil je een van beide later wijzigen, verwijder Adyen dan met Verwijderen en voeg het opnieuw toe.
- 3
Vul je API-toegangsgegevens in
Onder Authenticatie heeft de kaart voor elk een veld:
Verkopersaccount
API-sleutel
API URL-voorvoegsel
HMAC-sleutelElk veld wordt opgeslagen zodra je erbuiten klikt.
- 4
Activeer Adyen
Klik op Activeren zodra alle velden zijn ingevuld. De kaart wordt Actief en reizigers kunnen op je boekingspagina met Adyen betalen. Elke betaling komt rechtstreeks op je eigen account bij Adyen: TourTask houdt je geld nooit vast.
Adyen testen
TourTask heeft geen testmodus voor Adyen, dus test met een kleine echte boeking die je terugbetaalt.
- 1
Betaal een boeking
Boek je goedkoopste tour op je eigen boekingspagina, kies Adyen en betaal met je eigen kaart. Terug op je boekingspagina wordt de boeking vanzelf bevestigd.
- 2
Betaal het bedrag terug
Kies op de boeking Betaling terugbetalen in het actiemenu van de betaling en daarna Terugbetalen via Adyen.
- 3
Annuleer de testboeking
Als de testbetaling mislukt
- De betaling mislukt meteen: controleer of alle vier de waarden uit de live Customer Area komen. Verkopersaccount moet de code van het verkopersaccount zijn, niet die van het bedrijfsaccount.
- Je hebt betaald, maar de boeking is niet bevestigd: controleer in de live Customer Area of de webhook op Enabled staat, je verkopersaccount bevat en precies de URL van hierboven heeft. Klopt dat, genereer er dan een nieuwe HMAC Key op en plak die in HMAC-sleutel in TourTask. Selecteer daarna Save configuration in Adyen.
Veelgestelde vragen
De methoden die voor je verkopersaccount aanstaan in de Customer Area van Adyen. TourTask filtert ze niet.
Meestal een paar dagen. TourTask legt de terugbetaling meteen vast, en je Adyen Customer Area toont wanneer het geld is teruggestort.
Nee. TourTask stuurt reizigers naar de eigen betaalpagina van Adyen, dus daarvoor hoef je niets in te stellen.