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)

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

Zahlungsarten aktivieren

Das Klarna Payments Plugin inkludiert die Zahlungskategorien Pay now, Pay later und Slice it. Im Rahmen von Pay now sind ebenfalls die einzelnen Zahlungsarten Direct Bank Transfer (Sofortüberweisung), Direct Debit (Lastschrift) und Klarna Credit Card (Kreditkarte) verfügbar.

Bitte aktivieren Sie unter Einstellungen -> Zahlungsarten die Zahlungsarten, die Sie nutzen möchten.

Zahlungsarten den Versandarten zuweisen

Bevor die Klarna Zahlungsarten genutzt werden können, müssen diese für die Versandmethoden freigegeben werden. Navigieren Sie zu Einstellungen -> Versandkosten, wählen Sie eine Versandart aus für welche die Klarna Zahlungsarten verfügbar sein sollen 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, bei denen die Klarna Zahlungsarten verfügbar sein sollen.

Plugin deinstallieren

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

Klarna Instant Shopping

Klarna Express Button

Mit dem Klarna Express Button ermöglichen Sie es Ihren Kunden, ihr bestehendes Klarna Konto für den Login in Ihrem Shop zu nutzen. Der Button wird im Warenkorb bzw. Checkout-Prozess des Shops bei einer Gastsitzung angezeigt.

Voraussetzungen für Klarna Express

Ihr Händlerkonto muss für Klarna Express freigeschaltet sein, um den Button anzeigen und nutzen zu können. Bitte wenden Sie sich hierfür an den Händlersupport.

Darstellungsoptionen für Klarna Express

Ü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

Default	Dunkel	Hell

Button Label

Default	Klarna

Button Form

Default	Rechteck	Oval

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

Bedienung und Verwendung

Rechnungvorlage anpassen

Falls Sie über Shopware auch Rechnungen erstellen, können Sie Ihre Rechnungsvorlage innerhalb der PDF-Belegerstellung anpassen, um weitere Informationen zur Zahlung via Klarna zu ergänzen.

Automatische Klarna Aktionen

Sehen Sie hierfür die Dokumentation innerhalb des Order Management.

Informationen für Entwickler

Extra Merchant Data

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

Erstellung der Session

Für die Ergänzung von weiteren Daten bei der Erstellung der Klarna-Session kann das Event BestitKlarnaPayments\Components\Constants::EVENT_CREATE_SESSION_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 BestitKlarnaPayments\Components\Constants;
use Enlight\Event\SubscriberInterface;

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

    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;
    }
}

Autorisierung einer Zahlung

Für die Ergänzung von weiteren Daten bei der Authorisierung einer Zahlung kann das Event BestitKlarnaPayments\Components\Constants::EVENT_AUTHORIZE_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 BestitKlarnaPayments\Components\Constants;
use Enlight\Event\SubscriberInterface;

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

    public function authorizeOrderAddEmdData()
    {
        $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;
    }
}

Bestellabschluss

Für die Ergänzung von weiteren Daten beim Bestellabschluss kann das Event BestitKlarnaPayments\Components\Constants::EVENT_PLACE_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 BestitKlarnaPayments\Components\Constants;
use Enlight\Event\SubscriberInterface;

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

    public function placeOrderAddEmdData()
    {
        $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;
    }
}

Theme Anpassungen

Bei allen nachfolgenden Anpassungen und Erweiterungen handelt es sich um Beispiele und Vorlagen. Sie können die entsprechenden Elemente an jeder Stelle ergänzen.

Klarna Logo

Um das Klarna Logo in der Fußzeile hinzuzufügen, erweitern Sie das Template frontend/index/footer-navigation.tpl in Ihrem Theme.

{extends file='parent:frontend/index/footer-navigation.tpl'}
{block name='frontend_index_navigation_klarna_Logo'}
    <div class="footer--column column--menu block">

    {block name="frontend_index_footer_column_information_menu_headline"}
        <div class="column--headline">{s name='FooterPayWithKlarna'}Zahlen Sie mit{/s}</div>
    {/block}

    {block name="frontend_index_footer_column_information_menu_content"}
        <img src="https://cdn.klarna.com/1.0/shared/image/generic/logo/de_de/basic/logo_black.png?width=100"
             alt="{s name='FooterPaymentAlt'}Zahlungsart{/s}"/>
    {/block}
    </div>
{/block}

