Über das Plugin

Voraussetzungen

Klarna Händlerkonto

Bevor Sie Klarna in Shopware einrichten und verwenden können, ist die Eröffnung eines Händlerkontos bei Klarna erforderlich. Um Testbestellungen durchführen zu können, ist ein separates Konto im Klarna Playground notwendig. Unser Händlersupport hilft Ihnen gerne bei der Freischaltung von Zahlungsarten und Länder weiter.

Technische Voraussetzungen

Um das Klarna Plugin installieren zu können, benötigen Sie eine lauffähige Umgebung von Shopware 6. Eine Installationsanleitung hierzu finden Sie unter Erste Schritte mit Shopware 6.

Folgende Systemvoraussetzungen des Plugins gelten:

• Shopware (Version >= 6.3)
• PHP (Version >= 7.2)
• Vollständige Installation von Shopware (Storefront und Administration, nicht Headless)

Installation & Einrichtung

Installation via First Run Wizard von Shopware

Klarna ist ein bevorzugter Zahlungsanbieter in Shopware 6. Sie haben während der Installation von Shopware die Möglichkeit das Klarna Plugin per einfachem Klick in Ihre Shopware-Installation zu laden. Nach der Installation von Shopware, werden Sie durch den Einrichtungsassistenten von Shopware 6 geführt. Der sogenannte First Run Wizard unterstützt Sie aktiv das Klarna Plugin einzurichten. Wählen Sie hierfür unter “Plugins” Ihr Land aus und anschließend “Payment” und dort das Klarna Plugin mit einem Klick auf den Button “installieren” aus. Klicken Sie anschließend auf “Weiter” um den First Run Wizard von Shopware fortzuführen.

Installation via Administration

Sollten Sie sich erst nach dem First Run Wizard für eine Installation des Klarna Plugins entscheiden, können Sie im Shopware Community Store unter https://store.shopware.com das Klarna Plugin kostenfrei für Ihre Shop-Domain (bzw. Shop-Domains) registrieren. Folgen Sie hierfür den Anweisungen unter https://store.shopware.com/dein-weg-zum-plugin. Nachdem Sie das Plugin lizenziert haben, finden Sie es in der Administration unter Einstellungen > System > Plugins > Einkäufe. Klicken Sie dann neben dem Klarna Plugin auf “Laden” um es in Ihre Shopware Installation herunterzuladen.

Installation via Community Store Direkt-Download

Sie haben die Möglichkeit in Shopware 6 auch ein Plugin manuell in Ihre Installation hochzuladen. Dies können Sie in der Administration via Einstellungen > System > Plugins > Plugin hochladen tun. Laden Sie hierfür das ZIP-Archiv des Plugins über https://account.shopware.com herunter und in Ihrer Installation wieder hoch. Eine Anleitung wie Sie das ZIP-Archiv erhalten, finden Sie unter https://store.shopware.com/dein-weg-zum-plugin. Sollten Sie das Plugin noch nicht lizenziert haben, können Sie im Shopware Community Store unter https://store.shopware.com das Klarna Plugin kostenfrei für Ihre Shop-Domain (bzw. Shop-Domains) registrieren. Folgen Sie hierfür den Anweisungen unter https://store.shopware.com/dein-weg-zum-plugin

Aktivieren des Plugins

Nachdem Sie das Klarna Plugin erfolgreich in Ihre Shopware 6 Installation geladen haben, können Sie es jetzt einrichten und aktivieren. Gehen Sie hierfür in der Shopware Administration auf die Übersicht Ihrer Plugins. Diese erreichen Sie via Einstellungen > System > Plugins. Hier finden Sie das Klarna Plugin in einem Auslieferungszustand. Wählen Sie über das Kontext-Menü (“...”) den Menüpunkt “Installieren” aus. Sie erhalten eine Erfolgsmeldung von Shopware, dass das Plugin erfolgreich installiert wurde. Zu Ihrer Sicherheit ist das Plugin jetzt installiert, jedoch noch nicht aktiviert, da Sie es zunächst mit Ihren Zugangsdaten und individuellen Einstellungen optimieren müssen.

