Adyen

Voraussetzungen & Einschränkungen

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

• API-Schlüssel

• Client-Schlüssel

• HMAC-Schlüssel

Bitte beachten Sie, bevor Sie mit der Implementierung von SubscriptionJS auf Ihrer Sign up Seite beginnen, dass nicht alle Zahlungsmethoden dieses PSP die ProcessPaymentData-Methode unterstützen:

Konfiguration Ihres Adyen-Accounts

Kontaktieren Sie Adyen, um alle benötigten Zahlungsmethoden zu aktivieren. Frisbii Transform 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 nutzen, sehen Sie sich direkt den Abschnitt Client-Schlüssel generieren an.

Bitte beachten Sie:

• 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 Testtarifen (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.

  • PaymentChange 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 Menü auf der linken Seite Einstellungen > Kontoeinstellungen.

3. Wählen Sie in der Einstellung Aufnahmeverzögerung die Option manuell.
   

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 Menü auf der linken Seite Einstellungen > Checkout-Einstellungen.

2. Aktivieren Sie im Abschnitt Wiederkehrende Token die wiederkehrenden Token, indem Sie die Umschalttaste nach rechts schieben.
   

Endpunkt für Live-Zahlungstransaktionen generieren

Bitte beachten Sie:

• 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 Menü auf der linken Seite Developers > API URLs aus.

Konfiguration in Frisbii Transform und Adyen

Zahlungseinstellungen öffnen

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

1. Um zu den Zahlungseinstellungen zu gelangen, klicken Sie auf Ihre E-Mail-Adresse > Einstellungen in der oberen rechten Ecke.

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 Menü auf der linken Seite Entwickler > Zusätzliche Daten.

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 Frisbii Transform ein.

1. Wählen Sie in Ihrem Adyen-Händlerkonto im Menü auf der linken Seite Developers > API Credentials aus.

2. Wählen Sie den Benutzer ws@[Ihr Firmenname].

3. Klicken Sie im Abschnitt Authentifizierung auf Neuen API-Schlüssel generieren.
   

4. In Frisbii Transform fügen Sie 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 Key in Frisbii Transform 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 Menü auf der linken Seite Developers > API Credentials aus.

2. Wählen Sie den Benutzer ws@[Ihr Firmenname].

3. Klicken Sie im Abschnitt Authentication auf Generate New Client Key.
   

4. In Frisbii Transform fügen Sie den generierten Client Key in das Feld Client Key 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 die von uns gehosteten Seiten verwenden, sind keine weiteren Änderungen erforderlich.

JS Library Location (veraltet)

Hinweis

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

1. Wählen Sie in Ihrem Adyen-Händlerkonto im Menü auf der linken Seite Einstellungen > Benutzer.

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 Frisbii Transform 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 Menü auf der linken Seite Entwickler > Webhooks aus.

2. Klicken Sie auf die Schaltfläche + Webhook, um Standardbenachrichtigungen hinzuzufügen und ein Dialogfeld zu öffnen.

3. Klicken Sie in Ihrem Frisbii Transform-Konto auf das Profil-Symbol 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. In Adyen fügen Sie die URL in das Feld URL im Abschnitt Allgemeine > Serverkonfiguration ein.
   

9. Klicken Sie auf Apply.

10. Klicken Sie im Abschnitt Sicherheit > HMAC-Schlüssel auf Generieren.
    

11. Kopieren Sie den HMAC-Schlüssel.

12. In Frisbii Transform fügen Sie den HMAC-Schlüssel in das Feld HMAC Key ein.

13. Klicken Sie in Adyen auf Apply.

14. Klicken Sie auf Änderungen speichern.

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 Berichte aus dem Menü auf der linken Seite.

2. Vergewissern Sie sich im Abschnitt Zahlungsabrechnung, dass die automatische Generierung 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 im Menü auf der linken Seite Developers > API Credentials.

2. Klicken Sie auf Create credential.
   

3. Wählen Sie als Benutzertyp Berichtsbenutzer.
   

   Es werden automatisch ein Benutzername und ein Passwort erstellt.

4. Sie können dann den Benutzernamen und das Passwort in die Frisbii Transform Zahlungseinstellungen übertragen.
   

5. Stellen Sie sicher, dass die Rolle Report Download ausgewählt ist.
   

Live-Endpunkt

Im Live-Modus muss der im Abschnitt Erzeugen eines Endpunkts für Live-Zahlungstransaktionen erzeugte Live-Endpunkt gespeichert werden.

3. SEPA-Referenzzeile konfigurieren

Sie können die SEPA-Referenzzeile manuell konfigurieren. Weitere Informationen finden Sie in dem Artikel SEPA-Referenz konfigurieren.

Testdaten

Kreditkarte

Visum

Mastercard

Entdecken Sie

Diners Club

American Express

Kartes Bancaires

SEPA-Lastschriftverfahren

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