Adyen

So nimmst du Kartenzahlungen mit Adyen an

Nimm Kartenzahlungen über dein eigenes Adyen-Händlerkonto an.

Länder

  • Australien
  • Belgien
  • Brasilien
  • Bulgarien
  • Dänemark

Währungen

  • AED
  • AUD
  • BRL
  • CAD
  • CHF
  • CZK
  • DKK
DokumentationKontakt
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.

Adyen ist auf große Umsätze ausgelegt

Bei Adyen kannst du dich nicht selbst registrieren. Adyen veröffentlicht seinen Mindestrechnungsbetrag nicht: Frag das Vertriebsteam. Für die meisten kleinen Veranstalter ist ein anderes Zahlungsgateway die bessere Wahl.

Ein Live-Konto bei Adyen eröffnen


  1. 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. 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. 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. 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. 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. 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. 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. 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. 3

    Die TourTask-Adresse eintragen

    Füge unter Server configuration die TourTask-Adresse von oben als URL ein.

  4. 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. 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. 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. 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. 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üssel

    Jedes Feld wird gespeichert, sobald du es verlässt.

  4. 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. 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. 2

    Die Zahlung erstatten

    Wähle in der Buchung im Aktionsmenü der Zahlung Zahlung erstatten und dann Über Adyen erstatten.

Erst erstatten, dann stornieren

Eine stornierte Buchung lässt sich nicht über Adyen erstatten.

  1. 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.

War diese Seite hilfreich?