Wizard

Nach der Installation kann das Klarna Plugin initial konfiguriert werden. Hierfür leiten wir Sie durch eine Installationsroutine. Um diese zu erreichen, aktivieren Sie zunächst das Plugin über den Schieberegler. Nachdem das Plugin aktiviert wurde, können Sie in der Administration via Einstellungen > Plugins > Klarna die Installationsroutine in Form eines Wizards aufrufen. Sie werden anschließend zur Routine weitergeleitet. Im Menüpunkt “Verkaufskanal” des Wizards haben Sie die Möglichkeit die Zahlungsarten von Klarna allen oder nur bestimmten Verkaufskanälen zuzuweisen: Wenn das Klarna Plugin für alle Ihre Verkaufskanäle zur Verfügung stehen soll, dann können Sie diese Einstellung überspringen, da standardmäßig die Auswahl “alle Verkaufskanäle” eingestellt ist. Soll das Klarna Plugin hingegen nur für einen bestimmten Verkaufskanal zur Verfügung stehen, wählen Sie Drop-Down-Menü des Feldes “Verkaufskanal” aus, für welchen Kanal konfiguriert werden soll. Weitere Kanäle sind erst nach der Fertigstellung des Wizards möglich.

Klicken Sie abschließend auf “Fertig”, um alle getroffenen Einstellungen des Wizards zu speichern. Sie werden anschließend auf die Plugin Konfiguration weitergeleitet. Der Wizard kann in der Plugin Konfiguration über den Button “Wizard starten” wieder geöffnet werden.

Plugin Konfiguration

Nachdem Sie den Wizard erfolgreich beendet haben, können Sie die Plugin Konfigurationen anpassen. Sollten Sie die Konfiguration zu einem späteren Zeitpunkt erneut anpassen wollen, können Sie in der Administration via Einstellungen > Plugins > Klarna wieder die Plugin Konfiguration aufrufen.

Wenn Sie alle Einstellungen auf dieser Seite speichern möchten, klicken Sie oben rechts auf den blauen Button “Einstellungen speichern”.

Verkaufskanal

Hier legen Sie fest, ob die nachfolgenden Einstellungen für “alle Verkaufskanäle” oder nur für bestimmte einzelne Verkaufskanäle gelten sollen.

Globale API Einstellungen

API Testmodus

Hier können Sie den API Testmodus aktivieren und deaktivieren. Wenn dieser aktiviert ist, werden nur Test-Bestellungen angelegt. Es finden keine Zahlungen statt, welche bspw. ein Konto belasten. Dieser Modus empfiehlt sich vor allem zum Testen der Funktionalität des Plugins, bei Updates oder bei der Ersteinrichtung Ihres Shops sowie in Development- oder Staging-Umgebungen. Der API-Testmodus sollte deaktiviert werden, sobald Sie Ihren Shop produktiv nutzen möchten.

Debug Modus

Hier können Sie den Debug Modus aktivieren und deaktivieren. Wenn dieser aktiviert ist, können Sie alle Eingaben, Ausgaben und Änderungen des Plugins im Klarna Plugin Log nachvollziehen.

API Einstellungen

API Benutzername und API Passwort

Tragen Sie hier Ihre API-Zugangsdaten für den Live- und Testmodus in die passende Abschnitte ein. Falls Sie Ihre Zugangsdaten nicht zur Hand haben, können Sie diese unter https://eu.portal.klarna.com/ abrufen. Ihre API-Zugangsdaten können Sie mit dem Button “API-Zugangsdaten testen”, welcher sich im Kopfbereich befindet, überprüfen. Sie erhalten dann eine Erfolgsmeldung oder einen Hinweis, welche Daten nicht korrekt zu sein scheinen. Sofern Sie noch keine Klarna Registrierung durchlaufen haben oder Ihre Klarna Kundennummer nicht mit Kxxxxxx beginnt, wenden Sie sich bitte per E-Mail an [email protected]

Europa und Nordamerika

