Skip to main content

Klarna Checkout

Integration only for Callisto online stores

This page only contains instructions for integrating Klarna Checkout in Callisto online stores. The following instructions are not valid for Ceres stores!

Klarna Checkout is an integrated checkout solution that allows you to offer your customers several payment methods. Klarna Checkout is responsive. Klarna is a European provider of payment solutions for online trading. Klarna Checkout is available for several countries of delivery in continental Europe. Only customers based in these countries can pay for orders using Klarna Checkout. Please refer to Klarna Checkout UK if you are interested in a checkout solution for the United Kingdom.

1. Important notes

This chapter provides you with important information about integrating the payment provider in plentymarkets.

Klarna Checkout and store design

Note that the following conditions must be met before integrating Klarna Checkout successfully in plentymarkets:

  • Use of the standard design Callisto (Version 2 or higher)

  • Use of the individual order process

  • Safe handling of the plentymarkets CMS

  • Experience with integrating payment providers

1.1. Payment process with Klarna Checkout

The payment process can be described as follows: The customers enter their email address and the postcode of their invoice address into the Klarna checkout. For Klarna customers, the invoice address is filled in automatically. The customer clicks on Purchase now. Purchase on invoice is selected by default, i.e. the customer receives an invoice by email once the ordered items were shipped. During the order confirmation, the customer can also select a different payment method, i.e. choose another payment method available in the Klarna Checkout. The page for switching the payment method is hosted by Klarna. For the customer, the order process is completed at this point. For the seller, plentymarkets creates an order in the system.

1.2. SSL certificate

An iframe is used to integrate Klarna Checkout directly in plentymarkets. Thus, an SSL certificate is required for using this payment method.

1.3. Included payment methods

Klarna Checkout combines the following payment methods:

2. Registering with Klarna

If you would like to register with Klarna, then get in contact with them at the following email address: salj@klarna.com. You will receive the access data that you need for setting up Klarna in plentymarkets.

3. Setting up Klarna Checkout in plentymarkets

Proceed as described below to set up the interface to Klarna Checkout in plentymarkets.

Setting up the interface to Klarna Checkout:

  1. Go to System » Orders » Payment » Methods.

  2. Place a check mark next to the setting Also show inactive.

  3. Open the folder International.

  4. Open the folder Klarna.Click on Klarna Checkout.
    → The settings tab will be opened.

  5. Click on the Interface tab.

  6. Expand the client.

  7. Carry out the settings as desired. Pay attention to the information given in Table 1.

  8. Save the settings.

Table 1. setting up the interface to Klarna Checkout
Setting Explanation

Activate access data for all clients (stores)

Option is only visible if clients (stores) were set up.
Yes = The access data will be applied for all clients (stores), regardless of what is entered in the access data menus.
No = The same access data can be entered for the default online store and for additional clients (stores). Alternatively, you can request separate access data for your clients (stores).
Stores that do not have access data saved for them can not be used with Klarna Checkout.
Go to System » Client » Select client » Online store » Settings and make sure that you have selected the option Enable login for every store in the line Login. This makes it possible to support several clients.

Test mode / live

Activate either the test or the live mode.
sandbox = test mode
live = live mode

Default country

Select the default country.
Important: In plentymarkets, Klarna Checkout is available for the countries of delivery Germany, Austria, Finland, Norway and Sweden. This means that only customers based in these countries can pay orders using Klarna Checkout.

Telephone number as mandatory field

Activate to make the telephone number a mandatory field for customers.

Differing delivery address

Activate to allow customers to enter a different delivery address.

Activate Packstation

Activate to permit deliveries to Packstations. In this case, the option Differing delivery address also needs to be activated (see above).
Note: DHL must be mentioned in the name of shipping profiles that permit delivery to Packstations.

External payment providers

Activate to permit external payment providers.
The following payment methods can be offered in combination with Klarna Checkout:
PayPal, Amazon Pay, Amex, cash in advance, cash on delivery, Giropay, cash payment, direct debit
Check the spelling of these payment methods with Klarna because they need to be set up in plentymarkets exactly as specified by Klarna. Only active payment methods are taken into account.

