Installation

Installation

Anforderungen

{note} Die Felder "Adresszusatzzeile 1" und "Adresszusatzzeile 2" dürfen nicht als Pflichtfelder markiert werden, wenn Klarna Checkout aktiv ist.

  • Shopware >= 5.2.17
  • HTTPS (SSL Zertifikat)

Empfehlungen

Um Rundungsfehler zu vermeiden sollte die PHP Extension bcmath auf dem Server installiert und aktiviert werden.

Plugin installieren

Als erstes müssen Sie den Plugin Manager öffnen.

Navigieren Sie, in der linken Spalte, zu Installiert.

Klicken Sie nun auf den Plugin hochladen Button.

Klicken Sie nun auf Auswählen und selektieren Sie das Klarna Checkout ZIP Archiv.

Laden Sie nun das Plugin hoch.

Das Plugin ist nun, deinstalliert, im Plugin Manager zu finden.

Installieren Sie das Plugin indem Sie auf das grüne + Icon klicken.

Plugin konfigurieren

Öffnen Sie die Einstellungen des Plugins indem Sie zu Einstellungen -> Grundeinstellungen -> Weitere Einstellungen -> Klarna Checkout navigieren.

Hier können Sie folgende Einstellen vornehmen:

Name Beschreibung
Test oder Live Modus Im Test-Modus werden nur Test-Bestellungen angelegt, es finden keine Zahlungen statt. Stellen Sie sicher, dass Sie den Live-Modus nutzen und Ihre Live Zugangsdaten verwenden sobald Sie Klarna produktiv in Ihrem Shop nutzen möchten und reale Bestellungen getätigt werden.
Live-Händler ID Der von Klarna bereitgestellte Klarna API Key. Diesen können Sie unter https://eu.portal.klarna.com/ abrufen.
Live-Händler Passwort Der von Klarna bereitgestellte Klarna API Passwort. Diesen können Sie unter https://eu.portal.klarna.com/ abrufen.
Test-Händler ID Der von Klarna bereitgestellte Klarna API Key. Diesen können Sie unter https://playground.eu.portal.klarna.com/developer-sign-up abrufen.
Test-Händler Passwort Der von Klarna bereitgestellte Klarna API Passwort. Diesen können Sie unter https://playground.eu.portal.klarna.com/developer-sign-up abrufen.
Automatische Klarna Aktionen Sollen die automatischen Klarna Aktionen (wie z.B. "Capture on" und "Refund on") aktiviert werden?
Capture on Wählen Sie den Bestellstatus, bei dem der gesamte verbleibende Betrag einer Bestellung bei Klarna erfasst werden soll.
Refund on Wählen Sie den Bestellstatus, bei dem der gesamte bereits erfasste Betrag von Klarna an den Kunden zurückerstattet werden soll. Noch nicht erfasste Beträge der Bestellungen werden freigegeben und können nicht mehr erfasst werden.
Kauf-Button Farbe
Kauf-Button Textfarbe
Checkbox Farbe
Checkbox-Haken Farbe
Link Farbe
Header Farbe
Rahmen-Radius Der Rahmen Radius in Pixel Einheiten.
Terms Page Geben Sie den Link zu Ihren AGB ein. Im Checkout wird dann zu diesen AGB verlinkt.
Cancellation terms page Geben Sie den Link zu Ihrer Widerrufsbelehrung ein. Im Checkout wird dann zu dieser verlinkt.
Allow separate shipping address Darf der Kunde eine separate Lieferadresse angeben oder muss diese der Rechnungsadresse entsprechen?
Disable autofocus Der Checkout wird nicht automatisch anvisiert.
Soll der Bestand bei Klarna Checkout Bestellungen validiert werden? Soll der Bestand direkt vor der Bestellanlage nochmal geprüft werden? Die Shopware Abverkaufseinstellungen werden beachtet"
External payment methods Welche Zahlungsarten sollen als externe Zahlungsarten zur Verügung gestellt werden?
External checkouts Welche Zahlungsarten sollen als externe Checkouts zur Verügung gestellt werden? Aktuell werden nur PayPal Express und Amazon Pay unterstützt.
Customer checkbox Soll der Kunde die Möglichkeit haben, sich automatisch nach dem Bestellvorgang ein Kundenkonto anlegen zu lassen?
Newsletter checkbox Soll der Kunde die Möglichkeit haben, sich autoamtisch nach dem Bestellvorgang bei dem Shop Newsletter zu registrieren.
Custom checkbox Dies zeigt eine Checkbox im Checkout an, welche Standardmäßig nichts tut. Die Funktion kann von anderen Plugins aus befüllt werden.
Sollen bei einem Fehlerfall technische Fehlermeldungen angezeigt werden? Sollen bei einem Fehlerfall (während der Checkout lädt), technische Information angezeigt werden? Dies sollte im Produktivsystem ausgeschaltet werden.
Protokoll-Level Wählen Sie das Protokoll-Level, um festzulegen, wie detailliert Klarna Ereignisse protokolliert werden sollen. Produktion: Nur Fehler werden gelogget (Timestamp, Order id etc.) Debug: Alle Informationen von und nach Klarna werden gelogget (Timestamp, Orderid etc.)
Protokoll-Ablaufzeit Wählen Sie, wie lange (in Tagen) Log-Dateien gespeichert werden sollen, bevor sie automatisch gelöscht werden.

