Adyen ist ein Zahlungsdienstleister, der sich im Gebiet der Zahlungsabwicklung spezialisiert hat. Der Hauptsitz ist in den Niederlanden. Über den Zahlungsdienstleister werden verschiedene Zahlungsmethoden akzeptiert.
In dieser Übersicht sind alle derzeit verfügbaren Zahlungsarten über Adyen und collana pay ersichtlich.
Der folgende Abschnitt enthält die erforderlichen Informationen, die für die Anbindung von collana pay mit Adyen notwendig sind.
Einstellungen bei Adyen, die der Kunde vornehmen muss:
Schritt 1:
ApiKey: Der Authetifizierungstoken wird verwendet, um den Zugriff auf bestimmte Funktionen oder Ressourcen zu steuern. Durch diesen ApiKey kann collana pay mit Adyen kommunizieren. Hier wird erklärt, wie ein ApiKey generiert werden kann.
- 1.1 Login
- 1.2. Es müssen neue Credentials generiert werden. Der Username wird automatisch generiert. Das Feld "Description" kann beliebig selbst eingegeben werden. Es bietet sich an, einen eindeutigen Bezeichner wie "collana pay Sandbox" anzugeben.
- 1.3 Nachdem die Credentials gespeichert wurden öffnet sich die folgende Seite:
Es ist zu erkennen, dass ein API Key generiert wurde. Dieser API Key wird für die Einrichtung der Provider Accounts in collana pay benötigt.
❗ Die Einstellungen können nun unter "Save changes" gespeichert werden.
Es ist wichtig, diese API Credentials sicher aufzubewahren und nicht öffentlich zugänglich zu machen, da sie Zugriff auf die Zahlungsfunktionalität des Adyen-Kontos ermöglichen. Entwickler und Unternehmen verwenden diese Credentials, um Zahlungen zu verarbeiten, Rückbuchungen zu verwalten, Berichte zu generieren und andere Aktionen über die Adyen-API durchzuführen.
ClientKey:
- ClientKey gemäß Anleitung erzeugen. Nur für Zahlarten wie Beispielsweise für Moto.
- im Schritt "Add allowed origins" die folgende Domain hinzufügen:
- für Sandbox-V2: https://sandbox.collanapay.com
- für PRD-V2: https://live.collanapay.com
Schritt 2:
MerchantID: Diese Einstellung ist erforderlich, um die Identität eines Händlers oder Unternehmens in einem Zahlungssystem eindeutig zu identifizieren. Wenn verschiedene Merchant Accounts für unterschiedliche Länder/Währungs-Kombinationen verwendet werden müssen diese hinterlegt werden. Hier wird erläutert, wie eine Kontostruktur hinterlegt werden kann.
Adyen Konto öffnen und zu Settings -> Merchant Accounts -> Request new merchant account navigieren:
In der Übersicht "Merchant Accounts" ist das angelegte Konto zu finden.
Schritt 3:
Die Einrichtung der Webhooks kann sowohl auf company Ebene als auch auf MerchantAccount Ebene stattfinden. Wir empfehlen die Einrichtung auf company Ebene vorzunehmen, weil die Einrichtung dann nur einmalig vorgenommen werden muss.
Die Benachrichtigung im Kundenkonto muss eingerichtet werden, damit die Kommunikation zu den Endpunkten funktioniert. Diese Einrichtung wird über Webhook vorgenommen.
Hier wird erklärt, wie die Einstellungen vorgenommen werden.
- 3.1 collana pay Endpunkte eintragen
Hierfür muss bei Adyen Backend unter Entwickler -> Webhooks ein neuer Webhook angelegt werden:Es muss immer der Standard Webhook ausgewählt werden:
General
1. Description: Es ist ratsam, eine Beschreibung zu verfassen, die später klar erkennen lässt, dass es um einen Webhook in Verbindung mit collana pay geht.
2. Server configuration: Hier ist der Link einzufügen, welcher von collana pay zur Verfügung gestellt wird.
- Sandbox-V2: https://sandbox.collanapay.com/v2/notifications/adyen/
- PRD-V2: https://live.collanapay.com/v2/notifications/adyen/
3. Events: Hier empfiehlt es sich die Einstellung auf "Default events enabled" zu lassen.
Security
1. Username: Diese Felder können nach Wunsch vergeben werden.
2: Password: Diese Felder können nach Wunsch vergeben werden.
3. HMAC Key: Generieren (NotificationsHmacKey) und collana hive mitteilen.
❗Unten rechts auf "Save changes" klicken.
NotificationsAuthenticationUserName:
Nachdem die MerchantID erstellt wurde, wird automatisch in der Webhook-Übersicht anhand der vergebenen Beschreibung ein Webhook angelegt.
NotificationsAuthenticationPassword:
NotificationsHmacKey: Diese Einstellungen werden wie im Step 3 vorgenommen. Der Hmac-Schlüssel (Hash-based Message Authentication Code) wird zur Signierung der API-Anfragen verwendet. Er wird zusammen mit dem API Key verwendet, um sicherzustellen, dass die Daten während der Übertragung nicht manipuliert wurden und dass die Anfrage von einem autorisierten Absender stammt.
Wichtig für die Produktivumgebung und für einige Zahlarten
- CheckoutUri: individueller Live-Endpoint (wird nicht benötigt für Import) [programmiert auf v66 bzw v69 für MOTO].
- ApiUri: individueller nur im Produktivsystem relevanter Live-Endpoint (programmiert auf v64).