Adyen Add-On

Einführung

Das Adyen Add-On ist ein Premium-Add-On. Sie können es im Rahmen eines unserer Abonnements erwerben. Vielen Dank!

Mit dem iform4u Adyen Payments Add-On können Sie iform4u nahtlos in Adyen Payments integrieren. Dank des neuen Dropin.js-SDKs lässt sich ein sicheres Zahlungsformular erstellen, das die Kreditkartendaten Ihrer Kunden erfasst, ohne dass Sie selbst sensible Daten verwalten müssen.

Installation des Adyen Add-Ons

Die Installation des Adyen Add-Ons verläuft ähnlich wie bei jedem anderen Add-On. Öffnen Sie das Menü „Add-Ons“ und konfigurieren Sie dort das Add-On.

Erstellen eines Zahlungsformulars

Formulare werden über den Form Builder erstellt. Ziehen Sie einfach die benötigten Felder per Drag-and-Drop in Ihr Formular und fügen Sie ein HTML-Snippet-Feld mit folgendem Inhalt hinzu:

{{ADYEN}}

Anschließend können Sie in der Adyen-Add-On-Oberfläche festlegen, welche Felder die notwendigen Zahlungsinformationen erfassen sollen (z. B. Preis, Menge usw.).

API-Schlüssel aus Ihrem Adyen-Konto abrufen

Nachdem Sie Ihr Formular erstellt haben, können Sie es mit Ihrem Adyen-Konto verknüpfen. Hierfür benötigen Sie folgende Angaben aus Ihrem Adyen-Konto:

1. API Key
2. Origin Key
3. Loading Context
4. Merchant Account
5. Live URL Prefix (erforderlich, um in den Produktivmodus zu wechseln und echte Zahlungen zu empfangen)

Im Folgenden finden Sie Links zu den entsprechenden Adyen-Dokumentationen:

• Adyen – Erste Schritte
• Adyen – So erhalten Sie Ihren API-Schlüssel

Hinweis: Sie können zunächst ein Testkonto anlegen, um Ihre Formulare und Zahlungen zu testen. Anschließend können Sie die Schlüssel und die Umgebung wechseln, um in den Produktivmodus zu wechseln und echte Zahlungen zu erhalten.

Zahlungsformulare mit Ihrem Adyen-Konto einrichten

Um eine Adyen-Konfiguration zu erstellen, führen Sie bitte folgende Schritte aus:

1. Öffnen Sie den Add-Ons Manager und klicken Sie auf Adyen.
2. Klicken Sie auf die Schaltfläche Setup a Payment Form.
3. Es erscheint ein Formular, in dem Sie die Zahlungsabwicklung konfigurieren:
   • Form: Erforderlich. Wählen Sie das Formular aus, das Sie mit Ihrem Adyen-Konto verbinden möchten.
   • Status: Ermöglicht das Deaktivieren der Adyen-Konfiguration.
   • Live: Aktivieren Sie diese Option, wenn Sie in den Produktivmodus („Production“) wechseln möchten.
   • Api Key: Erforderlich. Ihre API-Zugangsdaten.
   • Origin Key: Erforderlich. Ihre API-Zugangsdaten.
   • Loading Context: Erforderlich. Geben Sie hier Ihren Test- oder Live-Loading-Kontext ein.
   • Live Url Prefix: Nur erforderlich, wenn Sie Ihr Formular in den Produktivmodus überführen möchten.
   • Merchant Account: Erforderlich. Die Merchant Account ID Ihres Adyen-Kontos.
   • Opt-In Condition: Aktivieren Sie eine bedingte Logik, damit nur dann Zahlungen akzeptiert werden, wenn eine bestimmte Bedingung erfüllt ist.
   • Items: Jedes Element stellt ein Produkt oder eine Dienstleistung dar, die auf der Adyen-Seite detailliert angezeigt wird. Ein Item umfasst:
     • Description: Beschreibt Ihr Produkt oder Ihre Dienstleistung.
     • Price: Verweist auf das Formularfeld, in dem der Preis erfasst wird.
     • Quantity: Verweist auf das Formularfeld, in dem die Anzahl der Produkte angegeben wird. Zur Ermittlung des Transaktionsbetrags wird die Anzahl mit dem Preis pro Produkt multipliziert. Wenn Sie kein Feld wählen, wird standardmäßig eine Menge von „1“ angenommen.
   • Credit Card Field Settings: Eine Gruppe von Einstellungen, um zu steuern, wie das Kreditkartenfeld für Ihre Kunden dargestellt wird. Hier können Sie festlegen:
     • Label: Beschriftung des Kreditkartenfeldes.
     • Locale: Sprache des Kreditkartenfeldes. Standard: en_US. Verfügbare Optionen
     • Currency: Die Währung, in der Transaktionen abgewickelt werden.
     • Dom Element: Das HTML-DIV-Element (ID), in dem das Kreditkartenfeld eingefügt wird.
     • Hide Label: Aktivieren, um die Beschriftung des Kreditkartenfeldes auszublenden.
     • Required: Aktivieren, um nur Bestellungen zu akzeptieren, bei denen eine Zahlung erfolgt. Übermittlungen ohne Zahlung werden abgelehnt.
     • Store Detail: Aktivieren, um Kundendaten für zukünftige Transaktionen zu speichern.
     • Holder Name: Aktivieren, um den Namen des Karteninhabers abzufragen.
     • Styles: Damit können Sie das Erscheinungsbild des Kreditkartenfelds mithilfe von CSS-Eigenschaften im JSON-Format anpassen. Weitere Informationen
     • Placeholders: Hier können Sie Beispielwerte für die Eingabefelder (Kartendetails) im JSON-Format festlegen. Weitere Informationen

4. Klicken Sie auf Create.