Sie können die Klarna logs herunterladen indem Sie in den Plugin Einstellungen auf den "Protokoll-Datei runterladen" Button klicken

Zahlungsart konfigurieren

Das Klarna Checkout Plugin inkludiert eine Shopware Zahlungsart: Klarna Checkout. Diese wird beim installieren des Plugins angelegt, allerdings ist diese standardmäßig inaktiv. Das heißt, Sie müssen die Zahlungsart manuell aktivieren.

Das können Sie tun indem Sie zu Einstellungen -> Zahlungsarten navigieren.

Die folgenden Felder dürfen nicht angepasst werden: Bezeichnung, Name, Template, Systemklasse und Datenbank-Tabelle.

Aktivieren Sie nun die Klarna Checkout Zahlungsart

Versandkosten konfigurieren

Bevor die Klarna Zahlungsart genutzt werden kann, muss diese für die verschiedenen Versandmethoden freigegeben werden. Navigieren Sie zu Einstellungen -> Versandkosten

Wählen Sie die Versandkosten aus, welche für die Klarna Zahlungsart verfügbar sein sollen.

Wählen Sie nun den Reiter Zahlart Auswahl und verschieben Sie die Klarna Zahlungsart von Verfügbar auf Ausgewählt.

Wiederholen Sie den Vorgang, für alle Versandkosten welche angeboten werden dürfen, wenn die Klarna Zahlungsart verwendet wird.

Externe Zahlungsarten konfigurieren

{note} Für die externen Zahlungsarten ist ein Bild optional.

Externe Zahlungsarten auswählen

Öffnen Sie die Einstellungen des Plugins indem Sie zu Einstellungen -> Grundeinstellungen -> Weitere Einstellungen -> Klarna Checkout navigieren.

Hier können Sie die externen Zahlungsarten auswählen:

Bilder für externe Zahlungsarten

Für die externen Zahlungsarten können Sie ein Bild bereitstellen, welches im Klarna Checkout für die jeweilige Zahlungsart angezeigt wird.

Dies können Sie für jede Shopware Zahlungsart individuell tun, indem Sie zu Einstellungen -> Zahlungsarten navigieren.

Wählen Sie den Reiter Freitextfelder aus.

Hier können Sie eine URL zu dem Bild für die ausgewählte Zahlungsart eingeben.

Externe Checkouts konfigurieren

{note} Für die externen Checkouts muss ein Bild hinterlegt werden.

Externe Checkouts auswählen

{note} Aktuell werden nur PayPal Express und Amazon Pay als externe Checkouts unterstützt.

Öffnen Sie die Einstellungen des Plugins indem Sie zu Einstellungen -> Grundeinstellungen -> Weitere Einstellungen -> Klarna Checkout navigieren.

Hier können Sie die externen Zahlungsarten auswählen:

Bilder für externe Checkouts

Für die externen Zahlungsarten müssen Sie ein Bild bereitstellen, welches im Klarna Checkout für die jeweilige Zahlungsart angezeigt wird.

Dies können Sie für jede Shopware Zahlungsart individuell tun, indem Sie zu Einstellungen -> Zahlungsarten navigieren.

Wählen Sie den Reiter Freitextfelder aus.

Hier können Sie eine URL zu dem Bild für die ausgewählte Zahlungsart eingeben.

Plugin aktivieren

Nun können Sie das Plugin aktivieren. Navigieren Sie zum Plugin Manager (s. Plugin Installieren) und aktivieren Sie das Plugin indem Sie auf das rote "X" klicken.

Sie werden nun gefragt, ob Sie den Cache leeren wollen. Wählen Sie "Ja" aus.

Anschließend werden Sie noch gefragt, ob Sie das Theme neu kompilieren wollen. Wählen Sie hier ebenfalls "Ja" aus.

Laden Sie das Backend nun einmal neu, um alle Funktionen zu aktivieren.

Plugin deinstallieren

Um das Plugin zu deinstallieren müssen Sie zum Plugin Manager navigieren (s. Plugin Installieren).

Da können Sie nun das Plugin deinstallieren indem Sie auf das rote icon klicken, welches einem Stoppschild ähnelt.

Es werden keine Bestellungen oder Zahlungsarten dadurch gelöscht. Die Zahlungsarten werden jedoch auf inatkiv gesetzt. Löschen Sie die Zahlungsarten auch manuell nicht, weil es sonst zu Problemen mit Bestellungen kommen kann welche mit Klarna bezahlt wurden.