Klarna Checkout for WooCommerce is a plugin that extends WooCommerce, allowing you to take payments via Klarna.
This plugin integrates with Klarnas latest platform (v3). You need an agreement with Klarna specific to the new platform to use this plugin.
- Klarna Checkout is available in Austria, Denmark, Finland, Germany, The Netherlands, Norway, Sweden, United Kingdom and the United States.
- You need an agreement with Klarna to be able to use this plugin.
- WooCommerce 3.7 or newer is required.
- PHP 5.6 or higher is required.
- A SSL Certificate is required.
Since of version 2.0.0 of the KCO plugin, the WooCommerce order will now be created first (in Pending status), then the Klarna order is placed, and finally the WooCommerce order is updated to Processing status. This update is more compatible with other WooCommerce plugins.
The new checkout flow also means that Pending orders can be visible in WooCommerce, where the payment has not been finalized in Klarna (for example card payment where there was not enough funds on the card). This is part of the general WooCommerce checkout flow, and it does not implicate that something is wrong. It is just a new scenario for the Klarna Checkout payment gateway. Read more about the checkout flow rewrite here.
Related Documentation↑ Back to top
- Order management
Read more about how to manage Klarna orders directly from WooCommerce.
- Klarna Checkout Hooks: Actions & Filters
Read more about available hooks in the Klarna Checkout plugin.
- Recurring payments
Klarna Checkout supports recurring payments via the WooCommerce Subscriptions plugin. Here is a guide to help you get started.
Required WooCommerce Settings↑ Back to top
- Make sure that you have enabled pretty permalinks in your WordPress installation. Otherwise callbacks from Klarna back to your store won’t work and orders will not be updated with the correct order status/information.
- Your site must be able to handle anchor links (or URI fragments) correctly. This means that when an anchor link is triggered the browser should not trigger a full reload of the page. You can test this by navigating to one of your website pages, enter a following /#testhash to the url in the browser address bar and then hit Enter. This shall not trigger a full reload of the page.
- It is recommended to enable guest checkout (Enable guest checkout setting in WooCommerce > Settings > Checkout).
- To get the order total to match between WooCommerce and Klarna you need to configure WooCommerce to display prices with 2 decimals. More information about displaying of prices and how it can cause rounding issues can be found in this article.
Configuration↑ Back to top
- Go to: WooCommerce > Settings > Payments > Klarna Checkout.
- Enable Klarna Checkout by checking the Enable Klarna Checkout checkbox.
- Title – Enter the title for the payment method displayed in the checkout and order confirmation emails
- Description – Enter the description of the payment method displayed in the checkout page.
- Separate shipping address – Tick this checkbox if you want to allow customers to use a shipping address that is not the same as their billing address.
- Other payment method button text – Customize the Select another payment method button text that is displayed in checkout if using other payment methods than Klarna Checkout. Leave blank to use the default (and translatable) text.
- Shipping details – Additional shipping information that will be displayed to customers in Klarna Checkout iframe after they have placed an order.
- Allowed Customer Types – Select if you want to sell both to consumers and companies or only to one of them (available for SE, NO and FI).
- Product URLs – Tick the checkbox if you want to send product and product image URLs to Klarna.
- Logging – Logging events in the module. The log can be found by navigating to → WooCommerce → System Status → Logs.
- Test mode – Tick the checkbox if you make purchases using a test account.
- Date of birth mandatory – Tick this checkbox if you want to make it mandatory for customers to enter their date of birth during checkout.
Europe / United States↑ Back to top
Based on your store base location and the countries you are selling to, you will use one or both of these sections. By adding merchant credentials to a specific region (Europe or the United States) you also enable Klarna Checkout as an available payment method for that region. Note that you need an agreement with Klarna for each region enabled.
- Production username – Username that you received from Klarna.
- Production password – Password that you received from Klarna
- Test username – Username for test purchases that you received from Klarna (if you have applied for a test account).
- Test password – Password for test purchases that you received from Klarna (if you have applied for a test account).
- Title mandatory (GB) – Check this to make customer’s title mandatory, only works for customers based in GB.
- Show prefill consent notice – Check this to prevent logged-in customers’ data from being sent to Klarna, only applicable for customers from Germany and Austria.
- Offer local payment methods for AT/DE/FI/NL customers – Checking this will offer local payment method to customers from each of these countries. If these options remain unchecked, only card payments will be available for customers from these countries, when checkout out with Klarna Checkout.
Color settings↑ Back to top
With the Color settings section, you have the possibility to alter the appearance of the Klarna Checkout iframe displayed in the checkout. Here you can change things like background colors, button colors and text colors.
Subscription support↑ Back to top
Klarna Checkout is compatible (in Sweden, Norway, Finland, Germany & Austria) with the WooCommerce Subscriptions extension for handling of recurring payments.
Read more about recurring payments with Klarna here.
Customizations↑ Back to top
In some cases you might need to change how Klarna Checkout is displayed in the checkout or modify the data sent from WooCommerce to Klarna. Here are a couple of articles describing how to modify your Klarna Checkout setup:
- Modify the display of the checkout via Hooks (action and filters).
- External Payment Methods.
- Extra Merchant Data.
Before you Go Live↑ Back to top
- When the installation is done and you are ready to go live you need to contact Klarna integration support. Klarna will then verify the integration before the shop goes live.
- Klarna Checkout should be the first/default payment method (if multiple payment methods are active). This can be adjusted in the section Payment methods in → WooCommerce → Settings → Payments.
- The Klarna logotype should be visible on the website (for example in the footer). More info and logos can be found here. Select your region, and you will be able to find logos and other branding available to you
Compatibility with themes & plugins↑ Back to top
- Klarna Checkout uses its own template file for displaying the checkout page and should work with most themes. However, the plugin is only tested with the Storefront theme and we do not guarantee that it will work with other themes. Common situations when errors occur are:
– Themes/plugins with customized template files for WooCommerce checkout page.
– Themes/plugins that modifies the checkout into a multi step checkout.
- The plugin and Klarna only handle product quantity that is specified as an integer. For instance you can’t send 1.5 as the product quantity to Klarna. If you sell products where you charge by length or dimension we recommend that you use the Measurement Price Calculator plugin.
- WooCommerce does not offer multi currency support. This can be handled via several different plugins. This plugin is compatible with the Currency Switcher for WooCommerce plugin from Aelia. We do not guarantee that other multi currency plugins will work together with the Klarna plugin.
Krokedil and Klarna do not offer help with adapting your theme or plugin within regular support.