If you are looking for documentation regarding Klarna Checkout, you can find it here.

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, Denmark, Germany, Finland, France, Ireland, Italy, Netherlands, Norway, New Zealand, Poland, Portugal, Sweden, Spain, Switzerland, United Kingdom and United States.
  • You need an agreement with Klarna to be able to use this plugin.

  • Order management
    Read more about how to manage Klarna orders directly from WooCommerce.

Required WordPress/WooCommerce settings

  • 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.
  • 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.


  1. Go toWooCommerce > 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. This will however not effect the Payment method title displayed on the Checkout page as this title is set by Klarna.
  4. Test mode – Check the Enable Test Mode checkbox to place the payment gateway in test mode using test API keys.
  5. Logging – Check the Log debug messages to save debug messages to the WooCommerce System Status log found in WooCommerce → System Status → Logs.
  6. Hide What is Klarna? link – If checked, What is Klarna? will not be shown.
  7. Float What is Klarna link – Check this if you want to float the What is Klarna? link to the right.
  8. Product URLs – Check this 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 Order confirmation here.
  10. Customer type – Select the customer for the store (B2C or B2B).

Country settings

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. Production Klarna API username – Enter the API username that you downloaded in the Klarna Merchant Portal.
  2. Production Klarna API password – Enter the API password that you downloaded in the Klarna Merchant Portal.
  3. Test Klarna API username – Username for test purchases that you downloaded in the Klarna Merchant Portal (if you have applied for a test account).
  4. Test Klarna API password – Password for test purchases that you downloaded in the Klarna Merchant Portal (if you have applied for a test account).

Iframe settings

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.

Set up Klarna Payments for test purchases

Find your test credentials and set up your WooCommerce store for test purchases:

  1. Sign up for a Playground (test) environment at Klarna, or log in if you already have signed up for this, at the Klarna Merchant Portal.
  2. Go to Settings and click on Generate new Klarna API credentials
  3. Save or download your keys
  4. Go to the Klarna Payments settings in WooCommerce.
  5. Enable the Test Mode and make sure that you also Log debug messages.
  6. Enter your test Username and Password.
  7. Save the settings.

Make a test purchase

In your shop Checkout you should now see a green “Test drive” banner, confirming that you are in test mode.

You can now make test purchases using the sample data from Klarna.

Compatibility with themes & plugins

  • 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.

Read more about compatibility on these links:
Klarna Payments – Compatible plugins

Klarna Payments – Known compatibility issues

Krokedil and Klarna do not offer help with adapting your theme or plugin within regular support.


The plugin itself has no limitations regarding currency.

However, please note that there can be limitations in the agreement you have with Klarna.

When it comes to questions regarding supported currencies you should always talk to your payment provider. The exception is when the plugin in fact do have limitations.

You can see what currencies Klarna support and read more about it here.


  • 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.

Go live

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.