Dokumentation

1Adyen Registrierung

Sie können Ihr eigenes Adyen-Konto direkt online erstellen. Gehen Sie zu https://www.adyen.com/signup und beantragen Sie ein Händlerkonto. Nachdem Sie alle Informationen angegeben haben, erhalten Sie die Informationen, die zum Erstellen der Prozessor- und Connector-Konfiguration erforderlich sind.

2Adyen-Konfigurationsdokumentation

Sobald Sie sich für ein Händlerkonto bei Adyen registriert haben, erhalten Sie eine E-Mail, die alle notwendigen Informationen für die Anmeldung im Adyen-Händler-Administrationsbackend enthält.

Sie müssen zwischen dem Test- und dem Live-Portal unterscheiden:

Der Administrationszugang wird benötigt, um die für die Authentifizierung erforderlichen Einstellungen zu konfigurieren.

2.1Prozessorkonfiguration erstellen

Zunächst muss der Adyen-Verarbeiter konfiguriert werden. Navigieren Sie dazu zu Space > Zahlung > Konfiguration > Verarbeiter . Klicken Sie auf Prozessorkonfiguration erstellen und geben Sie Adyen in das Feld ein, um den Verarbeiter auszuwählen und die Konfiguration zu starten.

2.1.1Merchant Account Name

Der Merchant Account Name wird von Adyen bereitgestellt und ist auch im Backend des Kontos oben links sichtbar. Für die Konfiguration müssen Sie in das Merchant Account wechseln, das Sie mit der Plattform verbinden möchten, und diesen Namen auch in der Connector-Konfiguration angeben.

adyen-account-name
Figure 1. Stellen Sie sicher, dass oben links das korrekte Konto ausgewählt ist.

2.2Webservice-Benutzer und API Key erstellen

2.2.1Für die Test-/Sandbox-Umgebung

Navigieren Sie im Adyen-Backend zu Developers > API Credentials und wählen Sie Create new credential. Wählen Sie hier, einen neuen Webservice-Benutzer zu erstellen. Notieren Sie sich den vom System generierten Benutzernamen, da Sie ihn in die Prozessorkonfiguration kopieren müssen.

adyen-webservice-user
Figure 2. Wählen Sie den Webservice-Benutzer und notieren Sie sich den automatisch generierten Benutzernamen.

Führen Sie auf dem Bildschirm zur Benutzererstellung Folgendes aus.

Kopieren Sie im Abschnitt Server Settings / Authentication den generierten API Key und fügen Sie ihn in die Prozessorkonfiguration ein.

adyen-webservice-api-key
Figure 3. Kopieren Sie den API Key von hier.

Richten Sie im Abschnitt Permissions / Roles die folgenden Rollen ein:

adyen-webservice-role
Figure 4. Richten Sie die Benutzerrollen ein.

Falls einige Rollen nicht auf dem Bildschirm angezeigt werden, wenden Sie sich bitte an den Adyen-Support, um sie zu aktivieren.

Da Sie die Rolle "API PCI Payments" verwenden, kann Adyen Sie außerdem bitten, zusätzliche Unterlagen bereitzustellen, um nachzuweisen, dass Sie berechtigt sind, diese Rolle zu verwenden. Alle Informationen und Dokumente, die Sie an Adyen weiterleiten können, finden Sie auf dieser Seite: https://en.wallee.com/legal/pci.

Wenn Sie iDEAL-Zahlungen verwenden, müssen Sie eine zusätzliche Rolle auswählen:

adyen-webservice-roles-ideal
Figure 5. Wenn Sie iDEAL verwenden, richten Sie die Rollen wie folgt ein.

Diese Rolle ist nur für iDEAL-Zahlungen erforderlich. Falls diese Rolle nicht auf dem Bildschirm angezeigt wird, wenden Sie sich bitte an den Adyen-Support, um sie zu aktivieren.

Vergessen Sie nicht, unten auf Save zu klicken, um den konfigurierten Benutzer zu speichern.

2.2.2Für die Produktions-/Live-Umgebung

Bitte befolgen Sie zunächst dieselben Schritte, die Sie zur Konfiguration der Testumgebung verwendet haben.

Zusätzlich müssen Sie das "URL Prefix" für den Produktions-API-Zugriff konfigurieren. Ihren Produktions-API-Endpunkt finden Sie, wenn Sie in Ihrem Adyen-Konto zu Developers > API URLs gehen. Die URL hat die folgende Form:

https://[random]-[company name]-pal-live.adyenpayments.com/[some_more_text_here]

Der Teil [random]-[company name] sollte als URL-Präfix in Ihre Live-Zahlungsverarbeiter-Einstellungen im Portal kopiert werden.

2.3Die Webhooks und den Webhook-Benutzernamen/das -Passwort einrichten

Um über den Status der Zahlungstransaktion benachrichtigt zu werden, ist es wichtig, dass die korrekten Webhooks im Adyen-Händler-Backend eingerichtet sind. Um die Webhooks zu erstellen, navigieren Sie im Adyen-Backend zu Developers > Webhooks.

