Mit der Amadeus III Version 1.7.0 wurde die Adyen-Schnittstelle angebunden.


Benötigte Kassenversion:     mind. 1.7.0



Nachfolgend sind die Einstellungen erläutert, um Adyen anzubinden.


INHALTSVERZEICHNIS


Zertifikat Einrichten

Nachfolgend wird die Einrichtung des Adyen-Zertifikates erläutert. 


Zertifikat herunterladen

Laden Sie die Zertifikatsdatei unter nachfolgendem Link runter: adyen-terminalfleet-live.pem 

-> rechtsklick auf den Link, "Link speichern unter..." wählen und einen beliebigen Speicher-Ort auf dem Kassenserver wählen. 



Zertifikat einlesen

Klicken Sie in der Windows-Taskleiste auf "Suchen", geben Sie den Befehl "mmc" ein und bestätigen Sie die Eingabe durch drücken der "Enter-Taste".

> Eventuelle Benutzerkontensteuerung mit "JA" bestätigen


In der Konsole gehen Sie wie folgt vor:

-> Datei

-> Snap-In hinzufügen/entfernen


-> In den verfügbaren Snap- Ins unten auf "Zertifikate" klicken

-> Mittig auf "Hinzufügen" klicken


Im Dialog "Computerkonto" wählen.



Auf "Weiter" klicken und dann bestätigen ohne Änderungen in der Auswahl vorzunehmen


Das Fenster "Snap-Ins hinzufügen bzw. entfernen mit "OK" schließen.



In der Konsole

-> Zertifikate ( Lokaler Computer )

-> Vertrauenswürdige Stammzertifizierungsstellen

-> Zertifikate auswählen.


In Konsole unter Aktion

-> Alle Aufgaben

-> Importieren


In der Maske "Willkommen" auf "Weiter" klicken.


-> Anschließend auf "Durchsuchen" klicken und das heruntergeladene Zertifikat auswählen und auf "Weiter" klicken. 


Im nächsten Schritt direkt den Button "Weiter" anklicken. 



Zuletzt den Button "Fertig stellen" anklicken. 


Das Zertifikat wurde nun erfolgreich hinzugefügt. 




Einstellung im ReportingLight

Zahlungsprovider anlegen

Melden Sie sich im Reporting light an und wechseln sie in "Stammdaten > Zahlungsprovider" und klicken Sie auf "Neu". 

Vergeben Sie einen beliebigen Namen und stellen Sie den Typ "ADYEN" ein. 

Die Felder "Amadeus-Id, Schlüssel-Id, Passwort, Schlüssel-Version" werden anhand des Adyen-Portals gepflegt. 

Bei "FuncNummer" ist die Funktionsnummer des Berichtes einzutragen, der mit dem Tagesabschluss gedruckt werden soll. Alternativ lässt sich der Adyen-Transaktionsbericht auch über das Adyen-Portal abrufen. 


Die Amadeus-Id ist der Storename der bei Adyen hinterlegt ist. Schlüssel-Id, Passwort und Schlüssel-Version (Key = Version) können im Portal von Adyen unter "Point of sale > Terminal settings > Integrations" im Bereich "Terminal API" und dem Unterpunkt "Encryption key" angepasst/entnommen werden. Um die Daten einzusehen/anzupassen, muss der Schalter von Encrypted auf Decrypted geschoben werden. 


Außerdem muss zwingend der Parameter "Enable terminal API" auf "Enabled" stehen, zu finden im Portal von Adyen unter "Point of sale > Terminal settings > Integrations" im Bereich "Terminal API".



Um ein Terminal anzulegen, im ReportingLight im Zahlungsprovider den Button "Hinzufügen" anklicken.

Als Name ist zwingend die Bezeichnung aus dem Web-Portal von Adyen einzutragen (Point of Sales > Terminals > Terminal auswählen > Terminalname erscheint als Überschrift). In das Feld IP ist die IP-Adresse einzutragen, die dem Terminal vergeben wurde. Im Feld Port ist 8443 zu hinterlegen. In der Terminal-Liste sind die Kassen auszuwählen (Mehrfachauswahl durch Drücken der STRG-Taste und Anklicken der gewünschten Terminals), an denen das Kartenterminal zum bezahlen eingesetzt werden darf. 


Der Name des Terminals ist innerhalb der Settings im Adyen-Portal einsehbar.



Finanzweg anlegen

Finanzweg für die Zahlung per Adyen anlegen, Finanzart Kartenzahlung/Bargeldlos, Abrechnungsfaktor -1 und zuvor erstellten Zahlungsprovider zuordnen. 


