Adyen

Folgen

 

Inhaltsverzeichnis

Voraussetzungen

Bevor Sie die Adyen-Integration einrichten, sollten Sie die folgenden Parameter bereithalten:

  • API-Schlüssel
  • Client-Schlüssel
  • HMAC-Schlüssel

Konfiguration Ihres Adyen-Accounts

Kontaktieren Sie Adyen, um alle benötigten Zahlungsmethoden zu aktivieren. billwerk unterstützt Kreditkartenzahlungen, SEPA-Lastschriftzahlungen und iDeal. 

Wenn Sie bereits ein Adyen-Konto haben und Ihre Einstellungen aktualisieren möchten, um die neue Adyen-Integration zu verwenden, springen Sie direkt zum Abschnitt Client-Schlüssel generieren.

  • Adyen unterstützt nur Euro als Währung für SEPA-Lastschriften
  • Wenn Sie iDeal über Adyen integrieren, gibt es folgende Einschränkungen:
    • Vorautorisierte Transaktionen sind nicht möglich
    • Anmeldungen mit Trialabonnements (0€ Betrag) werden nicht unterstützt
    • Auftragsfreigabe wird nicht unterstützt
    • Registrierung mit ExternalCustomerID wird nicht unterstützt, es sei denn, der Kunde wird zuerst angelegt und dann der Vertrag.
    • Eine Zahlungsänderung löst eine Zahlung von 0,01€ aus, auch wenn der Saldo 0 ist.

 

Capture delay einstellen

Stellen Sie in Ihrem Adyen-Konto Capture delay auf manual.

  1. Wechseln Sie oben rechts vom Firmenkonto zum Händlerkonto. 
  2. Wählen Sie in Ihrem Adyen-Händlerkonto im linken Menü Settings > Account settings
  3. Wählen Sie in der Einstellung Capture delay die Option manual.
    mceclip0.png
  4. Klicken Sie auf Save.

 

Recurring Token aktivieren

Aktivieren Sie in Ihrem Adyen-Konto Recurring Tokens.

  1. Wählen Sie in Ihrem Adyen-Händlerkonto im linken Menü Settings > Checkout settings
  2. Aktivieren Sie im Abschnitt Recurring Recurring Tokens, indem Sie die Umschaltfläche nach rechts bewegen.
    mceclip0.png

 

Endpunkt für Live-Zahlungstransaktionen generieren

  • Dieser Schritt ist nur für den Live-Modus gültig.
  • Wenn Sie Adyen für SEPA-Lastschriftzahlungen verwenden möchten, muss die Konfiguration Ihres Adyen-Händlerkontos auf Auth flow geändert werden. Diese Konfiguration kann nur durch Adyen umgesetzt werden. Bitte wenden Sie sich an den Adyen-Support, um die Konfiguration zu ändern.

Wenden Sie sich an den Adyen-Support, um einen Endpunkt für Live-Zahlungstransaktionen für Sie zu generieren. Wenn Adyen den Endpunkt bereits generiert hat, können Sie die Endpunkte im Abschnitt API URLs anzeigen.

  • Wählen Sie in Ihrem Adyen-Händlerkonto im linken Menü Developers > API URLs aus. 

 

Konfiguration in billwerk und Adyen

Zahlungseinstellungen öffnen

Bereiten Sie die Konfiguration in billwerk vor, indem Sie die Einstellungen des Zahlungsanbieters Adyen öffnen.

  1. Um zu den Zahlungseinstellungen zu gelangen, klicken Sie oben rechts auf Ihre E-Mail-Adresse > Einstellungen.
  2. Klicken Sie im Abschnitt ZAHLUNG auf Zahlungseinstellungen.
  3. Klicken Sie in der Zeile Adyen auf das mceclip0.png-Symbol.
    mceclip11.png

 

Händlerkonto auswählen

Geben Sie den Namen Ihres Adyen-Händlerkontos ein, wie es in der Adyen-Benutzeroberfläche angezeigt wird. Das Händlerkonto ist im folgenden Screenshot markiert.

mceclip12.png

 

Recurring details aktivieren

  1. Wählen Sie in Ihrem Adyen-Händlerkonto im linken Menü die Option Developers > Additional Data
  2. Aktivieren Sie unter Payment die Checkbox Recurring details.

 

API-Schlüssel generieren

Generieren Sie einen neuen API-Schlüssel in Adyen und fügen Sie ihn in billwerk ein.

  1. Wählen Sie in Ihrem Adyen-Händlerkonto im linken Menü die Option Developers > API Credentials.
  2. Wählen Sie den Benutzer ws@[Ihr Firmenname].
  3. Klicken Sie im Abschnitt Authentication auf Generate New API Key
    mceclip9.png
  4. Fügen Sie in billwerk den generierten API-Schlüssel in das Feld API-Schlüssel in den Adyen-Einstellungen ein.
    mceclip1.png
  5. Beenden Sie diesen Schritt in Adyen, indem Sie auf Save Generated API Key klicken. 

 

Client-Schlüssel generieren

Adyen API für Kreditkarten erfordert, dass der Client-Schlüssel in billwerk gespeichert wird. Dieser Schritt ist für Händler erforderlich, die von der alten Adyen Kreditkartenimplementierung auf eine neue umstellen möchten.

  1. Wählen Sie in Ihrem Adyen-Händlerkonto im linken Menü die Option Developers > API Credentials.
  2. Wählen Sie den Benutzer ws@[Ihr Firmenname].
  3. Klicken Sie im Abschnitt Authentication auf Generate New Client Key.
    mceclip10.png
  4. Fügen Sie in billwerk den generierten Client-Schlüssel in das Feld Client-Schlüssel in den Adyen-Einstellungen ein.
    mceclip2.png