Die folgenden Webhook-Typen müssen für die korrekte Verarbeitung von Zahlungen aktiviert sein:

  • Standard Notification: Diese muss unabhängig davon, welche Zahlarten verwendet werden, aktiviert sein. Beachten Sie beim Einrichten der Standard-Benachrichtigungen, dass es auf der Seite einen Abschnitt mit dem Titel "Additional Settings" gibt, den Sie durch Klicken auf das kleine Dreieck erweitern können, falls er nicht bereits erweitert ist. Wenn Sie bestimmte Zahlarten verwenden, müssen Sie einige Optionen aktivieren. Falls Sie Kreditkarten einschließlich 3D Secure verarbeiten, müssen Sie Include 3D Secure Result in den Additional Settings aktivieren.

  • Ideal Details Notification: Bei Verwendung von iDEAL | Wero-Zahlungen muss dieser zusätzliche Benachrichtigungstyp aktiviert sein.

  • Boleto Pending Notification: Bei Verwendung von Boleto Bancário-Zahlungen muss dieser zusätzliche Benachrichtigungstyp aktiviert sein.

Note
Wenn die Webhooks nicht korrekt eingerichtet sind, ist es nicht möglich, die Zahlungen zu verarbeiten, und es kann dazu führen, dass Ihr Adyen-Konto für den Empfang weiterer Benachrichtigungen gesperrt wird, sodass Sie den Adyen-Support kontaktieren müssen, um dieses Problem zu lösen.

Die folgenden Parameter müssen unter General / Server Configuration für die korrekte Verarbeitung von Zahlungen gesetzt werden:

adyen-webhook-server-configuration
Figure 6. Konfigurieren Sie den Webhook-Endpunkt.
  • Die URL ist spezifisch für Ihren Space. Wir zeigen Ihnen die URL, die Sie in die Benachrichtigung eingeben müssen. Navigieren Sie zur Benachrichtigungs-Einrichtungsseite unter Space > Zahlung > Konfiguration > Verarbeiter > Adyen Processor > Notification Setup . Wenn Sie mehrere Spaces haben, werden Sie aufgefordert, den Space auszuwählen. Die Benachrichtigungs-URL hängt vom Space ab.

  • Stellen Sie sicher, dass Sie die SSL Version of TLS 1.2 verwenden.

  • Setzen Sie die Method auf HTTP Post.

  • Sie müssen einen Benutzernamen und ein Passwort für die Basic Authentication für Zahlungsstatus-Benachrichtigungen festlegen. Sie können diese Werte nach Belieben definieren, stellen Sie nur sicher, dass Sie dieselben Angaben in die Prozessorkonfiguration eingeben.

adyen-webhook-authentication
Figure 7. Konfigurieren Sie den Webhook-Benutzernamen und das -Passwort.
  • Additional Settings: Beim Einrichten der Standard-Benachrichtigungen gibt es auf der Seite einen Abschnitt mit dem Titel Additional Settings. Falls Sie Kreditkarten einschließlich 3-D Secure verarbeiten, müssen Sie die Option Include 3D Secure Result aktivieren.

adyen-webhook-settings
Figure 8. Konfigurieren Sie die zusätzlichen Webhook-Einstellungen.

2.4Connector-Konfigurationen

Sobald Sie die Prozessorkonfiguration gespeichert haben, wird Ihnen der Connector Wizard angezeigt. Durch Klicken auf activate erstellt das Portal automatisch die Zahlart-Konfiguration und den entsprechenden Connector in Ihrem Konto.

adyen-connector-wizzard
Figure 9. Durch die Aktivierung der Zahlart im Assistenten werden die Zahlart und der entsprechende Connector erstellt.

Weitere Informationen zu Connectors, Zahlarten und Verarbeiter finden Sie in der Connector-Konzept-Dokumentation.

Note
Stellen Sie sicher, dass alle Zahlarten, die Sie in der Anwendung aktivieren, auch in Ihrem Adyen-Konto aktiv sind. Um zusätzliche Zahlarten zu aktivieren, müssen Sie dies beim Adyen-Support anfragen.

2.4.1Zusätzliche Einstellungen

Die folgenden zusätzlichen Einstellungen müssen abhängig von den Zahlungsarten, die Sie verarbeiten können möchten, aktiviert werden:

  • Recurring payments: Wenn Sie wiederkehrende Zahlungen verarbeiten können möchten, müssen Sie den Adyen-Support bitten, Ihr Konto für diese Funktionalität zu aktivieren; sie ist nicht standardmäßig aktiviert.

  • 3-D Secure: Wenn Sie die 3D-Secure-Authentifizierung verwenden möchten, müssen Sie den Adyen-Support bitten, Ihr Konto für diese Funktionalität zu aktivieren; sie ist nicht standardmäßig aktiviert.