Adyen-Payment-Konnektor mit Ihrem Merchant-Konto verbinden

Diese Anleitung setzt voraus, dass Sie bereits ein aktives Adyen-Merchant-Konto haben. Neue Merchant-Konten legen Sie bitte direkt bei Adyen an — StraivPMS tritt dabei nicht als Zwischenhändler auf.

Schritt 1 — Adyen-API-Credentials generieren

Melden Sie sich in Ihrem Adyen Customer Area an. Öffnen Sie „Developers → API credentials → Create new credential". Wählen Sie „Web service user". Vergeben Sie einen Namen wie „StraivPMS-Payment-Connector". Aktivieren Sie die Berechtigungen „Checkout webservice role", „Merchant recurring role" und „Merchant payment write role".

Schritt 2 — HMAC-Schlüssel für Notifications

Öffnen Sie „Developers → Webhooks → Add webhook". Erzeugen Sie einen HMAC-Schlüssel und kopieren Sie ihn. Konfigurieren Sie die URL, die Adyen für Payment-Ereignisse aufrufen soll — StraivPMS gibt Ihnen diese URL nach Verbindungsstart im Workspace an.

Schritt 3 — 3DS-Regeln festlegen

Im Adyen-Konto unter „Risk → Dynamic 3D Secure" legen Sie Ihre 3DS-Regeln fest. Für Hotel-Vorautorisierungen empfehlen wir 3DS in allen Fällen, bei denen der Karteninhaber nicht physisch vor Ort ist. StraivPMS gibt jedem Zahlungsversuch einen 3DS-Wunsch mit, den Adyen dann nach Ihren Regeln entscheidet.

Schritt 4 — StraivPMS verbinden

Öffnen Sie im StraivPMS-Workspace das Modul „Payment-Konnektor Adyen". Fügen Sie den Adyen-Web-Service-User-Namen, den API-Key, den HMAC-Schlüssel und die Merchant-Account-ID ein. Prüfen Sie die Verbindung mit „Test-Aufruf" — Adyen antwortet mit einer Merchant-Info.

Schritt 5 — Vorautorisierung testen

Legen Sie in Ihrem Straiv Workspace eine Test-Reservierung an. Der StraivPMS-Payment-Konnektor führt eine Vorautorisierung mit 1,00 € durch (Adyen-Testkarte 4111 1111 1111 1111, Ablauf 03/30, CVC 737). Nach erfolgreicher Vorautorisierung markieren Sie die Test-Reservierung als abgeschlossen — die Vorautorisierung wird automatisch storniert.