Klarna
With the Klarna plugin, you integrate the Klarna payment methods in your online shop and make them available to your customers. To do so, download the Klarna plugin from the plentyMarketplace. Setup of the payment method is done with an assistant. You also have to carry out a few basic settings in your PlentyONE system so that the payment methods are activated in your system.
The explanations in this section apply after adding the plugin. You can find more information on adding and installing plugins in the Plugins section of the manual.
1. Requirement: Opening a Klarna business account
To work with Klarna, you first need a Klarna business account. You get information as well as login details when you open the account. Without these, the plugin cannot be set up and is not usable. In case you have not registered with Klarna yet or your Klarna customer ID does not start with Kxxxxx, send an email to vertrieb@klarna.com.
2. Completing the assistant
After you have installed the plugin the corresponding assistant is available. Proceed as follows to complete the assistant and thus set up the payment method.
Setting up a payment method:
-
Go to Setup » Assistants » Plugins » [select Plugin set].
-
Select the assistant Klarna.
-
Complete the assistant.
The payment method Klarna is available in your online shop.
Depending on the configuration of your plugin sets and clients, the Klarna assistant has to be completed more than once. Only this ensures that the Klarna payment methods are configured correctly and all functions such as event procedures and crons run smoothly in the background.
The following tables show you which assistants you have to complete in which plugin set. The upper row displays the configuration of the plugin sets and clients. The second row lists correspondingly, in which set the Klarna assistant has to be completed for which client.
Important: The examples are not about either or. The assistant has to be completed several times for multi-clients because it always also has to be completed in the plugin set which is linked with the main client.
Example 1:
Your plugin sets and clients: |
Plugin set 1 is linked with the main client |
Plugin set 2 is linked with multi-client 1 |
Plugin set 3 is linked with multi-client 2 |
Complete the assistant: |
Complete the Klarna assistant in this plugin set for all the clients. This means for the main client, for multi-client 1 and for multi-client 2. |
Complete the Klarna assistant in this plugin set for multi-client 1. |
Complete the Klarna assistant in this plugin set for multi-client 2. |
Example 2:
Your plugin sets and clients: |
Plugin set 1 is linked with the main client |
Plugin set 2 is linked with multi-client 1 and multi-client 2 |
Complete the assistant: |
Complete the Klarna assistant in this plugin set for all the clients. This means for the main client, for multi-client 1 and for multi-client 2. |
Complete the Klarna assistant in this plugin set for multi-client 1 and for multi-client 2. |
Example 3:
Your plugin sets and clients: |
Plugin set 1 is linked with the main client and to multi-client 1 |
Plugin set 2 is linked with multi-client 2 |
Complete the assistant: |
Complete the Klarna assistant in this plugin set for all the clients. This means for the main client, for multi-client 1 and for multi-client 2. |
Complete the Klarna assistant in this plugin set for multi-client 2. |
Example 4:
Your plugin sets and clients: |
Plugin set 1 is linked with the main client, with multi-client 1 and with multi-client 2 |
Complete the assistant: |
Complete the Klarna assistant in this plugin set for all the clients. This means for the main client, for multi-client 1 and for multi-client 2. |
3. Customer classes and shipping profiles
Make sure the payment method is allowed in the customer classes and is not deactivated in the shipping profiles. For this, you should consider first for which customer classes and shipping profiles the payment method should be allowed. This can be set individually.
Permitting the payment method in a customer class:
-
Go to Setup » CRM » Customer classes.
-
Open the customer class for which you want to permit the payment method.
-
Select the payment method from the list Permitted payment methods.
-
Save (save) the settings.
-
If needed, repeat these steps for other customer classes as well.
Checking payment method in existing shipping profiles:
-
Go to Setup » Orders » Shipping » Settings.
-
Click on the Shipping profiles tab.
-
Open the shipping profile in which the payment method should be allowed.
-
Check whether the payment method is selected in the Blocked payment methods area.
-
Deselect the payment method if you want to allow it for this shipping profile.
-
Save (save) the settings.
-
If needed, repeat these steps for shipping profiles as well.
4. Setting up event procedures
Set up event procedures so that all needed data are sent to Klarna. 5 event procedures are required for this.
4.1. Automatically sending shipping confirmations
In order for the payment to be activated with Klarna, a shipping confirmation has to be sent. For this, we recommend the following configuration.
-
Go to Setup » Orders » Events.
-
Click on Add event procedure ().
→ The Create new event procedure window opens. -
Enter a distinct name for the event procedure.
-
Select the event according to Table 1.
-
Save () the settings.
-
Carry out the additional settings according to Table 1.
-
Select the setting Active ().
-
Save () the settings.
| Setting | Option | Selection |
|---|---|---|
Event |
Outgoing items booked |
|
Filter 2 |
Order > Payment method |
Select all payment methods of the Klarna plugin. |
Filter 1 |
Order > Order type |
Order |
Procedure |
Plugins > Plugin: Send shipping confirmation to Klarna |
4.2. Automatically sending cancellations
If an order is cancelled, Klarna has to be informed. For this, we recommend the following configuration.
-
Go to Setup » Orders » Events.
-
Click on Add event procedure ().
→ The Create new event procedure window opens. -
Enter a distinct name for the event procedure.
-
Select the event according to Table 2.
-
Save () the settings.
-
Carry out the additional settings according to Table 2.
-
Select the setting Active ().
-
Save () the settings.
| Setting | Option | Selection |
|---|---|---|
Event |
Status change |
Select a status from the return range. |
Filter 2 |
Order > Payment method |
Select all payment methods of the Klarna plugin. |
Filter 1 |
Order Order type |
Order |
Procedure |
Plugins > Plugin: Send cancellation notification to Klarna |
4.3. Automatically sending refund information to Klarna
If a refund is issued, Klarna has to be informed. For this, we recommend the following configuration.
-
Go to Setup » Orders » Events.
-
Click on Add event procedure ().
→ The Create new event procedure window opens. -
Enter a distinct name for the event procedure.
-
Select the event according to Table 3.
-
Save () the settings.
-
Carry out the additional settings according to Table 3.
-
Select the setting Active ().
-
Save () the settings.
| Setting | Option | Selection |
|---|---|---|
Event |
New credit note |
|
Filter 2 |
Order > Payment method |
Select all payment methods of the Klarna plugin. |
Filter 1 |
Order > Order type |
Credit note |
Procedure |
Plugins > Plugin: Send refund to Klarna |
4.4. Automatically sending address changes
If the address given for an order is changed between the order creation and shipping, Klarna has to be informed. For this, we recommend the following configuration.
-
Go to Setup » Orders » Events.
-
Click on Add event procedure ().
→ The Create new event procedure window opens. -
Enter a distinct name for the event procedure.
-
Select the event according to Table 4.
-
Save () the settings.
-
Carry out the additional settings according to Table 4.
-
Select the setting Active ().
-
Save () the settings.
| Setting | Option | Selection |
|---|---|---|
Event |
Status change |
|
Filter 2 |
Order > Payment method |
Select all payment methods of the Klarna plugin. |
Filter 1 |
Order > Order type |
Order |
Procedure |
Plugins > Plugin: Send address change to Klarna |
4.5. Automatically send order item changes
If the the order items are changed between the order creation and shipping, For this, we recommend the following configuration.
-
Go to Setup » Orders » Events.
-
Click on Add event procedure ().
→ The Create new event procedure window opens. -
Enter a distinct name for the event procedure.
-
Select the event according to Table 5.
-
Save () the settings.
-
Carry out the additional settings according to Table 5.
-
Select the setting Active ().
-
Save () the settings.
| Setting | Option | Selection |
|---|---|---|
Event |
Status change |
Select the status, for which this event is to be activated. |
Filter 2 |
Order > Payment method |
Select all payment methods of the Klarna plugin. |
Filter 1 |
Order > Order type |
Order |
Procedure |
Plugins > Plugin: Send order item changes to Klarna |
5. Editing text elements
You can edit texts of the plugin in the Shop » Multilingualism menu. The texts can be adapted into all available system languages. To do so, proceed as described below.
Adapting language files:
-
Go to Shop » Multilingualism.
-
On the left side, select the Source language from the drop-down list.
-
On the right side, select the Target language from the drop-down list.
-
Expand the section payment method in the Klarna area.
-
Enter the text for the individual text elements in the area of the target language.
-
Save (save) the settings.
-
Deploy the plugin set again to apply these changes.
By selecting German as the Target language, you can adapt the German labels for your online shop. The selected labels are then also applied in the back end, only the addition Plugin: Klarna remains. This way, it remains traceable where a payment method comes from. Reload the back end to see the changes.
Find more information on how to edit online shop texts on the manual page Editing online store texts.