Date of birth as mandatory field

Activate to make the date of birth a mandatory field for customers. The date of birth is mandatory for the payment methods Klarna invoice, Klarna account and direct debit.

Deactivate autofocus

Place a check mark to deactivate the autofocus on the email field in the Klarna Checkout. Other fields of the online store are focussed.

Button - Colour;
Button - Text colour;
Checkbox - Colour;
Checkbox - Check mark colour;
Header - Colour;
Link - Colour

Enter the Hexadecimal HTML codes of more appropriate colours if the Klarna Checkout’s default colour scheme does not match the design of your online store.

eID;
Shared secret

Enter the country-specific access data that you received from Klarna during the registration process.

4. Activating the payment method

Set up and activate the payment method Klarna Checkout in your plentymarkets system.

5. Permitting external payment methods in the Klarna Checkout

You can offer customers in Germany and Austria some external payment methods via the Klarna Checkout. However, you need Klarna to agree to these external payment methods. Therefore, contact Klarna before setting up external payment methods.

You need to spell the external payment methods exactly as specified by Klarna. Otherwise, Klarna will not accept the payment method. Check the exact spelling with Klarna before setting them up. The logos for the external payment providers also must have the exact size specified by Klarna. Some examples are given below. The default logos saved in plentymarkets are too big for the Klarna Checkout.
The available payment methods and image sizes are:

  • PayPal (276 x 48px)

  • Amazon Pay (276 x 48px)

  • Cash in advance (69 x 24px)

  • Giropay (69 x 24px)

  • Cash payment (69 x 24px)

  • Direct debit (69 x 24px)

  • Cash on delivery (69 x 24px)

Klarna continuously adds new external payment methods to the Klarna Checkout. Therefore, this list may not be complete.

Permitting external payment methods:

  1. Go to System » Orders » Payment » Methods.

  2. Place a check mark next to the setting Also show inactive.

  3. Open the folder International.

  4. Open the folder Klarna.Click on Klarna Checkout.
    → The settings tab will be opened.

  5. Click on the Interface tab.

  6. Expand the client.

  7. Activate the setting External payment providers.

  8. Save the setting.

Set up and activate the desired payment methods in the System » Orders » Payment » Methods menu in your plentymarkets system.

6. Activating the currency conversion

If you use Klarna Checkout, then you will need to make invoice amounts visible to customers in their own currency. In other words, you will need to convert currencies. plentymarkets allows you to use live conversion. Alternatively, you enter a price into the price column that you use for the specific currency.

Activating live currency conversion:

  1. Go to System » Client » Select client » Online store » Currency.

  2. Select the option Live conversion under Currency conversion.

  3. Save the settings.

  4. Go to System » Orders » Payment » Currencies.

  5. Select an option for the setting Automatically update conversion factors daily.

  6. Save the settings.

Activating currency conversion using price columns:

  1. Go to System » Client » Select client » Online store » Currency.

  2. Select the option use price column under Currency conversion.

  3. Save the settings.

  4. Go to System » Orders » Payment » Currencies.

  5. Select a price column for each currency.

  6. Save the settings.

7. Displaying Klarna Checkout in the online store

This section explains how to add Klarna Checkout to the individual order process in plentymarkets. This is done in several steps.

No changes to the active design

Do not make changes to your active design. Before making changes to the design, make a backup copy so that you can restore the original state of the design.

Do not insert the container for Klarna Checkout into the checkout templates

If you activated Klarna Checkout, then do not insert the container for Klarna Checkout {% Container_CheckoutKlarnaCheckout() %} into one of the checkout templates. Doing so may cause Klarna Checkout to interfere with the individual order process in plentymarkets. If you use Klarna Checkout, then make sure that end customers are able to access Klarna Checkout starting from the shopping cart preview. The shopping cart preview is in the template ItemViewBasketPreviewList in the plentymarkets default designs.

7.1. Adding the Select the country category

