Requirements

Klarna merchant account

Before you can set up and use Klarna in Shopware, you need to open a merchant account with Klarna. A separate account in Klarna Playground is required to perform test orders. Our merchant support will be happy to assist you in activating payment methods and countries.

Technical requirements

In order to install the Klarna plugin, you need a running environment of Shopware 5. For installation instructions, see Getting Started with Shopware 5.

• Shopware (Version >= 5.6)
• PHP (version >= 7.2 and <= 8.1)

Installation and configuration

Installation via plugin manager

Install and activate the plugin via the plugin manager in the Shopware 5 backend.

Plugin configuration

After the successfully completed installation and activation of the plugin, you can edit the settings of the plugin via Settings -> Plugin Manager -> Installed -> Klarna Payments -> Open. The following configurations are available there

Enable payment methods

The Klarna Payments plugin includes the payment categories Pay now, Pay later and Slice it. Within Pay now the individual payment methods Direct Bank Transfer (Sofortüberweisung), Direct Debit (Lastschrift) and Klarna Credit Card (Kreditkarte) are also available.

Please activate the payment methods you want to use under 'Settings -> Payment methods'.

Assign payment methods to shipping costs

Before Klarna payment types can be used, they must be enabled for shipping methods. Navigate to 'Settings -> Shipping costs', select a shipping method for which the Klarna payment methods should be available and select the tab 'Payment method selection'.

Move the Klarna payment methods from Available to Selected.

Repeat the process for all shipping methods where you want Klarna payment methods to be available.

Uninstall plugin

The plugin can be uninstalled via the Plugin Manager in the Shopware 5 backend.

Klarna Instant Shopping

Klarna Express Button

With the Klarna Express Button you enable your customers to use their existing Klarna account to login to your store. The button is displayed in the shopping cart or checkout process of the store during a guest session.

Requirements for Klarna Express

Your merchant account must be activated for Klarna Express to display and use the button. Please contact merchant support for this.

Display options for Klarna Express

Via the plugin configurations you have different options to display the button in your store in an optimal way. Please note that all options are predefined by Klarna and no individual options can be added. For individual adjustments to the button, use the CSS class, which can also be stored in the configuration.

Button Theme

Default	Dark	Light

Button Label

Default	Klarna

Button Shape

Default	Rectangle	Pill

Klarna On-Site Messaging

Activate On-Site Messaging

If you are not yet activated for Klarna On-Site Messaging, set the option 'Activate On-Site Messaging' to "Yes" and save the plugin configuration of the Klarna Payments plugin again. You will now be guided through the activation process. You must accept the Terms of Usage (ToU) in order to use it.

Display options

Product detail page

Off-canvas shopping cart

Shopping cart

Top strip promotion

Footer

In shopping worlds

Use the "Klarna Banner" element for this and configure it according to your wishes in a shopping world.

Individual positioning

It is possible to integrate on-site messaging placements in your theme as you wish. For this, use the templates in the path frontend/bestit_klarna_onsite_messaging/placements from the Klarna plugin.

credit-promotion.tpl

sidebar-promotion.tpl

homepage-promotion.tpl

top-strip-promotion.tpl

Operation and usage

Customize invoice template

If you also create invoices via Shopware you can customize your invoice template within the PDF document creation to add more information about payment via Klarna.

Klarna automatic actions

See the documentation within the Order Management for this.

Information for developers

Extra Merchant Data

The "Extra Merchant Data" events allow you to submit additional information and data to Klarna.

Session creation

To add more data when creating the Klarna session, you can use the BestitKlarnaPayments\Components\Constants::EVENT_CREATE_SESSION_ATTACHMENT event. Its implementation must return an object of class BestitKlarnaOrderManagement\Components\Api\Model\Attachment. See the following example:

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

Authorization of a payment

The event BestitKlarnaPayments\Components\Constants::EVENT_AUTHORIZE_ORDER_ATTACHMENT can be used to add additional data when authorizing a payment. Its implementation must return an object of class BestitKlarnaOrderManagement\Components\Api\Model\Attachment. See the following example:

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

Order completion

The event BestitKlarnaPayments\Components\Constants::EVENT_PLACE_ORDER_ATTACHMENT can be used to add additional data during order completion. Its implementation must return an object of class BestitKlarnaOrderManagement\Components\Api\Model\Attachment. See the following example:

<?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 customizations

All the following customizations and extensions are examples and templates. You can add the corresponding elements at any place.

Klarna logo

To add the Klarna logo in the footer, extend the frontend/index/footer-navigation.tpl template in your 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}

To add the Klarna logo on the item detail page, expand the frontend/detail/content/buy_container.tpl template in your 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}

To add the Klarna logo in the header area, expand the frontend/index/logo-container.tpl template in your 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

To add the Klarna banner in the header, expand the frontend/index/shop-navigation.tpl template in your 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}

To add the Klarna banner in the main page, expand the frontend/home/index.tpl template in your 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}    

To add the Klarna banner in the footer, expand the frontend/index/footer.tpl template in your 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}

To add the Klarna banner in the item detail page, expand the template frontend/detail/content/tab_container.tpl in your 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}  

Other

Notes for AboCommerce

To use AboCommerce with Klarna Payments you need at least plugin version 2.0.0 of Klarna Payments. For configuration and usage of AboCommerce we recommend you to read the plugin documentation.

B2B sale

Selling to other companies is only possible with Klarna in certain countries. For this, see the answer to the question Can I sell to other companies with Klarna? from Klarna merchant support.