- API-Zugangsdaten
- Händlerkonto
- API-Schlüssel
- API-URL-Präfix
- HMAC-Schlüssel
Du verbindest dein Händlerkonto bei Adyen mit TourTask: vier Werte, ein Webhook und eine Testzahlung. Du brauchst ein Live-Konto bei Adyen, kein Testkonto, und bis du es hast, vergehen Wochen.
Ein Live-Konto bei Adyen eröffnen
- 1
Das Vertriebsteam von Adyen kontaktieren
Nutze das Vertriebsformular von Adyen und gib an, dass du Touren verkaufst. Adyen stuft Tourveranstalter als eingeschränkte Branche ein, mit zusätzlichen Unterlagen und einer längeren Prüfung.
- 2
Vor der Unterschrift nach dem Sicherheitseinbehalt fragen
Adyen kann einen Teil deiner Auszahlungen als Sicherheit einbehalten. Bei Touren, die Monate im Voraus bezahlt werden, kann dieser Betrag hoch sein.
Deine Adyen-Daten kopieren
Melde dich in der Customer Area deines Live-Kontos, ca-live.adyen.com, mit einem Benutzer an, der die Rolle Merchant admin hat. Halte jeden Wert bereit: Du trägst sie alle ein, wenn du Adyen nach dem Webhook in TourTask hinzufügst.
- 1
Das Händlerkonto kopieren
Kopiere unter Settings → Merchant accounts den Code des Händlerkontos, nicht den des Unternehmenskontos. Er gehört in TourTask in Händlerkonto.
- 2
Das URL-Präfix kopieren
Kopiere unter Developers → API URLs das Prefix: nur das Präfix, keine vollständige Webadresse. Es gehört in TourTask in API-URL-Präfix.
- 3
Einen API-Zugang anlegen
Wähle dein Unternehmenskonto, gehe zu Developers → API credentials und öffne die Registerkarte Payments. Wähle Create new credential, dann Web service user und anschließend Create credential.
- 4
Den API-Schlüssel generieren
Öffne unter Server settings → Authentication die Registerkarte API key und wähle Generate API key. Adyen zeigt den Schlüssel nur einmal: Kopiere ihn für API-Schlüssel in TourTask und wähle dann in Adyen Save changes.
Den Webhook anlegen
Ohne diesen Webhook wird Reisenden der Betrag belastet, aber ihre Buchungen bleiben unbestätigt.
Deine TourTask-Webhook-Adresse für Adyen
https://api.tourtask.com/v1/payments/adyen/notifications/booking- 1
Einen Standard-Webhook hinzufügen
Gehe in der Customer Area deines Live-Kontos zu Developers → Webhooks, wähle Create new webhook und dann Add neben Standard webhook.
- 2
Für dein Händlerkonto aktivieren
Schalte unter General die Option Enabled ein und achte darauf, dass Merchant accounts dein Händlerkonto enthält.
- 3
Die TourTask-Adresse eintragen
Füge unter Server configuration die TourTask-Adresse von oben als URL ein.
- 4
Den HMAC-Schlüssel generieren
Wähle unter Security das Bearbeiten-Symbol neben HMAC Key und dann Generate. Adyen zeigt den Schlüssel nur einmal: Kopiere ihn für HMAC-Schlüssel in TourTask.
- 5
Save configuration wählen
Überspringe danach Test configuration: Der Test schlägt fehl, auch wenn der Webhook richtig eingerichtet ist.
Adyen in TourTask hinzufügen
- 1
Die Karte Adyen öffnen
Gehe zu Konfiguration → Zahlungsmöglichkeiten und klicke unter Online-Zahlungen → Zahlungsgateways auf die Karte Adyen. Nicht da? Wähle unter den Karten Alle Gateways anzeigen.
- 2
Land und Währung wählen
Wähle unter Land das Land, in dem dein Konto bei Adyen und dessen Bankkonto geführt werden, und unter Währung die Währung, in der Reisende zahlen. Klicke auf Hinzufügen. Um eines davon später zu ändern, entferne Adyen mit Entfernen und füge es neu hinzu.
- 3
API-Zugangsdaten eintragen
Unter Authentifizierung hat die Karte für jede ein Feld:
Händlerkonto
API-Schlüssel
API-URL-Präfix
HMAC-SchlüsselJedes Feld wird gespeichert, sobald du es verlässt.
- 4
Adyen aktivieren
Klicke auf Aktivieren, sobald alle Felder ausgefüllt sind. Die Karte wechselt auf Aktiv, und Reisende können auf deiner Buchungsseite mit Adyen zahlen. Jede Zahlung geht direkt auf dein eigenes Konto bei Adyen: TourTask verwahrt dein Geld nie.
Adyen testen
TourTask hat keinen Testmodus für Adyen. Teste daher mit einer kleinen echten Buchung, die du erstattest.
- 1
Eine Buchung bezahlen
Buche deine günstigste Tour auf deiner eigenen Buchungsseite, wähle Adyen und bezahle mit deiner eigenen Karte. Zurück auf deiner Buchungsseite bestätigt sich die Buchung von selbst.
- 2
Die Zahlung erstatten
Wähle in der Buchung im Aktionsmenü der Zahlung Zahlung erstatten und dann Über Adyen erstatten.
- 3
Die Testbuchung stornieren
Wenn die Testzahlung fehlschlägt
- Die Zahlung schlägt sofort fehl: Prüfe, ob alle vier Werte aus der Customer Area deines Live-Kontos stammen. Händlerkonto muss der Code des Händlerkontos sein, nicht der des Unternehmenskontos.
- Du hast bezahlt, aber die Buchung ist nicht bestätigt: Prüfe in der Customer Area deines Live-Kontos, ob der Webhook auf Enabled steht, dein Händlerkonto enthält und die URL genau wie oben hat. Ist das der Fall, generiere dort einen neuen HMAC Key und füge ihn in TourTask in HMAC-Schlüssel ein. Wähle dann in Adyen Save configuration.
Häufige Fragen
Die, die in der Customer Area von Adyen für dein Händlerkonto eingeschaltet sind. TourTask filtert sie nicht.
Meist ein paar Tage. TourTask erfasst die Erstattung sofort, und deine Adyen Customer Area zeigt, wann das Geld zurückgeflossen ist.
Nein. TourTask leitet Reisende auf die eigene Zahlungsseite von Adyen weiter, daher musst du dafür nichts einrichten.