First, the following code example is inserted in a category of the type Container. The code example queries the country of delivery. Customers who live in countries where Klarna Checkout is not available will still be able to make purchases in your online store. You are required to make invoice amounts visible to customers in their own currency. This needs to be done for all of the countries where Klarna Checkout is available. Therefore, make sure that you convert currencies. The following descriptions are based on an unchanged Callisto design. If you have already begun customising the design, then you will need to take these modifications into consideration when using Klarna Checkout. Klarna Checkout is inserted in a category of the type Container.

Creating a category of the type container:

  1. Go to Item » Categories.

  2. Click on New category.
    → The Create new category window will open.

  3. Enter a name, e.g. Select the country.

  4. Click on Create.
    → The category will be opened and the Settings tab will be displayed.

  5. Select the option Container as the Type.

  6. Click on the Description 1 tab.

  7. Insert the code example.

  8. Save the settings.

Carry out additional settings, such as selecting the client, in the Settings tab.

Code example for Klarna Checkout:

<div id="selectShippingCountryContainer" class="container margin-top-1 margin-bottom-2">
	<h2>Select country of delivery</h2>
	<div id="selectShippingCountry" class="text-center">
	</div>
	<div class="text-right">
		<button class="btn btn-primary btn-lg btn-block-xs" data-plenty="click:checkCountryForPayment">
			<span>Next</span><span class="glyphicon glyphicon-chevron-right" aria-hidden="true"></span>
		</button>
	</div>
</div>

<script type="text/javascript">
	(function($) {
		function isJson(str)
		{
		    try
		    {
		        JSON.parse(str);
		    } catch (e) {
		        return false;
		    }
		    return true;
		}

				$(document).ready(function () {
			$.ajax('/rest/checkout/shippingcountryselect/?selectedShippingCountryID=' + $StoreCountryID + '&selectType=select',
			{
				type: "GET",
				success: function (response) {
					if(isJson(response))
					{
						$("#selectShippingCountry").append($(JSON.parse(response).data[0]));

					}
					else
					{
						$("#selectShippingCountry").append(response.data[0]);
					}
				}
			});
		});

				$("[data-plenty='click:checkCountryForPayment']").click(function() {
						var countries = $("#PlentyWebBasketShippingCountry")[0];
			var shipping = JSON.stringify({
										"CheckoutShippingCountryID": countries.options[countries.selectedIndex].value
				});

						$.ajax('/rest/checkout/',
			{
				type: "PUT",
				dataType: "json",
				data: shipping,
				success: function () {
										var countryCurrency = {
						1: "EUR",
						2: "EUR",
						20: "NOK",
						24: "SEK",
						11: "EUR"
					};
					$.ajax('/rest/checkout/methodsofpaymentlist/',
						{
							type: "GET",
							data: {Currency: countryCurrency[countries.options[countries.selectedIndex].value] || 'EUR', ShipToCountry: countries.options[countries.selectedIndex].value},
							success: function (response) {
								if(isJson(response))
								{
									var data = JSON.parse(response).data;

								}
								else
								{
									var data = response.data;
								}
								for (var i = 0, length = data.length; i < length; i++) {
																		if (data[i]["MethodOfPaymentID"] === 1403 || data[i]["MethodOfPaymentName"] === "Klarna") {
																				window.location.href = "{% Link_Checkout(10) %}";
										return true;
									}
								}

																window.location.href = "{% Link_Checkout(3) %}";
								return true;
							},
							error: function() {
															}
						});
				},
				error: function() {
									}
			});
		});
	}(jQuery));
</script>

7.2. Adding the Klarna Checkout category

Create a second category of the type Container, so that the Klarna Checkout is displayed to the customer after selecting a country of delivery.

Creating a category of the type container:

  1. Go to Item » Categories.

  2. Click on New category.
    → The Create new category window will open.

  3. Enter a name, e.g. Klarna Checkout.

  4. Click on Create.
    → The category will be opened and the Settings tab will be displayed.

  5. Select the option Container as the Type.

  6. Click on the Description 1 tab.

  7. Insert the container {% Container_CheckoutKlarnaCheckout() %} into the text field.

  8. Save the settings.