Hinterlegen Sie je nach gewünschten Verkaufsländer Ihres Shops die entsprechenden Zugangsdaten für Europa und/oder Nordamerika. Falls Sie nur für eine Region den Verkauf anbieten, reicht es aus, die Eingabefelder der anderen Region leer zu lassen. Die zu verwendeten Zugangsdaten werden anhand des Rechnungslands herangezogen.

Grundeinstellungen

Klarna On-Site Messaging

Hier können Sie das Klarna On-Site Messaging aktivieren und deaktivieren. Falls Sie hierfür bereits Daten haben, dann können Sie die Felder für das Skript und das Snippet (Placement) für das Klarna On-Site Messaging ausfüllen. Falls Sie keine Daten haben, dann können Sie mit Klick auf “Generiere deine Daten hier”, Daten erstellen.

Das Klarna On-Site Messaging wird ausschließlich auf der Produktdetailseite angezeigt. Bei der Verwendung von Finanzierungs-Placements muss der Betrag über eine Variable ausgegeben werden, sonst wird kein Placement angezeigt.

<!-- Placement v2 -->
<klarna-placement
  data-key="credit-promotion-badge"
  data-locale="de-DE"
  data-purchase-amount="{{productPrice}}">
</klarna-placement>
<!-- end Placement -->

Es ist zwingend darauf zu achten, dass {{productPrice}} ohne Leerzeichen zwischen den geschweiften Klammern eingesetzt wird.

Zahlungsverhalten

Automatische Erfassung

Wählen Sie hier zwischen dem “Lieferstatus”, “Bestellstatus” oder deaktivieren Sie die automatische Erfassung. Wenn Sie “Lieferstatus” oder “Bestellstatus” gewählt haben erscheint eine weitere Auswahl, in der Sie festlegen können bei welchem “Lieferstatus” (z.B. verschickt, teilweise verschickt, offen usw.) oder “Bestellstatus” (z.B. offen, in Bearbeitung, erledigt usw.) der ausstehende Betrag automatisch erfasst werden soll. Bei der Auswahl “deaktivieren”, werden keine Beträge automatisch erfasst.

Automatische Rückerstattung

Wählen Sie hier zwischen dem “Lieferstatus”, “Bestellstatus” oder deaktivieren Sie die automatische Rückerstattung. Wenn Sie “Lieferstatus” oder “Bestellstatus” gewählt haben erscheint eine weitere Auswahl, in der Sie festlegen können bei welchem “Lieferstatus” (z.B. verschickt, teilweise verschickt, offen usw.) oder “Bestellstatus” (z.B. offen, in Bearbeitung, erledigt usw.) der erfasste Betrag automatisch zurückerstattet werden soll. Bei der Auswahl “deaktivieren”, werden keine Beträge automatisch zurückerstattet. Neben der automatischen Erfassung können Beträge auch manuell in jeder Bestellung erfasst und rückerstattet werden

Zahlungseinstellungen

Klarna Produkt

Zeigt an, ob Ihr Klarna Payments Plugin aktiv ist. Dies kann nur über den Wizard eingestellt werden. Um zum Wizard zu gelangen, klicken Sie in den Plugineinstellungen oben auf den Button “Wizard starten”.

Senden von Extra Merchant Data

Mit dieser Funktion wird es erlaubt über das Plugin weitere Daten von Shopware bereits bei der Anlage der Benutzersession und nach der Erzeugung der Klarna-Bestellung an Klarna zu übertragen (bspw. im Fall von zusätzlichen Feldern im Registrierungsprozess oder im Fall von Hotelbuchungen)

Soll das Klarna Badge im Footer angezeigt werden

Wenn Sie diese Einstellung aktivieren erscheint das Klarna-Logo im Fußbereich Ihres Shops. Falls Sie dies nicht wünschen deaktivieren Sie diese Einstellung.

Verwende den Autorisierungs-Callback