Wird im Dropdown-Menü "Rückgeld als Trinkgeld" der Finanzweg Trinkgeld hinterlegt, so wird im Falle, dass der Tisch "überzahlt" wird der Differenzbetrag automatisch als Trinkgeld gebucht. 
Ist eine Standardrechnung eingestellt, wird nach erfolgreicher Zahlung automatisch die Rechnung am Bondrucker ausgelöst.



Rechnungsdesign anpassen

Damit der Ausdruck von Händler- und Kundenbeleg am Kassendrucker erfolgt, muss im Rechnungsdesign, in der Sektion Fusszeile der Datensatz "Elektr. Zahlung" eingefügt werden und darin die Felder "elpay.client" (Kundenbeleg) und "elpay.dealer" (Händlerbeleg) sowie einen "fulltcut", damit die Belege beim Ausdrucken voneinander getrennt werden.


Optional

Negative Zahlung zulassen (z.B. Pfandrückgabe)

Um negative Zahlungen für z.B. Pfandrückgabe zu ermöglichen, muss von Adyen die Erstattung (Refund) freigeschalten werden. Hierzu muss der Support von Adyen kontaktiert werden, mit der Bitte um Freischaltung der "unreferenced refunds". Sobald Adyen die Freischaltung bestätigt hat, muss das Adyen-Terminal geupdatet werden. Das Update kann durchgeführt werden, in dem man am Terminal den Ziffernblock öffnet, die Zahl 9 eingibt und die Eingabe mit dem Grünen-Kreis-Button/Knopf bestätigt. Anschließend muss das Admin-Kennwort eingegeben werden (in Passcodes in den Terminal-Settings im Adyen Portal einsehbar). Im Admin-Menü auf "Config" tippen und anschließend auf "Update". Sobald das Terminal wieder verbunden ist, sind die Einstellungen vom Portal im Terminal aktualisiert. 


Display Messages

Die Display Messages können im Adyen Portal eingestellt werden. 


Adyen-Portal Einstellungen

Unter "Point of Sales" > "Terminals" > das gewünschtes Terminal auswählen. 

Anschließend in der Terminal Settings Navigation auf "Integrations" und die "Terminal Api"-Box auf "Decrypted" stellen. 

Unterhalb der Überschrift "Display URLs" den Button "Add new" anklicken. Es wird eine neue Display-URL-Zeile hinzugefügt. Am Ende der hinzugefügten Zeile den Bleistift-Button anklicken. Im sich öffnenden Fenster muss im Feld "URL" "http:// + IP-Adresse des Kassenservers + :1111/adyen/displayNotification" eingestellt werden. Am Ende der Box muss der RadioButton "Local" aktiviert und über den Button "Edit URL" die Eingabe bestätigt/gespeichert werden.


Die Einstellungen müssen nun im Adyen-Terminal geupdatet werden. Das Update kann durchgeführt werden, in dem man am Terminal den Ziffernblock öffnet, die Zahl 9 eingibt und die Eingabe mit dem Grünen-Kreis-Button/Knopf bestätigt. Anschließend muss das Admin-Kennwort eingegeben werden (in Passcodes in den Terminal-Settings im Adyen Portal einsehbar). Im Admin-Menü auf "Config" tippen und anschließend auf "Update". Sobald das Terminal wieder verbunden ist, sind die Einstellungen vom Portal im Terminal aktualisiert.


Anwendung am Kassen-Terminal


Zahlvorgang

  • Tisch aufrufen, der per Kartenzahlung abgerechnet werden soll.
  • Die Finanzweg-Liste öffnen,
  • den Zahlungsweg der mit Adyen verknüpft ist auswählen, 
  • Zahlvorgang wird am Kartenterminal eingeleitet. 
  • Sollte die Trinkgeld-Eingabe am Terminal eingeschalten sein (wenn nicht, weiter mit nächstem Punkt), nun das Trinkgeld über den Ziffernblock des Kartenterminals eingeben und mit der grünen Taste bestätigen.
  • Karte in Terminal einstecken, durchziehen oder auflegen (je nach Freischaltung). 
  • Bei erfolgreich durchgeführter Zahlung wird je nach Einstellung der ausgewählte Zahlungsweg am Kassenterminal angezeigt oder automatisch die Rechnung ausgedruckt. 


Zahlung stornieren

  • Rechnung aus dem Speicher aufrufen (FUNC 210 oder FUNC 211),
  • Zahlung löschen (FUNC 212) ausführen,
  • es öffnet sich ein Button mit dem Terminal-Namen des Gerätes, an dem der Storno ausgeführt werden soll. Dieser Button muss gedrückt werden. Anschließend wird die Gutschrift der Zahlung erstellt (Bondruck erfolgt).