Klarna Payments – introduction
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, Italy, Netherlands, Norway, New Zealand, Sweden, Spain, Switzerland, United Kingdom and United States.
- You need an agreement with Klarna to be able to use this plugin.
- WooCommerce 3.4 or newer is required.
- PHP 5.6 or higher is required.
- 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 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.
- 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.
- Go to: WooCommerce > Settings > Payments > Klarna Payments.
- Enable Klarna Payments by checking the Enable Klarna Payments checkbox.
- 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.
- Test mode – Check the Enable Test Mode checkbox to place the payment gateway in test mode using test API keys.
- Logging – Check the Log debug messages to save debug messages to the WooCommerce System Status log found in WooCommerce → System Status → Logs.
- Hide What is Klarna? link – If checked, What is Klarna? will not be shown.
- Float What is Klarna link – Check this if you want to float the What is Klarna? link to the right.
- Product URLs – Check this if you want to send product and product image URLs to Klarna.
- 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.
- Customer type – Select the customer for the store (B2C or B2B).
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.
- Production Klarna API username – Enter the API username that you downloaded in the Klarna Merchant Portal.
- Production Klarna API password – Enter the API password that you downloaded in the Klarna Merchant Portal.
- Test Klarna API username – Username for test purchases that you downloaded in the Klarna Merchant Portal (if you have applied for a test account).
- Test Klarna API password – Password for test purchases that you downloaded in the Klarna Merchant Portal (if you have applied for a test account).
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
- 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.
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.
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.