Carry out additional settings, such as selecting the client, in the Settings tab.

7.3. Adding order steps

Both newly created categories need to be added to the order steps of the individual order process.

Adding order steps:

  1. Go to CMS » Web design.

  2. Click on Settings.
    → The Design settings window will open.

  3. Click on the Clients tab.

  4. Click on a client.

  5. Click on the Order process tab.

  6. Click on Search for the 9th order process step.

  7. Select the newly created Select the country category.

  8. Click on Select.

  9. Click on Search for the 10th order step.

  10. Select the newly created Klarna Checkout category.

  11. Click on Select.

  12. Save the settings.
    → The order steps will be added.

7.4. Changing the order steps

The order steps are numbered for the individual order process. These numbers can be thought of as a sort of ID. "Purchase" is the 3rd order step in the individual order process. If you want to work with Klarna Checkout, then you will need to replace this order step with order step 9, i.e. with the order step for selecting a country of delivery and forwarding customers to Klarna Checkout. In addition, the shopping cart category needs to be edited so that customers who are logged into the online store will be able to access Klarna Checkout. The areas where order steps need to be customised are described below.

Customising the Purchase category:

  1. Go to Item » Categories.

  2. Open your design folder to list the subcategories.

  3. Open the category Log in.

  4. Click on the Description 1 tab.

  5. Search for Link_Checkout(3).
    → The link to the checkout should appear 2 times.

  6. Replace (3) with (9) in both instances.

  7. Save the settings.

The log in area also needs to include a note regarding the terms of use.

Customising the Shopping cart category:

  1. Go to Item » Categories.

  2. Open your design folder to list the subcategories.

  3. Open the category Shopping cart.

  4. Click on the Description 1 tab.

  5. Search for Link_Checkout(3).
    → The link to the checkout appears several times. However, only search for the instance with (3).

  6. Replace (3) with (9).

  7. Save the settings.

Also replace Link_Checkout(3) with Link_Checkout(9) in the categories Order process and Registration.

7.5. Editing templates

Edit the templates ItemViewBasketPreviewList, ItemViewItemToBasketConfirmationOverlay and NavigationCategories10Content to ensure that Klarna Checkout is correctly used and displayed. Make sure that the design you edited is assigned to a client and was published. This ensures that Klarna Checkout is available in your online store.

Editing the template ItemViewBasketPreviewList:

  1. Go to CMS » Web design.

  2. Open the folder Layout.

  3. Open the subfolder ItemView.

  4. Open the template ItemViewBasketPreviewList.

  5. Search for Link_Checkout(3).

  6. Replace (3) with (9).

  7. Save the settings.

Also replace Link_Checkout(3) with Link_Checkout(9) in the templates ItemViewItemToBasketConfirmationOverlay and NavigationCategories10Content.

7.6. Adding a note regarding terms of use

For German online stores, you need to insert a note regarding the Klarna Checkout’s terms of use underneath the login. If you are using Callisto Light 2 with the individual order process, then insert the note into the category "Log in".

Inserting note:

  1. Go to Item » Categories.

  2. Open the design’s folder.

  3. Open the folder for the category Log in.

  4. Insert the note regarding terms of use into the code so that it will be displayed underneath the login.

  5. Include a link to the Klarna Checkout’s terms of use in this note.
    → The following link leads to the terms of use for Germany: https://cdn.klarna.com/1.0/shared/content/legal/terms/EID/de_de/checkout (only available in German).

  6. Replace the URL’s EID with the ID of your Klarna account for Germany.

  7. Save the settings.

EN Payment Methods Klarna Checkout 01
Figure 1. note regarding the Klarna Checkout’s terms of use

7.7. Adding terms and conditions and cancellation rights

Your terms and conditions and cancellation rights will be displayed in the Klarna Checkout. You provide Klarna with the URL to the terms and conditions page of your plentymarkets system to achieve this. This page must also contain information regarding cancellation rights. You cannot provide this information on 2 different pages. Klarna adds the suffix #cancellation_rights to the URL to call up the information regarding cancellation rights. Therefore, you need to insert an anchor of the name <a name="cancellation_right">Cancellation rights for customers</a> into the page. Proceed as follows to make sure the link sent to Klarna contains the relevant information.