Durch die Aktivierung des Autorisierungs-Callbacks wird die Bestellung erstellt, auch wenn es auf der Client-Seite zu Kommunikationsproblemen kommt.
Zahlungsmethoden, die komplexe Kundeninteraktionen erfordern, z. B. das Wechseln zwischen Banking-Apps, sind anfällig für Kommunikationsprobleme. Dies kann dazu führen, dass der Kunde belastet wird, ohne dass die Bestellung in Shopware erstellt wird. Solche Fehler können sich auf die Konversionsraten Ihres Shops auswirken, wenn der Kunde glaubt, er habe eine Bestellung abgeschlossen, aber keine Bestätigung von Ihrer Seite erhält. Aktivieren Sie diese Option, um die Konversionsraten zu verbessern.

Klarna Express Checkout

Mit dem Express Checkout in Ihren können Ihre Kunden den Kauf bequem aus dem Warenkorb oder auf der Produktdetailseite mit einem einzigen Klick abschließen, ohne langwierige persönliche Informationen und Kreditkartendaten eingeben zu müssen.

Voraussetzungen für Klarna Express Checkout

Ihr Händlerkonto muss für Klarna Express Checkout freigeschaltet sein und benötigt einen dedizierten Clien-Key, um den Button anzeigen und nutzen zu können. Bitte wenden Sie sich hierfür an den Händlersupport.

Darstellungsoptionen

Über die Plugin-Konfigurationen stehen Ihnen verschiedene Möglichkeiten bereit, um den Button in Ihrem Shop optimal darzustellen. Bitte beachten Sie, dass alle Optionen von Klarna vorgegeben sind und keine individuellen Optionen ergänzt werden können. Nutzen Sie für individuelle Anpassungen am Button die CSS Klasse, die ebenfalls in der Konfiguration hinterlegt werden kann.

Button Theme

Standard	Dunkel	Hell

Button Form

Standard	Rechteck	Oval

Konfiguration im Verkaufskanel

Klarna steht nur in ausgewählten Ländern, Sprachen und Währungen zur Verfügung. Sollten weitere Länder oder weitere Kombinationen aus Land-Sprache-Währung im Verkaufskanal konfiguriert sein, so werden die Klarna Zahlungsarten nicht angeboten. Bitte beachten Sie, dass die verfügbaren Länder ggf. erst vom Händlersupport für Ihr Konto freigeschaltet werden müssen.

Plugin aktivieren/deaktivieren

Falls Sie das Klarna Payments Plugin aktivieren/deaktivieren möchten oder einfach nur den aktuellen Aktivierungsstatus einsehen möchten, wechseln Sie in der Administration zu Einstellungen > System > Plugins. Dort finden Sie den aktuellen Status in der Tabelle unter “Meine Plugins”. Der Status kann verändert werden, durch einen Klick auf den Schieberegler.

Plugin deinstallieren oder wiederherstellen

Wenn Sie das Plugin deinstallieren möchten, können Sie dies in der Administration via Einstellungen > System Plugins über das Kontext-Menü (“...”) beim Plugin mit Klick auf “Deinstallieren” machen. Anschließend wird das Plugin zwar noch unter “Meine Plugins” angezeigt, jedoch ist es nun deaktiviert. Über das Kontext-Menü haben Sie nun die Optionen “Installieren” und “Löschen”.

• Installieren: Das Plugin wird wiederhergestellt mit der ursprünglichen Konfiguration. Es gehen bei der Deinstallation keine Einstellungen verloren. Nach der Installation hat das Plugin jedoch noch den Status “Deaktiviert”. Der Status (Aktiviert/Deaktiviert) kann verändert werden, durch einen Klick auf den Schieberegler.
• Löschen: Wählen Sie diese Option nur dann, wenn Sie das Plugin wirklich endgültig löschen möchten. Zuvor muss das Plugin deinstalliert werden.

Zahlungsarten aktivieren/deaktivieren

Wenn das Klarna Payments Plugin aktiviert ist, können Sie alle von Klarna zur Verfügung gestellten Zahlungsarten für Ihre Verkaufskanäle nutzen. Aktuell stehen Ihnen folgende Zahlungsarten zur Auswahl:

