Requirements

Klarna merchant account

Before you can set up and use Klarna in Shopware, you need to open a merchant account at 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, please see Getting Started with Shopware 5.

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

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 plugin settings via Settings -> Plugin Manager -> Installed -> Klarna Payments -> Open. The following configurations are available there

Configure payment method

The Klarna Checkout plugin includes the payment method Klarna Checkout, which must also be activated after installing and activating the plugin.

Please activate the payment type under 'Settings -> Payment types'.

Assign payment type to shipping types

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

Move the Klarna payment types from Available to Selected.

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

Configure external payment methods

Store the desired external payment types within the plugin configuration.

Images for external payment types

For external payment types, you can define an image that will be displayed in Klarna Checkout for the respective payment type. This is possible within the free text fields of a payment type.

Please enter a complete URL to an image here.

Configure external checkouts

Store the desired external checkout within the plugin configuration.

Images for external checkouts

For external payment types, you need to provide an image that will be displayed in the Klarna Checkout for the respective payment type. This is possible within the free text fields of a payment type.

Please provide a full URL to an image when doing so.

Uninstall plugin

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

Special configuration

Phone number as a required field

If you want to display phone number as a required field in Klarna Checkout, you can configure it accordingly in Settings -> Basic Settings -> Storefront -> Login / Registration.

Date of birth as a mandatory field

If you want to display the date of birth as a mandatory field in Klarna Checkout, you can configure this accordingly under Settings -> Basic Settings -> Storefront -> Login / Registration.

Address addition line 1 & 2

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 from 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

Technical information for developers

Custom checkbox

The custom checkbox can be filled with any function, which will be executed when the customer activates the checkbox in Klarna Checkout.

Customize checkbox text

The text can be customized via a text module in the Shopware backend. This is located in the namespace frontend/bestit/klarna/checkboxes with the name custom_event_checkbox.

Customize checkbox function

To extend the checkbox with a function a subscriber must be registered on the event BestIt_Klarna_Checkout_Custom_Checkbox. See the following example for a 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

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

Order completion

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

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

Other

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.

Within the Klarna checkout, the customer has the option to select a company address for B2B sales. In doing so, the customer is then redirected to the Shopware Standard Checkout, wherein the order can be completed as usual with other payment methods.