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 5. Eine Installationsanleitung hierzu finden Sie unter Erste Schritte mit Shopware 5.

• Shopware (Version >= 5.6)
• PHP (Version >= 7.2 und <= 8.1)
• SSL-Verschlüsselung

Installation und Konfiguration

Installation via Plugin-Manager

Installieren und Aktivieren Sie das Plugin über den Plugin-Manager im Shopware 5 Backend.

Plugin Konfiguration

Nach der erfolgreich abgeschlossenen Installation und Aktivierung des Plugin können Sie die Einstellungen des Plugins via Einstellungen -> Plugin Manager -> Installiert -> Klarna Payments -> Öffnen bearbeiten. Dort stehen Ihnen folgende Konfigurationen zur Verfügung

Zahlungsart konfigurieren

Das Klarna Checkout Plugin inkludiert die Zahlungsart Klarna Checkout, die nach der Installation und Aktivierung des Plugins ebenfalls aktiviert werden muss.

Bitte aktivieren Sie unter Einstellungen -> Zahlungsarten die Zahlungsart.

Zahlungsart den Versandarten zuweisen

Bevor die Klarna Zahlungsart genutzt werden kann, muss diese für die verschiedenen Versandmethoden freigegeben werden. Navigieren Sie zu Einstellungen -> Versandkosten, wählen Sie eine Versandart aus für welche die Klarna Zahlungsart verfügbar sein soll und wählen Sie den Reiter Zahlart Auswahl.

Verschieben Sie die Klarna Zahlungsarten von Verfügbar auf Ausgewählt.

Wiederholen Sie den Vorgang für alle Versandarten, die für die Klarna Zahlungsart verfügbar sein sollen.

Externe Zahlungsarten konfigurieren

Hinterlegen Sie die gewünschten externen Zahlungsarten innerhalb der Plugin Konfiguration.

Bilder für externe Zahlungsarten

Für die externen Zahlungsarten können Sie ein Bild definieren, welches im Klarna Checkout für die jeweilige Zahlungsart angezeigt wird. Dies ist innerhalb der Freitextfelder einer Zahlungsart möglich.

Bitte geben Sie hierbei eine vollständige URL zu einem Bild an.

Externe Checkouts konfigurieren

Hinterlegen Sie die gewünschten externen Checkout innerhalb der Plugin-Konfiguration.

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 ist innerhalb der Freitextfelder einer Zahlungsart möglich.

Bitte geben Sie hierbei eine vollständige URL zu einem Bild an.

Plugin deinstallieren

Das Plugin kann über den Plugin Manager im Shopware 5 Backend wieder deinstalliert werden.

Spezielle Konfiguration

Telefonnummer als Pflichtfeld

Falls Sie die Telefonnummer als ein Pflichtfeld im Klarna Checkout anzeigen wollen, können Sie dies unter Einstellungen -> Grundeinstellungen -> Storefront -> Anmeldung / Registrierung entsprechend konfigurieren.

Geburtsdatum als Pflichtfeld

Falls Sie das Geburtsdatum als ein Pflichtfeld im Klarna Checkout anzeigen wollen, können Sie dies unter Einstellungen -> Grundeinstellungen -> Storefront -> Anmeldung / Registrierung entsprechend konfigurieren.

Adresszusatzzeile 1 & 2

Klarna On-Site Messaging

On-Site Messaging aktivieren

Sofern Sie noch nicht für Klarna On-Site Messaging freigeschaltet sind, setzen Sie die Option On-Site Messaging aktivieren auf "Ja" und speichern Sie die Plugin-Konfiguration vom Klarna Payments Plugin nochmal ab. Sie werden nun durch den Aktivierungsprozess durchgeleitet. Für die Verwendung müssen die Terms of Usage (ToU) akzeptiert werden.

Darstellungsoptionen

Produktdetailseite

Off-Canvas Warenkorb

Warenkorb