• Kreditkarte
• Lastschrift (“Online Bank Transfer”)
• Ratenkauf (“Financing”)
• Rechnung (”Pay Later”)
• Sofortüberweisung (“Direct Debit”)

Damit Sie Ihren Kunden bestimmte Zahlungsarten zur Verfügung stellen können, wechseln Sie zu Einstellungen > Shop > Zahlungsarten. Hier finden Sie alle o.g. Zahlungsarten. Im Kontext-Menü haben Sie die Auswahl “bearbeiten” und “löschen”:

• Bearbeiten: Hier können Sie den Status (Aktiv/Inaktiv), das Logo (Beachten Sie, dass bereits zu jeder Zahlart ein Klarna-Logo standardmäßig eingeblendet wird in der Storefront), die Position im Checkout, die Beschreibung und die Verfügbarkeitsregel der jeweiligen Zahlungsart anpassen.
• Löschen: Hiermit löschen Sie die Zahlungsart komplett. Nach der Löschung können Sie diese Zahlungsart nicht mehr anpassen. Wenn Sie eine Zahlungsart gelöscht haben, diese aber zu einem späteren Zeitpunkt doch wieder nutzen möchten, dann müssen Sie das Klarna Payments Plugin über den Wizard erneut installieren.

Um einzelne Zahlungsarten zu aktivieren, wechseln Sie im Kontextmenü auf “Bearbeiten”. Anschließend muss der Schieberegler bei “Aktiv” geklickt werden, um den Aktivierungsstatus zu ändern. Wenn der Status auf “Aktiv” eingerichtet ist, können Kunden (in Abhängigkeit von den Verfügbarkeitsregeln) diese Zahlungsart anschließend im Checkout nutzen und Zahlungen darüber abwickeln. Bitte beachten Sie, dass die gewünschten Zahlungsarten auch in den Verkaufskanälen ausgewählt werden müssen, damit Kunden diese verwenden können.

Übersetzung der Zahlarten

Falls Shopware nicht mit Englisch als Systemsprache installiert wurde, werden die Zahlungsarten nicht korrekt übersetzt. Dies kann einfach unter Einstellungen > Shop > Zahlungsarten manuell angepasst werden.
Weitere Details zu diesem Fall finden Sie im Ticket NEXT-12900.

Einschränkung der Konfiguration unter Shopware 6.3.4.0 und höher

In Shopware 6.3.4.0 und höher kann die Vererbung der Pluginkonfiguration in einzelne Verkaufskanäle aktuell nicht korrekt dargestellt werden. Bitte beachten Sie, dass Sie deshalb ab Shopware 6.3.4.0 bis zu einem entsprechenden Klarna-Plugin-Update verkaufskanal-spezifische Einstellungen vollständig befüllen müssen.

Verwendung

Stornierung einer Bestellung durch den Kunden

Mit Shopware 6.2 haben Sie die Möglichkeit Ihren Kunden die Stornierung von Bestellungen über die Storefront zu erlauben. Diese Einstellung finden Sie in der Administration unter Einstellungen > Shop > Warenkorb > Stornierung erlauben.

Zahlartwechsel nach Bestellabschluss erlauben

Mit Shopware 6.2 haben Sie die Möglichkeit Ihren Kunden die Änderung der Zahlart nach Bestellabschluss zu erlauben. Sollten Sie das Klarna-Plugin vor Shopware aktualisiert haben, ist diese Option bei den Klarna Zahlungsarten deaktiviert. Um Ihren Kunden diese Funktion zu ermöglichen, wechseln Sie in der Administration zu Einstellungen > Shop > Zahlungsarten. Navigieren Sie für jede Klarna-Zahlungsart die Sie in Ihrem Shop verwenden über das jeweilige Kontext-Menü auf “Bearbeiten” und aktivieren Sie dort die Option “Zahlartwechsel nach Bestellabschluss erlauben”.

B2B Verkauf

Der Verkauf an andere Unternehmen ist mit Klarna nur in bestimmten Ländern möglich. Sehen Sie hierfür die Antwort auf die Frage Kann ich mit Klarna an andere Unternehmen verkaufen? aus dem Klarna Händlersupport.