Adyen

Inhaltsverzeichnis

• Voraussetzungen
• Konfiguration Ihres Adyen-Accounts
  • Capture delay einstellen
  • Recurring Token aktivieren
  • Endpunkt für Live-Zahlungstransaktionen generieren
• Konfiguration in billwerk und Adyen
  • Adyen-Einstellungen öffnen 
  • Händlerkonto auswählen
  • Recurring details aktivieren
  • API-Schlüssel generieren
  • Client-Schlüssel generieren
  • JS Library Location (veraltet)
  • HMAC-Schlüssel generieren
  • Payment accounting abonnieren
  • Reporting Benutzername und Passwort
  • Live-Endpunkt
  • SEPA-Referenzzeile konfigurieren
• Testdaten
  • Kreditkarte
  • SEPA-Lastschriftverfahren

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.

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.
   
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.
   

Endpunkt für Live-Zahlungstransaktionen generieren

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 -Symbol.
   

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.

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. 
   
4. Fügen Sie in billwerk den generierten API-Schlüssel in das Feld API-Schlüssel in den Adyen-Einstellungen ein.
   
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.
   
4. Fügen Sie in billwerk den generierten Client-Schlüssel in das Feld Client-Schlüssel in den Adyen-Einstellungen ein.
   

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.

JS Library Location (veraltet)

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.
   
9. Klicken Sie auf Apply.
10. Klicken Sie im Abschnitt Security > HMAC Key auf Generieren.
    
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.
    
    
    

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.
   

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.
   
3. Wählen Sie Report user als Benutzertyp.
   
   Ein Benutzername und ein Passwort werden automatisch erstellt.
4. Anschließend können Sie Benutzername und Passwort in die Zahlungseinstellungen von billwerk übertragen.
   
5. Stellen Sie sicher, dass die Rolle Report Download ausgewählt ist.
   

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

Mastercard

Discover

Diners Club

American Express

Cartes Bancaires

SEPA-Lastschriftverfahren

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