Um das Klarna Logo auf der Artikeldetailseite hinzuzufügen, erweitern Sie das Template frontend/detail/content/buy_container.tpl in Ihrem Theme.

    {extends file='parent:frontend/detail/content/buy_container.tpl'}
    {block name='frontend_detail_klarna_Logo'}
                <div class="column--headline">{s name='FooterPayWithKlarna'}Zahlen Sie mit{/s}</div>
                <img src="https://cdn.klarna.com/1.0/shared/image/generic/logo/de_de/basic/logo_black.png?width=100"
                     alt="{s name='FooterPaymentAlt'}Zahlungsart{/s}"/>
    {/block}

Um das Klarna Logo im Kopfbereich hinzuzufügen, erweitern Sie das Template frontend/index/logo-container.tpl in Ihrem Theme.

    {extends file='parent:frontend/index/logo-container.tpl'}
    {block name='frontend_index_logo'}
        {$smarty.block.parent}
        <div class="logo--Klarna block">
                <picture>
                    <source srcset="https://cdn.klarna.com/1.0/shared/image/generic/logo/de_de/basic/logo_black.png?width=100" media="(min-width: 78.75em)">
                    <source srcset="https://cdn.klarna.com/1.0/shared/image/generic/logo/de_de/basic/logo_black.png?width=100" media="(min-width: 64em)">
                    <source srcset="https://cdn.klarna.com/1.0/shared/image/generic/logo/de_de/basic/logo_black.png?width=100" media="(min-width: 48em)">
                 
                    <img srcset="https://cdn.klarna.com/1.0/shared/image/generic/logo/de_de/basic/logo_black.png?width=100" alt="{s name='FooterPaymentAlt'}Zahlungsart{/s}" />
                </picture>
        </div>
    {/block}

Klarna Banner

Um den Klarna Banner im Header hinzuzufügen, erweitern Sie das Template frontend/index/shop-navigation.tpl in Ihrem Theme.

    {extends file='parent:frontend/index/shop-navigation.tpl'}
    {block name="frontend_index_top_bar_Klarna"}
        // Hier können Sie Ihren eignen gewünschten Banner ersetzen .. 
        <script src="https://cdn.bannerflow.com/bf-placements/5a70b4697010901ca00890ab?targeturl=https%3A//www.klarna.com&politeloading=off&merchantid=501901433" async></script>
    {/block}

Um den Klarna Banner im Hauptseite hinzuzufügen, erweitern Sie das Template frontend/home/index.tpl in Ihrem Theme.

    {extends file='parent:frontend/home/index.tpl'}
    {block name='frontend_home_index_banner'}
        {$smarty.block.parent}
        {block name="frontend_home_index_banner_klarna"}
                // Hier können Sie Ihren eignen gewünschten Banner ersetzen .. 
            <script src="https://cdn.bannerflow.com/bf-placements/5a70b4697010901ca00890ab?targeturl=https%3A//www.klarna.com&politeloading=off&merchantid=501901433" async></script>
        {/block}
    {/block}    

Um den Klarna Banner im Footer hinzuzufügen, erweitern Sie das Template frontend/index/footer.tpl in Ihrem Theme.

    {extends file='parent:frontend/index/footer.tpl'}
    {block name='frontend_index_footer_menu'}
        {block name="frontend_index_footer_menu_banner_klarna"}
                // Hier können Sie Ihren eignen gewünschten Banner ersetzen .. 
            <script src="https://cdn.bannerflow.com/bf-placements/5a70b4697010901ca00890ab?targeturl=https%3A//www.klarna.com&politeloading=off&merchantid=501901433" async></script>
        {/block}
        {$smarty.block.parent}
    {/block}

Um den Klarna Banner im Artikeldetailseite hinzuzufügen, erweitern Sie das Template frontend/detail/content/tab_container.tpl in Ihrem Theme.

    {extends file='parent:frontend/detail/content/tab_container.tpl'}
    {block name="frontend_detail_index_outer_tabs"}
        {block name="frontend_detail_index_Klarna_banner"}
                // Hier können Sie Ihren eignen gewünschten Banner ersetzen .. 
            <script src="https://cdn.bannerflow.com/bf-placements/5a70b080baae251e1ccc75e4?targeturl=https%3A//www.klarna.com&politeloading=off&merchantid=501901433" async></script>
        {/block}
        {$smarty.block.parent}
    {/block}  

Sonstiges

Hinweise für AboCommerce

Um AboCommerce mit Klarna Payments verwenden zu können, benötigen Sie mindestens die Plugin-Version 2.0.0 von Klarna Payments. Für die Konfiguration und Verwendung von AboCommerce empfehlen wir Ihnen die Plugin-Dokumentation.

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.