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, vorbereitet wie in 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-Konto vorbereiten​

Einige Werte, die die Verbindung braucht, entstehen erst, wenn du sie in der Adyen Customer Area anlegst. Führe die Schritte unten für jedes Händlerkonto aus, das die Property nutzt. Eine Property, die Zahlungen am Terminal annimmt, hat neben dem E-Commerce-Händlerkonto ein POS-Händlerkonto, und jedes braucht eigene Zugangsdaten.

a) API-Zugangsdaten​

  1. Wähle das Händlerkonto aus.

    Die Seitenleiste der Adyen Customer Area mit der Auswahl des Händlerkontos oben und hervorgehobenem Eintrag Developers > API credentials

  2. Öffne Developers > API credentials und klicke auf Create new credential.

    Die Seite API credentials mit der Schaltfläche Create new credential

  3. Behalte den Standardtyp Web service user bei und gib eine Beschreibung ein.

    Der Dialog Create API credential mit ausgewähltem Web service user und leerem Feld Description

  4. Kopiere unter Server settings > Authentication den API Key mit der Kopier-Schaltfläche und bewahre ihn an einem sicheren Ort auf. Adyen zeigt den Schlüssel nur einmal an, und ein von Hand markierter Schlüssel ist oft unvollständig.

    Das Feld API key mit einem Pfeil auf die Kopier-Schaltfläche, darunter der Hinweis von Adyen, den Schlüssel jetzt zu sichern

  5. Klicke unter Client settings auf Generate client key und trage die Adresse der Gästereise der Property (zum Beispiel https://my.guest.example.com) als allowed origin ein. Der Client Key bleibt später sichtbar. Für ein POS-Händlerkonto entfällt dieser Schritt.

    Der Abschnitt Client settings mit der Schaltfläche Generate client key und dem Feld Add allowed origins

  6. Wähle unter Roles die Rollen unten aus. Merchant PAL Webservice role ist bereits vorausgewählt.

    • "Management API - Webhooks read"
    • "Management API - Webhooks read and write"
    • "Checkout encrypted cardholder data"
    • "Checkout webservice role"
    • "Data Protection API"
    • "Merchant Recurring role"

    Der Abschnitt Roles mit ausgewählten Rollen Webhooks read, Webhooks read and write sowie den Checkout-, Data-Protection- und Recurring-Rollen

  7. Speichere die Änderungen.

⚠️ Warnung: Der API Key autorisiert Zahlungen auf dem Händlerkonto. Gelangt er in falsche Hände, widerrufe ihn sofort in Adyen, lege einen neuen an und sende den neuen Schlüssel an LIKE MAGIC.

b) Webhook​

  1. Öffne Developers > Webhooks, klicke auf + Webhook und füge einen Standard webhook hinzu.

    Das Menü Developers mit hervorgehobenem Eintrag Webhooks

    Die Seite Webhooks mit der Schaltfläche + Webhook

    Der Dialog Create new webhook mit der Schaltfläche Add beim Standard webhook

  2. Gib unter General eine Beschreibung ein.

  3. Trage unter Server configuration die Webhook-URL ein, die LIKE MAGIC dir für deinen Account nennt. Die übrigen Einstellungen bleiben unverändert.

  4. Erzeuge unter Security > HMAC für den ersten Webhook einen neuen Schlüssel und bewahre ihn an einem sicheren Ort auf. Wähle für jedes weitere Händlerkonto Use an existing key und denselben Schlüssel (die Liste nennt jeden Schlüssel mit seinem Prüfwert, KCV).

    Der Abschnitt HMAC mit ausgewählter Option Generate a new key und der Schaltfläche Generate

    Der Abschnitt HMAC mit ausgewählter Option Use an existing key und dem Auswahlfeld für den Schlüssel

  5. Klicke auf Save configuration.

c) Zusätzliche Daten​

Öffne Developers > Additional data, wähle die Optionen unten aus und klicke auf Save configuration. Damit sendet Adyen die Karten- und Zuschlagsdetails, die LIKE MAGIC zu jeder Zahlung festhält.

Die Seite Additional data mit ausgewählten Optionen der Gruppe Payment

  • Card holder name
  • Card summary
  • Expiry date
  • Variant
  • Card bin
  • Issuer bin
  • Issuer country/region
  • Card bin details
  • Payment account reference
  • Card bin payout details
  • Recurring contract information
  • Include alias info
  • Return adjust authorisation data
  • Include Extra Costs
  • Include Extra Costs Gratuity
  • Include Extra Costs Surcharge
  • Surcharge amount

d) API-URL-Präfix​

Öffne Developers > API URLs und notiere das dort angezeigte Präfix. LIKE MAGIC braucht es, um dein Live-Konto zu erreichen.

Das Menü Developers mit hervorgehobenem Eintrag API URLs neben der Seite API URLs

e) Zahlungsterminals​

Für eine Property, die Zahlungen an einem Adyen-Terminal annimmt (zum Beispiel am Self-Service Kiosk):

  • Aktiviere in den Terminal settings im Bereich Integrations die Option WebSockets.

    Der Bereich Integrations der Terminal settings mit Enable WebSockets auf Enabled

  • Setze den Min. Amount des POS-Händlerkontos auf 0.00.

    Die Transaction and MKE Limits der Einstellungen Payment features mit Min. amount auf 0

  • Erhebt die Property einen Zuschlag auf Kartenzahlungen, bitte Adyen, Surcharging auf dem Terminal zu aktivieren. Adyen stellt das am Terminal selbst ein.

3. Adyen verbinden​

Die Verbindung stellt LIKE MAGIC her. Beantrage sie über eine Support Anfrage und übergib die Werte, die du in Abschnitt 2 vorbereitet hast.

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.

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

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

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

7. Fazit​

API-Zugangsdaten, Webhook und HMAC-Schlüssel legst du in Adyen für jedes Händlerkonto an. Die Verbindung enthält dann 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?