Jeder Eingabe von sensiblen Kartendaten wird auf der Adyen-Seite gehostet und als iFrame auf der Seite angezeigt. Wenn Sie Ihre eigene Anmeldeseite verwenden, beachten Sie bitte, dass wir die neue Adyen JS-Bibliothek nicht automatisch wie bei anderen PSPs laden, da zusätzliche Objekte clientseitig erstellt werden sollten. Die Anleitung und ausführliche Beschreibung finden Sie hier.

Wenn Sie unsere gehosteten Seiten verwenden, sind keine zusätzlichen Änderungen erforderlich.

 

Dieser Parameter wird von Händlern verwendet, die die vorherige Adyen-Integration verwenden.

  1. Wählen Sie in Ihrem Adyen-Händlerkonto im linken Menü die Option Settings > Users
  2. Wählen Sie den Benutzer ws@[Ihr Firmenname].
  3. Kopieren Sie im Abschnitt Client-Site Encryption den Link Library location.
  4. Fügen Sie den Link in billwerk ein.

 

HMAC-Schlüssel generieren

Sie müssen die Standard Notifications in Adyen für den HMAC-Schlüssel aktivieren.

  1. Wählen Sie in Ihrem Adyen-Händlerkonto im linken Menü die Option Entwickler > Webhooks
  2. Klicken Sie auf die Schaltfläche + Webhook, um Standard Notifications hinzuzufügen und ein Dialogfeld zu öffnen.
  3. Klicken Sie in Ihrem billwerk-Konto auf das Symbol Profil in der oberen rechten Ecke, um das Menü Einstellungen zu öffnen.
  4. Wählen Sie Einstellungen.
  5. Wählen Sie auf der Seite Einstellungen im linken Bereich die Option Zahlungseinstellungen.
  6. Klicken Sie auf das Bearbeiten-Symbol von Adyen.
  7. Kopieren Sie den Link aus dem Feld Adyen Account Requirements auf der Seite Settings Adyen.
  8. Fügen Sie in Adyen die URL in das URL-Feld im Abschnitt Allgemein > Serverkonfiguration ein.
    mceclip1.png
  9. Klicken Sie auf Apply.
  10. Klicken Sie im Abschnitt Security > HMAC Key auf Generieren.
    mceclip2.png
  11. Kopieren Sie den HMAC-Schlüssel.
  12. Fügen Sie in billwerk den HMAC-Schlüssel in das Feld HMAC-Schlüssel ein.
  13. Klicken Sie in Adyen auf Apply.
  14. Klicken Sie auf Save Changes.
  15. Aktivieren Sie die Standard notification.
    mceclip13.png

Payment accounting abonnieren

Nach der Konfiguration der Benachrichtigungen müssen Sie nun auch "Payment accounting" abonnieren.

  1. Wählen Sie Reports aus dem Menü auf der linken Seite. 
  2. Stellen Sie im Abschnitt Payment accounting sicher, dass die Option Automatic generation mit .CSV als Berichtstyp aktiviert ist.
    mceclip4.png

 

Reporting Benutzername und Passwort

Ein separater Adyen Reporting-Benutzer ist erforderlich, um die Berichte aufzurufen.

  1. Wählen Sie in Ihrem Adyen-Händlerkonto im linken Menü die Option Developers > API Credentials
  2. Klicken Sie auf Create credential.
    mceclip5.png
  3. Wählen Sie Report user als Benutzertyp.
    mceclip6.png
    Ein Benutzername und ein Passwort werden automatisch erstellt.
  4. Anschließend können Sie Benutzername und Passwort in die Zahlungseinstellungen von billwerk übertragen.
    mceclip7.png
  5. Stellen Sie sicher, dass die Rolle Report Download ausgewählt ist.
    mceclip8.png

 

Live-Endpunkt

Im Live-Modus muss der im Abschnitt Endpunkt für Live-Zahlungstransaktionen generieren generierte Live-Endpunkt gespeichert werden.

 

SEPA-Referenzzeile konfigurieren

Sie können die SEPA-Referenzzeile manuell konfigurieren. Weitere Informationen finden Sie im Artikel SEPA-Referenzzeile konfigurieren.

 

Testdaten

Kreditkarte

Visa

Kartennummer 4035501000000008
Ablaufdatum 03/2030
CVC 737

Mastercard

Kartennummer 2223000048410010
Ablaufdatum 03/2030
CVC 737

Discover

Kartennummer 6445644564456445
Ablaufdatum 03/2030
CVC 737

Diners Club

Kartennummer 36070500001020
Ablaufdatum 03/2030
CVC 737

American Express

Kartennummer 370000000000002
Ablaufdatum 03/2030
CVC 7373

Cartes Bancaires

Kartennummer 4035501000000008
Ablaufdatum 03/2030
CVC 737

 

SEPA-Lastschriftverfahren

IBAN Kontoinhaber
DE87123456781234567890   A. Schneider
DE92123456789876543210 B. Schneider
DE14123456780023456789 C. Schneider

Wenn Sie zusätzliche Testdaten suchen, finden Sie die vollständige Liste in der offiziellen Adyen-Dokumentation.

War dieser Beitrag hilfreich?
1 von 1 fanden dies hilfreich