Zum Hauptinhalt springen

Adyen einrichten

Adyen ist einer der Payment Service Provider, die LIKE MAGIC anbindet. Diese Anleitung behandelt den Adyen-spezifischen Teil der Zahlungskonfiguration einer Property, damit Gäste- und Staff-Zahlungen verarbeitet und auf das Folio zurückgeführt werden. Den gemeinsamen Teil beschreibt die Zahlungskonfiguration.

Keiner der beiden Teile ist in der Operations Platform bearbeitbar. LIKE MAGIC pflegt die Werte, jede Änderung hier ist also eine Support Anfrage.

1. Voraussetzungen​

  • Ein aktives Adyen-Konto für die Property oder den Account.
  • Die Adyen-Werte, die die Verbindung braucht (siehe Abschnitt 2).
  • Das PMS der Property verbunden, denn eine Zahlung landet auf dem Folio im PMS.

ℹ️ Hinweis: Ein Account läuft jeweils über einen aktiven Anbieter. Nutze diese Anleitung, wenn der Account auf Adyen läuft, sonst die Anleitung zu Datatrans oder Worldline.

2. Adyen verbinden​

Die Verbindung stellt LIKE MAGIC her. Beantrage sie über eine Support Anfrage und nenne die Werte unten.

Auf Account-Ebene enthält die Verbindung das Adyen-Händlerkonto, die API-Zugangsdaten, den Client Key, den HMAC-Schlüssel, gegen den Adyens Notifications geprüft werden, und die Umgebung (Test oder Live).

Pro Property enthält sie das Händlerkonto (mit Sub-Händler-ID, wo eine genutzt wird), den Ländercode, die Standardwährung und die Liste der erlaubten Zahlungsmethoden, mit einer eigenen Liste für den Self-Service Kiosk.

3. Notifications​

Adyen sendet Notifications an LIKE MAGIC zurück, zum Beispiel die Ergebnisse von Autorisierung und Capture. Jede Notification wird gegen den HMAC-Schlüssel aus der Adyen-Konfiguration des Accounts geprüft, danach wird das Ergebnis an Reservierung und Folio gespiegelt.

ℹ️ Hinweis: Ein falscher oder rotierter HMAC-Schlüssel führt dazu, dass LIKE MAGIC die Notifications abweist, eine autorisierte Zahlung landet dann nie auf dem Folio. Erscheinen Zahlungsergebnisse nicht, ist der Notification-Pfad das Erste, was du über eine Support Anfrage prüfen lässt.

4. Zahlungsmethoden​

Die Zahlungsmethoden, die eine Property über Adyen akzeptiert, sind Teil ihrer Adyen-Konfiguration, als ausdrückliche Positivliste. Der Self-Service Kiosk führt eine eigene Liste, eine Methode kann also in der Gästereise angeboten und am Kiosk zurückgehalten werden oder umgekehrt. Welche Methoden überhaupt möglich sind, hängt davon ab, was das Adyen-Konto der Property unterstützt, und wie jede davon auf dem Folio landet, kommt aus der Zuordnung in der Zahlungskonfiguration.

Um eine Liste zu ändern, beantrage das über eine Support Anfrage und nenne die Property, die Methoden und ob die Änderung auch für den Kiosk gilt.

5. Verbindung verifizieren​

  1. Führe eine Testzahlung über die Gästereise oder eine Staff-seitige Belastung aus.
  2. Bestätige, dass die Zahlung von Adyen autorisiert ist.
  3. Bestätige, dass sie auf dem Folio der Reservierung erscheint (siehe Billing und Folio).

⚠️ Hinweis: Verifiziere einen vollständigen Round-Trip (die Zahlung und die Notification, die sie auf das Folio bucht), bevor die Property live geht. Eine autorisierte Zahlung, die nie aufs Folio gebucht wird, deutet auf den Notification-Pfad.

6. Fazit​

Die Adyen-Verbindung enthält auf Account-Ebene Händlerkonto, Zugangsdaten, Client Key, HMAC-Schlüssel und Umgebung, pro Property Händlerkonto, Land, Währung und erlaubte Zahlungsmethoden. LIKE MAGIC pflegt das alles. Beantrage eine Änderung also über eine Support Anfrage und verifiziere vor dem Go-live, dass eine Zahlung Ende-zu-Ende das Folio erreicht.

Was this article helpful?