Adyen

1. Vorkonfiguration Ihres Adyen-Accounts

Lassen Sie von Adyen alle von Ihnen benötigten Zahlungmethoden freischalten. billwerk unterstützt Kreditkartenzahlungen, SEPA Lastschriftzahlungen und iDeal.

Schritt 1:

Setzen Sie das "Capture delay" in Ihrem Adyen Händleraccout auf manuell. Navigieren Sie dazu zunächst in Ihren Merchant account links auf der Homepage über "Accounts > Merchant accounts" und wählen Sie das jeweilige Konto an. Dann gehen Sie in die "Merchants settings" über "Accounts" und setzen Sie "Capture Delay" auf "manual", schließen Sie den Schritt mit "Submit" ab.

Schritt 2:

Aktivieren Sie die wiederkehrenden Tokens unter "Accounts > Checkout settings > Recurring". 

Schritt 3 (nur für Live Betrieb): 

Bitten Sie Adyen für Sie einen Endpunkt für echte Zahlungen aufzusetzen. Kontaktieren Sie hierfür bitte den Adyen Support. Wenn Adyen für Sie bereits einen Live Endpunkt erzeugt hat können Sie diesen unter "Developers > API URLs" einsehen.

2. Konfiguration in billwerk und Adyen

Die Einstellungen des Zahlungsanbieters in Ihrem billwerk-Account nehmen Sie unter "Einstellungen > Zahlungseinstellungen > Adyen" vor.

Händler-Konto:

Tragen Sie hier den Namen Ihres Adyen Händleraccounts, wie er im Adyen Benutzerinterface angezeigt wird, ein. 

Die Position des Händlerkontos ist im folgenden Screenshot rot markiert: 

Recurring details:

Um die wiederkehrenden Zahlungen zu aktivieren, gehen Sie auf Developers > Additional Data und aktivieren Sie unter Payment die Checkbox Recurring details.

API-Schlüssel:

Navigieren Sie hierzu in Ihrem Adyen Händeraccount zu "Developers > API credentials" und wählen Sie bzw. legen Sie einen neuen Benutzer an. Gehen Sie in die Bearbeitungsfunktion des Benutzers und generieren Sie einen neuen API-Schlüssel mit "Genereate New API Key". Schließen Sie daraufhin den Vorgang in Adyen mit "Save Generated API Key" ab. 

Client key:

Adyen API for CreditCards erfordert die Speicherung des Client Key in billwerk. Dieser Schritt ist für Händler erforderlich, die von der alten Adyen-Kreditkarten-Implementierung auf eine neue umsteigen möchten:

1. Erzeugen Sie einen neuen Client-Schlüssel im Adyen-Konto für Ihren Benutzer und kopieren Sie ihn

2. Fügen Sie den Schlüssel in das Feld "Client key" in den Adyen-Einstellungen in billwerk ein

Alle Eingaben für die Eingabe sensibler Kartendaten werden 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 laden, da zusätzliche Objekte clientseitig erstellt werden müssen. Die Anleitung und detaillierte Beschreibung finden Sie hier.

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

Ort der JS Bibliothek (deprecated):

Navigieren Sie hierzu in Ihrem Adyen Händeraccount zu "Developers> API credentials" und selektieren Sie den Nutzer. Kopieren Sie nun im Bereich "Client-Side Encryption" den Link zur "Library location" und hinterlegen Sie ihn in dem Feld. 

HMAC Schlüssel:

Für diesen Schlüssel müssen die "Standard Notifications" in Adyen aktiviert werden. Navigieren Sie hierzu in Ihrem Adyen Händlerkonto zu "Developers > Webhooks". Öffnen Sie die Liste von Webhooks über Pluszeichen im blauen Rechteck oben rechts und fügen Sie "Standard Notification" hinzu. Daraufhin öffnet sich ein Dialogfeld. Tragen Sie unter URL die Adresse ein, die Sie in billwerk unter "Einstellungen > Zahlungseinstellungen > Adyen" finden.

Klicken Sie nun auf "Additional Settings" und selektieren Sie unter "HMAC Key (HEX Encoded)" "Generate new HMAC key". Tragen Sie den HMAC Schlüssel in billwerk ein und speichern Sie die Konfiguration mit "Save Configuration" unten auf der Seite im Adyen Portal ab. 

Aktivieren Sie folgende Benachrichtigungen (notifications) innerhalb von Standard Notification:

• Authorisation
• Chargeback_Reversed
• Report_Available

Aktivieren Sie die gerade eingestellte "Standard Notification" mit dem Haken.

Nach Konfiguration der Notification, müssen Sie jetzt zusätzlich die "Payment accounting" abonnieren. Klicken Sie dazu unter "Reports > Payment Accounting" auf "Automatic generation" mit der Option .CSV

Reporting Benutzername und Passwort: 

Für den Abruf der Reports wird ein separater Adyen Reporting-User benötigt.

Dieser Nutzer wird in Adyen unter "Developers > API credentials" verwaltet. Klicken Sie dort auf "Create new credential", wählen Sie als Benutzertyp "Report user" aus. 

Ein Benutzername und ein Passwort werden automatisch erstellt. Beides können Sie dann in die billwerk Zahlungseinstellungen übertragen.

Stellen Sie sicher, dass "Merchant Report Download role" selektiert ist.

Live Endpunkt:

Im Live Modus muss zusätzlich der in Kapitel 1, Schritt 3 generierte Live Endpunkt hinterlegt werden. 

3. Testdaten

Kreditkarte

Visa 

Mastercard

Discover

Diners Club

American Express

Cartes Bancaires

SEPA Lastschrift DE

Falls Sie erweiterte Testdaten benötigen, entnehmen Sie hier eine vollständige Übersicht der Adyen Testdaten.

4. Einschränkungen

• Adyen unterstützt für SEPA Lastschriften nur Euro als Währung
• Wenn Sie iDeal über Ayden integrieren, gelten folgende Einschränkungen: 
  • Vorautorisierte Transaktionen sind nicht möglich
  • Signups mit Trials (0€-Betrag) werden nicht unterstützt
  • Bestellbestätigung wird nicht unterstützt
  • Signup mit ExternalCustomerID wird nicht unterstützt, es sei denn, der Kunde wird zuerst angelegt und dann der Vertrag 
  • PaymentChange löst eine 0,01€ Zahlung aus, auch wenn der Saldo 0€ beträgt