1. Documentation /
  2. Klarna Payments – introduction

Klarna Payments – introduction

Klarna logo Klarna Payments for WooCommerce is a plugin that extends WooCommerce, allowing you to take payments via Klarna.
  • Klarna Payments is available in Australia, Austria, Belgium, Canada, Czech Republic, Denmark, Finland, France, Germany, Greece, Ireland, Italy, Mexico, Netherlands, New Zealand, Norway, Poland, Portugal, Romania, Spain, Sweden, Switzerland, United Kingdom and United States.
  • You need an agreement with Klarna to be able to use this plugin.
  • WooCommerce 5.6.0 or newer is required.
  • PHP 7.0 or higher is required.

Related documentation

↑ Back to top
  • v2 to v3 transition guide Step-by-step guide on how to switch from old plugin to Klarna Payments for WooCommerce plugin.
  • Order management Read more about how to manage Klarna orders directly from WooCommerce.

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.
  • 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
  1. Go to: WooCommerce > Settings > Payments > Klarna Payments.
  2. Enable Klarna Payments by checking the Enable Klarna Payments checkbox.
  3. Title – Payment method title. Changes what the payment method is called on the order received page as well as the email that is sent to the customer. The Title is not customizable by merchants within Woo checkout, as the title is set by Klarna.
  4. Description – Enter the description of the payment method displayed in the checkout.
  5. Test mode – Tick the checkbox if you make purchases using a test account.
  6. Logging – Logging events in the module. The log can be found by navigating to → WooCommerce → System Status → Logs.
  7. What is Klarna link – Tick the checkbox if you want to float the What is Klarna link to the right.
  8. Product URLs – Tick the checkbox if you want to send product and product image URLs to Klarna.
  9. Add Klarna Urls to order email – This will add Klarna urls to the order emails that are sent. You can read more about Klarna urls here.
  10. Customer type – Select the customer for the store (B2C or B2B).

Country settings

↑ Back to top
Each Klarna country has its own set of country specific settings. By adding merchant credentials to a specific country you also enable Klarna Payments as an available payment method for that country. Note that you need an agreement with Klarna for each country enabled and your store needs to be able to process purchases in the local currency.
  1. Description – Add a description for the specific country. If no description is added, the default description will be used.
  2. Title – Add a title for the specific country. If no title is added, the default title will be used.
  3. Production username – Username that you received from Klarna.
  4. Production password – Password that you received from Klarna
  5. Test username – Username for test purchases that you received from Klarna (if you have applied for a test account).
  6. Test password – Password for test purchases that you received from Klarna (if you have applied for a test account).

Iframe settings

↑ Back to top
With the iframe settings section you have the possibility to alter the appearance of the Klarna Payments Widget displayed in the checkout. Here you can change things like background colors, button colors and text colors.

Compatibility with themes & plugins

↑ Back to top
  • Klarna Payments 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 removes standard checkout fields. – 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.

Troubleshooting

↑ Back to top
  • If Klarna Payments isn’t displayed as an available payment method in checkout page make sure customer billing country is one of countries you have entered Klarna Payments credentials for and that selected currency matches customer billing country.

FAQ

↑ Back to top

Can I combine the cart and checkout on the same page?

↑ Back to top
No, you shoud not do this. WooCommerce has two different pages for cart and checkout. Some store owners want to reduce the steps for the customer to be able to complete an order, but this can cause conflicts and errors, and also look strange. If you only want one page for checkout and cart, we suggest that you remove the cart page from the equation and add functionality to change products in the shopping cart on the checkout page.

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.