Top strip promotion

Footer

In Einkaufswelten

Verwenden Sie hierfür das Element "Klarna Banner" und Konfigurieren Sie es Ihren Wünschen entsprechend in einer Einkaufswelt.

Individuelle Positionierung

Es ist möglich On-Site Messaging Placements in Ihrem Theme nach Belieben zu integrieren. Nutzen Sie hierfür die Templates im Pfad frontend/bestit_klarna_onsite_messaging/placements aus dem Klarna Plugin.

credit-promotion.tpl

sidebar-promotion.tpl

homepage-promotion.tpl

top-strip-promotion.tpl

Technische Informationen für Entwickler

Individuelle Checkbox

Die individuelle Checkbox kann mit einer beliebigen Funktion gefüllt werden, welche ausgeführt wird, wenn der Kunde die Checkbox im Klarna Checkout aktiviert.

Checkbox Text anpassen

Der Text kann via Textbaustein über das Shopware Backend angepasst werden. Dieser befindet sich im Namespace frontend/bestit/klarna/checkboxes mit dem Namen custom_event_checkbox.

Checkbox Funktion anpassen

Um die Checkbox mit einer Funktion zu erweitern, muss ein Subscriber auf das Event BestIt_Klarna_Checkout_Custom_Checkbox registriert werden. Siehe folgendes Beispiel für einen Subscriber.

<?php

namespace App\Subscriber;

use BestitKlarnaCheckout\Components\Api\Model\Order as KlarnaOrder;
use BestitKlarnaPayments\Components\Constants;
use Enlight\Event\SubscriberInterface;
use Enlight_Event_EventArgs;

class SomeSubscriber implements SubscriberInterface
{
    public static function getSubscribedEvents()
    {
        return [
            'BestIt_Klarna_Checkout_Custom_Checkbox' => 'doSomething',
        ];
    }

    public function doSomething(Enlight_Event_EventArgs $args)
    {
        /** @var KlarnaOrder $klarnaOrder */
        $klarnaOrder = $args->get('klarnaOrder');

        // Do something with the order...
    }
}

Extra Merchant Data

Die "Extra Merchant Data" Events ermöglichen Ihnen weitere Informationen und Daten an Klarna zu übermitteln.

Bestellabschluss

Für die Ergänzung von weiteren Daten beim Bestellabschluss kann das Event BestitKlarnaCheckout\Components\Constants::EVENT_CREATE_ORDER_ATTACHMENT verwendet werden. Ihre Implementierung muss dabei ein Objekt der Klasse BestitKlarnaOrderManagement\Components\Api\Model\Attachment zurückgeben. Siehe folgendes Beispiel:

<?php

namespace App\Subscriber;

use BestitKlarnaOrderManagement\Components\Api\Model\Attachment;
use BestitKlarnaCheckout\Components\Constants;
use Enlight\Event\SubscriberInterface;

class SomeSubscriber implements SubscriberInterface
{
    public static function getSubscribedEvents()
    {
        return [
            Constants::EVENT_CREATE_ORDER_ATTACHMENT => 'createOrderAddEmdData',
        ];
    }

    public function createSessionAddEmdData()
    {
        $attachment = new Attachment();

        $attachment->contentType = 'application/vnd.klarna.internal.emd-v2+json';
        $attachment->body = json_encode([
            'marketplace_seller_info' => [[
                'product_category' => 'Women\'s Fashion',
                'product_name' => 'Women Sweatshirt',
            ]],
        ]);

        return $attachment;
    }
}

Sonstiges

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.

Innerhalb des Klarna Checkouts hat der Kunde die Möglichkeit eine Firmenadresse für den B2B-Verkauf auszuwählen. Dabei wird der Kunde anschließend auf den Shopware Standard Checkout weitergeleitet, worin die Bestellung wie gewohnt mit anderen Zahlungsarten abgeschlossen werden kann.