Adding terms and conditions and cancellation rights:

  1. Go to Item » Categories.

  2. Create a new category of the type content that contains both your terms and conditions and information regarding cancellation rights.

  3. Insert the anchor <a name="cancellation_right">Cancellation rights for customers</a> into the category at the point where the information regarding cancellation rights begins.

  4. Save the settings.

  5. Go to System » Client » Select client » Online store » Pages.

  6. From the drop-down list General terms and conditions page, select the page that contains both the terms and conditions and the information regarding cancellation rights.

  7. Save the settings.

8. Automatically sending shipping confirmations

Set up event procedures to inform Klarna when items are shipped, orders and returns are cancelled and when invoices are created or deleted. Ask your contact person in the Klarna integration team to test the functionality before you start using the interface live. Set up an event procedure to automatically send shipping confirmations to Klarna.

Setting up an event procedure
  1. Go to System » Orders » Events.

  2. Click on Add event procedure.
    → The Create new event procedure window will open.

  3. Enter a name.

  4. Select the event listed in table 2.

  5. Save the settings.

  6. Pay attention to the explanations given in table 2 and carry out the settings as desired.

  7. Place a check mark next to the option Active.

  8. Save the settings.

Table 2. event procedure for sending automatic shipping confirmations to Klarna
Setting Option Selection

Event

Order change: Outgoing items booked

Filter 1

Order > Order type

Order

Filter 2

Order > Payment method

Klarna Checkout

Procedure

Shipping > Send shipping confirmation to Klarna

Tip

The shipping confirmation informs Klarna that the order was shipped. It then activates the invoice, which will automatically be saved in the order as a PDF file. If you need the invoice earlier, then select an earlier event. However, please make sure that the items will actually be shipped.

9. Automatically sending returns

Set up an event procedure to automatically send returns to Klarna. For further information about creating returns, refer to the Return page of the manual.

Setting up an event procedure
  1. Go to System » Orders » Events.

  2. Click on Add event procedure.
    → The Create new event procedure window will open.

  3. Enter a name.

  4. Select the event listed in table 3.

  5. Save the settings.

  6. Pay attention to the explanations given in table 3 and carry out the settings as desired.

  7. Place a check mark next to the option Active.

  8. Save the settings.

Table 3. event procedure for sending automatic returns to Klarna
Setting Option Selection

Event

Order generation: New return (by customer)

Filter 1

Order > Order type

Return

Filter 2

Order > Payment method

Klarna Checkout

Procedure

Return > Send return to Klarna

10. Automatically sending cancellations

Set up an event procedure to automatically send cancellations to Klarna.

Setting up an event procedure
  1. Go to System » Orders » Events.

  2. Click on Add event procedure.
    → The Create new event procedure window will open.

  3. Enter a name.

  4. Select the event listed in table 4.

  5. Save the settings.

  6. Pay attention to the explanations given in table 4 and carry out the settings as desired.

  7. Place a check mark next to the option Active.

  8. Save the settings.

Table 4. event procedure for sending automatic cancellations to Klarna
Setting Option Selection

Event

Order change: Status change

Filter 1

Order > Order type

Order

Filter 2

Order > Payment method

Klarna Checkout

Procedure

Order > Delete Klarna invoice

11. Editing Klarna orders

You can edit orders coming from Klarna until the outgoing items have been booked. You do this in the same way as for the payment methods Klarna Invoice and Klarna Account. For further information, refer to the Klarna page of the manual.

12. Tips for an efficient workflow

Please pay attention to a few important notes in order to make processing Klarna orders as easy as possible:

  • You should always book the outgoing items and ship the items at the same time. This is because the 14 day payment deadline for payments on invoice begins for your customer when the outgoing items are booked.

  • Klarna should be notified of returns as soon as possible in order to avoid dunning letters.

  • If the customer cancels their order, then set it to the status cancelled as soon as possible so that the shopping cart value will no longer be reserved for the customer.

To top