Klarna Checkout for WooCommerce

2025.02.10 – version 2.13.4

• Fix – Added a refresh of the iframe as a checkout error is detected.

2024.09.23 – version 2.13.3

• Tweak – Adjusted the order comparison verification between Klarna and WooCommerce.
• Fix – Addressed Woo Quality Insights issues and recommendations.

2024.09.11 – version 2.13.2

• Fix – Fixed an undefined array key warning.

2024.09.10 – version 2.13.1

• Fix – Fixed compatibility with the “Product Bundles for WooCommerce” plugin.
• Fix – Fixed an issue where a quantity mismatch would occur when the product SKU is reused.
• Fix – Fixed an issue where checkout validation would fail due to different mapping of the “State” field between Woo and Klarna.
• Tweak – Added Germany (DE) to the list of countries that allow sale to B2B and B2C customers from the same checkout session.

2024.09.03 – version 2.13.0

• Feature – Added the ‘kco_customer_type_changed’ action hook that is triggered whenever the customer switches between organization and person in the checkout.
• Tweak – The view should no longer scroll up before the customer is redirected to the confirmation page unless an error notice has to be shown.
• Tweak – You can now overwrite the recurring payment token from the admin Subscription page.
• Fix – Fixed an issue where updating the payment method on a Klarna subscription would cause the renewal to fail.

2024.07.22 – version 2.12.9

• Tweak – Adjusted the order comparison verification between Klarna and WooCommerce.

2024.07.10 – version 2.12.8

• Tweak – Increase logging to identify discrepancy between the Klarna and WooCommerce orders.

2024.07.05 – version 2.12.7

• Fix – Fixed an issue where orders would be set to on-hold due to mismatch in shipping reference.

2024.07.04 – version 2.12.6

• Tweak – WooCommerce checkout error messages will now also appear in the Klarna modal, replacing the generic “Something went wrong” message. Previously, they only appeared on the checkout page as notices, requiring the customer to close the modal before they can see them.
• Tweak – Added a discrepancy check for when the Woo and Klarna order may differ in total order amount.
• Tweak – Added a discrepancy check for when the Woo and Klarna order may differ in order items.

2024.06.17 – version 2.12.5

• Tweak – Add support for the new Klarna API key format (thanks @didkan).

2024.06.12 – version 2.12.4

• Fix – Fixed a critical error in logging caused by a recent release of the third-party theme Avada.

2024.06.05 – version 2.12.3

• Fix – Bugfixes.

2024.05.15 – version 2.12.2

• Tweak – If the store serves exactly one country, and the default location is set to “No location by default”, that country will be used to determine payment gateway availability. This should prevent issues with the billing country not being set.
• Tweak – Added the billing_address_change event which should ensure that the billing address is consistent between Woo, and what is seen in the Klarna form.

2024.03.12 – version 2.12.1

• Fix – Bumped the plugin version.

2024.01.29 – version 2.12.0

• Feature – Added a new checkout flow: redirect. The redirect flow replaces the current embedded checkout, and redirects the customer to Klarna’s hosted payment page (“HPP”). Please refer to our documentation on how to enable this setting.

2024.01.08 – version 2.11.7

• Enhancement – Improved performance when redirecting to confirmation page.
• Tweak – If the template fails to load, the customer will now be notified about the reason. This should no longer prevent the customer from picking a different payment gateway when KCO is the default gateway.

2023.12.06 – version 2.11.6

• Fix – Added a check to ensure that a Klarna order is always, at most, processed once. This should prevent accidental order re-processing.

2023.10.09 – version 2.11.5

• Fix – Fixed deprecation warnings (thanks @jonasostrom!)
• Fix – Fixed issues related to “Smart Coupons” when the “apply before tax” setting is disabled.
• Tweak – Updated list of supported Upsell countries and methods.
• Tweak – Increased logging when issues do occur.

2023.07.26 – version 2.11.4

• Fix – Resolved an issue related to redirection when changing or updating the subscription payment method. Now, Klarna’s hosted payment page has been added to the list of allowed external URLs for ‘wp_safe_redirect’ function.
• Fix – Addressed an issue where the recurring token was not being saved appropriately. This was occurring because the orders containing subscriptions were not being correctly identified.
• Tweak – Removed the settings tab from the “Klarna Add-ons” page because its functionalities have been transferred to the plugin.
• Tweak – We will now validate the API credentials based on the active mode, whether it’s test or production. This enhancement should prevent the plugin from inaccurately attempting to verify production credentials when the test mode is in operation.

2023.07.18 – version 2.11.3

• Fix – Fixed an issue where the recurring token was no longer being displayed in the billing fields.
• Fix – Fixed an undefined index warning that ocurred when the shipping was shown outside of the iframe.
• Fix – When processing a payment, and the order is not found, we’ll now return the response in the expected format.

2023.06.28 – version 2.11.2

• Fix – Fixed an issue with how we made our meta queries when trying to find orders based on a Klarna order ID.
• Enhancement – Added a validation to ensure that the order returned by our meta query actually is the correct order by verifying that the Klarna order ID stored matches the one we searched for.

2023.06.26 – version 2.11.1

• Fix – Resolved a critical error that occurred in certain cases when an external payment method (“EPM”) was used and the order ID couldn’t be retrieved.

2023.06.20 – version 2.11.0

• Feature – The plugin now supports WooCommerce’s “High-Performance Order Storage” (“HPOS”) feature.
• Fix – Corrected a typo in transient name.
• Fix – Addressed a typo in the name of the order status (thanks @bhrugesh96!).
• Fix – Resolved an issue where the checkout would crash if invalid customer data was processed in the frontend events.
• Fix – Fixed a problem where the order review and checkout form would get stuck in a “blocked” state when the customer closes the Klarna modal without completing the order.
• Tweak – Due to API changes, the upsell feature would sometimes fail when receiving an empty body response. This has now been resolved.
• Enhancement – Updated logging to include the browser’s user agent.

2023.05.15 – version 2.10.2

• Fix – Fixed an issue where the Klarna modal would prevent the page from scrolling to the WooCommerce error notice.
• Fix – Fixed an issue with the $checkout_flow variable being referenced without being defined.
• Fix – Various spelling mistakes.

2023.02.21 – version 2.10.1

• Fix – Fixed an issue caused by passing an empty array to Klarnas billing or shipping address when creating a order.

2023.02.14 – version 2.10.0

• Feature – Pay for order purchases are now redirected to Klarna’s hosted payment page. This will now also happen when changing payment method.
• Fix – Fixed an issue where a fatal error would occur when logging due to a third-party plugin “RankMath”.
• Tweak – Delay saving the Klarna order id until we’re on the confirmation page.
• Tweak – Removed ‘wc-cart’ JavaScript dependency as it is no longer needed.

2022.12.08 – version 2.9.0

• Feature – Added subscription support for Denmark and the Netherlands.
• Tweak – Explicitly set the size of the branding icon to prevent it from growing out of proportion on certain themes.
• Tweak – If a business customer has saved their company details to WooCommerce, it will be used for prefilling the payment form.
• Tweak – Related to Klarna Shipping Assistant, the purchase currency is saved as a transient to add compatibility with currency switchers.
• Fix – Fixed pass by reference warning.
• Fix – Fixed an issue where the shipping tax would sometimes not be accounted for.
• Fix – Fixed an issue with recurring subscriptions and negative fee that occurs when renewing the subscription.

2022.10.26 – version 2.8.7

• Fix – The shipping phone number should now be saved to the subscription.
• Fix – Fixed an undefined index when trying to create or update the session.
• Enhancement – You can now use the ‘kco_locale’ filter to change the Klarna locale.
• Enhancement – Added support for PHP 8.

2022.09.21 – version 2.8.6

• Fix – Fixed an issue where WooCommerce reported about shipping changes happening despite no changes which prevented the customer from finalizing the purchase.
• Fix – Fixed undefined index and variable.
• Fix – Fixed an issue where the WC form would sometimes not be updated when changing billing country.
• Tweak – Added the “subscription” object.
• Tweak – The plugin’s JavaScript is now limited to run only on the checkout and order pay pages. This should fix the issue with the “Twenty Twenty-One/Two” themes where the buttons on the shop page would disappear when adding an item to the cart.

2022.08.15 – version 2.8.5

• Feature – Add new layouts for the checkout form, including a new theme.
• Enhancement – Compatibility with WordPress block themes.
• Tweak – Improved handling of shipping method changes during the checkout process along with a new filter ‘kco_shipping_auto_correct’.
• Tweak – Updated links to documentation.

2022.07.04 – version 2.8.4

• Tweak – Prevent the resume/suspend-cycle during validation.

2022.06.30 – version 2.8.3

• Fix – Fixed the error handling for upselling orders using Post Purchase Upsell For WooCommerce.

2022.06.28 – version 2.8.2

• Fix – The setting for changing border radius should now work as expected (thanks @adevade!)
• Fix – External payment methods (“EPM”) should now appear on the checkout page. EPM are not available for pay for order.
• Tweak – Added additional documentation on the settings page.
• Tweak – You can now use the ‘kco_wc_cart_line_item’ hook to filter out products that you don’t want to send to Klarna.

2022.05.25 – version 2.8.1

• Fix – Fix undefined index warning.

2022.05.23 – version 2.8.0

• Feature – Add support for the Post Purchase Upsell For WooCommerce plugin.
• Enhancement – Changed so the debuglog option is no longer autoloaded.
• Enhancement – Shipping address fields will now be prefilled by billing address data from WooCommerce when creating a Klarna order if no shipping address exists for the customer in WooCommerce.
• Fix – Product images and URLs will now be correctly sent to Klarna when using Pay for order.
• Fix – Fixed a incorrect template name reference.
• Fix – Fixed a issue that could cause a missmatch in order line references in the Klarna Portal.

2022.04.27 – version 2.7.4

• Enhancement – Remove the Klarna payment information text from emails sent to the admin. ( Thank you Andréas Lundgren ).
• Fix – External Payment methods will now be stripped from admin orders sent to customers. This is because we can not guarantee compatability with the payment gateways when this is the case.
• Fix – Reload the checkout page if the order no longer needs to be paid for to show the default WooCommerce checkout page.
• Fix – Fixed an issue that could happen if the Klarna order id is no longer set during the order validation.

2022.03.18 – version 2.7.3

• Fix – Update the minified JavaScript file from the 2.7.2 update that was missed.

2022.03.17 – version 2.7.2

• Tweak – Print any HTML part of the standard WooCommerce text for missing shipping methods if the customer address does not have a valid shipping method.

2022.03.09 – version 2.7.1

• Fix – Fix showing standard WooCommerce text for missing shipping methods when there is only a single shipping method available.

2022.03.08 – version 2.7.0

• Enhancement – Added a filter for the located checkout template when the Klarna checkout template is being used. The filter is kco_locate_checkout_template.
• Enhancement – Added the field ship_to_different_address as a standard field, to prevent it from being moved.
• Enhancement – Added shipping email and shipping phone to the default address that we send to Klarna if they are available.
• Fix – We will now show the standard WooCommerce text for missing shipping methods if the customer address does not have a valid shipping method.
• Fix – Fixed a bug that caused shipping options to not be updated properly on the normal checkout page if you had selected to show shipping options in Klarna Checkout.
• Fix – Fixed an issue caused by us printing error notices during AJAX calls.
• Fix – Fixed a incorrect log of GET order requests being logged as a POST request.
• Fix – Removed the ability to use External Payment Methods for admin created orders, since this caused an issue when switching to the other payment method on the confirmation page.

2021.12.16 – version 2.6.4

• Enhancement – Stored customer shipping address will now be sent to Klarna with the first request if you have enabled separate shipping address in the plugin.
• Enhancement – The Request URLs are now saved to the log entries to make debugging issues easier.
• Enhancement – Translations for the mail text addition have been added for several languages.
• Fix – Removed old code related to the shipping option callback from Klarna that we no longer use.

2021.11.17 – version 2.6.3

• Fix – Fixed an issue where we would sometimes print the same error notices twice.
• Fix – Fixed a bug that could cause incorrect order totals when using a fee with admin created orders / pay for order links.
• Fix – Fixed an issue where we did not update the renewal order with a new recurring token after the customer changes payment method for their subscription.

2021.10.26 – version 2.6.2

• Fix – Fixed an issue where we sent the incorrect giftcard amount to Klarna when using WC Giftcards.
• Tweak – Updated URLs to our documentation.
• Tweak – Update description of the setting that adds post purchase information to emails.

2021.09.29 – version 2.6.1

• Fix – Fixed so that billing and shipping addresses gets updated to the WooCommerce order after the customer changes the payment method for a subscription.
• Fix – Fixed an issues where the customer object would sometimes be missing from the Klarna order causing a PHP notice.
• Tweak – Updates the URLs to Klarnas docs for the post purchase email information.
• Tweak – Bumped minimum supported versions for WooCommerce to version 4.0.0.

2021.08.25 – version 2.6.0

• Feature – We now support Pay for order. You can now create an order in advance on the admin page and send a pay link to a customer, where they can finish the payment using Klarna Checkout.
• Feature – We will now save the last 15 requests to Klarna that had an API error and display them on the WooCommerce status page. This should help with getting error messages when you need to debug issues without going through the logs. These will also be in the status report that you can send to us for support tickets.
• Fix – Fixed some error notices related to PHP 8.0.

2021.08.03 – version 2.5.9

• Enhancement – Added a filter to the fields we ignore when moving extra checkout fields on the checkout page. This filter is “kco_ignored_checkout_fields” and expects an array of strings that are the HTML element IDs of the fields you wish to not have moved.
• Fix – Fixed a bug causing you to have to click some setting groups twice to have them properly expand.
• Fix – Fixed an issue that could happen if a customer no longer had shipping options available to them, the old methods would still show. (Thank you Himanshu Seth!).
• Fix – Removed the Klarna banner from the sidebar on the settings page.
• Fix – Fixed an issue that could happen if a coupon a customer was using is no longer valid for the customer. The checkout would not be updated properly.

2021.07.12 – version 2.5.8

• Fix – Trigger .change after adding country via shipping_address_change. So country change in checkout is update correctly in Woo.

2021.06.16 – version 2.5.7

• Fix – Fixed an issue with PHP 8.0 that could cause a fatal error.
• Fix – Fixed a typo in one of the log entries from the frontend JavaScript.

2021.06.03 – version 2.5.6

• Fix – Update the minified JavaScript file from the 2.5.5 update that was missed.

2021.06.02 – version 2.5.5

• Fix – Fixed an issue that could happen if you had shipping set to be calculated on billing address in WooCommerce, but allowed for seperate shipping in Klarna.
• Fix – Errors that happen on AJAX calls are now properly logged instead of [Object, Object] in the status log when placing an order.

2021.04.27 – version 2.5.4

• Fix – Move our hidden shipping field to the billing address fields to prevent issues if you remove the order comments from the checkout using the filter woocommerce_enable_order_notes_field.
• Fix – Prevent unlocking the iframe during the order submission process.
• Fix – Fixed an issue with not sending shipping tax to Klarna if you had prices exclusive of tax and shipping in the Klarna iframe.

2021.04.07 – version 2.5.3

• Fix – Removed old code that would set the Klarna checkout page to be considered to also be the cart page.

2021.04.01 – version 2.5.2

• Fix – Fixed the total amount being calculated correctly if the shipping is in the iframe. This could cause an extra line item to be added to the Klarna order.

2021.03.31 – version 2.5.1

• Fix – Prevent shipping from being added to the Klarna order if shipping in the iframe is selected.

2021.03.31 – version 2.5.0

• Feature – Added a setting to select if you want to show the order details in Klarna, WooCommerce or in both during the checkout process. Default is to show it in WooCommerce as the order review.
• Enhancement – Improved the calculation flow for the plugin so we are more inline with the WooCommerce standard.
• Enhancement – Improved the speed of update calls to Klarna to enhance the checkout experience for the customer.
• Enhancement – Removed the dependency of URL fragments, or hashtag urls. This should improve the comptability with some other plugins that use a similar feature to display content.
• Fix – Fixed a issue with a fee reference beeing to long in some cases.
• Fix – Fixed a issue with updating the Klarna order incorrectly during order submission if the cart had been cleared at this point.

2021.02.17 – version 2.4.3

• Enhancement – We now save the recurring token from Klarna to the parent subscription order. If the token fails to be set for the subscription we will then get it from the Parent order instead. Should help some in cases where renewals fail when getting a HTTP error from Klarna.
• Enhancement – When moving from Klarna V2 to V3, in some cases the recurring token was missing on the subscription. If this is the case we will now fetch it from the parent order.
• Fix – Fixed an issue with the additional checkboxes feature.
• Fix – Fixed an issue that could cause a malformed JSON object in the requests to Klarna. This would happen if an order line was removed causing the keys set to be out of order.
• Fix – We now correctly save the shipping organization name.
• Fix – Fixed an issue where we tried to get the quantity of fees.

2021.01.12 – version 2.4.2

• Enhancement – Improved logging around checkout errors. The checkout error that stops the purchase is now being logged to make debugging easier.
• Enhancement – Payment method changes to subscriptions are now confirmed instantly when changing to Klarna or updating a expired card. The push is no longer required, but is still used as a backup.
• Fix – Fixed an issue with zero value orders not being completed properly when using Klarna.
• Fix – Fixed an issue were the page was not properly reloaded when not using Klarna for zero value orders.
• Fix – Fixed an issue were coupons and shipping prices did not register in the Klarna iFrame properly.

2020.12.16 – version 2.4.1

• Enhancement – Several improvements to our JavaScript, making the checkout experience faster and smoother.
• Enhancement – Added links to our documentation for the admin notices that we can print to make it easier to find a solution.
• Enhancement – Changed the way data is stored for the Klarna Shipping Assistance ( previously Klarna Shipping Service ) plugin. We now save it as a transient named kss_data_{klarna_order_id}.
• Fix – Removed the account fields ( account name and password ) from our ignored fields list. This will allow for account creation with custom password and username on the checkout page when placing an order.
• Fix – Fixed an issue were changing only the address line for the shipping address in Klarna Checkout would cause the postcode to be cleared from shipping calculations.

2020.11.18 – version 2.4.0

• Feature – Add setting to allow the store to force the validation of a national identification number. Only applicable for SE, NO, FI and DK.
• Feature – Add a filer for additional checkboxes. This allows for using the checkbox that we include in the settings allow with your own checkboxes as needed. The filter is “kco_additional_checkboxes”. Please check Klarnas documentation for how to format the data.
• Enhancement – Add support for PW Gift Cards.
• Enhancement – Save the B2B reference field to the WooCommerce order and display if on the order page.
• Enhancement – Replace the action “kco_wc_before_checkout_form” with the WooCommerce standard action “woocommerce_before_checkout_form”. This allows for more compatibility with other plugins.
• Enhancement – Add support for Mailchimp abandoned cart again.
• Enhancement – Add error message if pretty permalinks is not enabled on the admin page.
• Tweak – Update the go live link for the American market.
• Fix – Prevent fields from inside the order review table from being moved. For example some shipping method fields could be moved and duplicated.
• Fix – Limit the size of the Klarna logo on the admin page.

2020.10.21 – version 2.3.2

• Enhancement – Added a filter for the name of the extra surcharge used for rounding.
• Enhancement – Saved the added surcharge to the order so that it can be used by other plugins if needed.
• Enhancement – Delayed the priority for our confirmation step on the init action. It fixes some timing issues with other plugins that also run on priority 10.
• Enhancement – We now save the organisation number for B2B purchases and display them on the admin order page.
• Fix – Fixed logic for the rounding surcharge to only be applied when it should.
• Fix – Fixed logic when testing credentials, it should no longer give a error when not entering test credentials.

2020.09.30 – version 2.3.1

• Fix – Fixed an issue with shipping not being added correctly.

2020.09.30 – version 2.3.0

• Feature – Added support for getting Klarna subscription ID from _klarna_recurring_token (support for KCO v2 to v3 subscription transfer).
• Feature – Check if testmode is active that test credentials are added before saving settings.
• Enhancement – Updated the flow of the EPM process. Sets the payment method before processing the payment.
• Enhancement – Added 10 second timeout to all requests made to Klarna.
• Fix – Prevent issue by adding a default tax rate of zero if tax rate is missing.
• Fix – Prevent adding a surcharge with zero value.
• Fix – Fixed an issue with the setting for adding Klarna links in the email not being set generating error notices.
• Fix – Fixed an issue with missing address data from Klarna generating a error notice.

2020.09.07 – version 2.2.0

• Enhancement – Improvement to how we calculate taxes for the Klarna orders. This should improve compatibility with other plugins and adds better support for things like zero decimals.
• Enhancement – Added compatibility with the plugin WooCommerce Gift Cards. https://woocommerce.com/products/gift-cards/
• Enhancement – Added the action ‘woocommerce_review_order_before_submit’ to our template. It is added before the iFrame.
• Enhancement – Added compatibility for the WP GDPR Compliance plugin.
• Fix – Fixed an issue with zero decimals.
• Fix – Fixed an issue with WooCommerce subscription when using a startup fee for the subscriptions parent order.

2020.09.01 – version 2.1.4

• Tweak – Added action kco_wc_confirm_klarna_order so other plugins can hook into the confirm order process.
• Fix – Redirect customer to thankyou page if response to an update request returns a READ_ONLY message from Klarna.
• Fix – Updated subscription payment method change to work properly with KCO v2.x.

2020.07.30 – version 2.1.3

• Fix – Remove kcoResume in shipping_option_change to avoid issues with order total not being displayed correct when changing shipping options with KSS (Klarna Shipping Service).

2020.07.29 – version 2.1.2

• Fix – Fixed an issue with regions for Ireland.

2020.07.03 – version 2.1.1

• Fix – Fixed an issue that made the iFrame to not be suspended on update_checkout event. Caused the iFrame to not update to display the proper information.

2020.07.01 – version 2.1.0

• Feature – Added post-purchase information to emails being sent to the customer with links to Klarna support and the Klarna app. Can be enabled in the settings for the plugin.
• Enhancement – Improved the confirmation page. We now redirect directly to the thankyou page to improve speed and reduce the risk of any error. Also removes the need to do any database queries in this step.
• Enhancement – Limited the “flickering” of the iFrame on the checkout page.
• Enhancement – Improvements to the Klarna banner on the admin pages.
• Fix – Fixed an issue with the selected shipping method not being displayed properly when showing shipping in the iFrame.
• Fix – Removed an unused old definition used by our old logging. Should prevent issues when using the old plugin at the same time as the current plugin

2020.06.23 – version 2.0.16

• Enhancement – Changed so we always force an update of the Klarna order on the pageload for the checkout.
• Enhancement – Added a filter ( kco_wc_cart_line_item ) to Klarna line items.
• Enhancement – We now catch 403 errors for the credentials verification when saving the plugin settings. Also added more text to further help in this issue.
• Fix – Changed redirect for EPM to use wp_redirect as wp_safe_redirect caused an error.
• Fix – Fixed the checkout page product amount input fields no longer working.
• Fix – Fixed the naming of a parameter for the push and notification callbacks from Klarna.

2020.06.11 – version 2.0.15

• Enhancement – Added a limit to only get orders for 2 days back to confirmation page database queries.
• Enhancement – Added order id to the confirmation page parameters to prevent the need to get an order from the database. Should improve speed of the checkout process.
• Enhancement – Added function to validate credentials when saving settings. Will display an error if your credentials are not valid.
• Enhancement – Changed the API settings name and description.
• Enhancement – Updated the Klarna banners shown on the admin pages.
• Fix – Limit product names to max 255 characters.
• Fix – Made region field not required when using KCO. This prevents issues for countries that have region fields in WooCommerce, but none is provided by Klarna.
• Fix – Fixed an issue where we attempted to access our settings before they were saved.

2020.05.25 – version 2.0.14

• Enhancement – Make sure that order amount is zero for subscription payment method change.
• Enhancement – Improved JavaScript to support missing address data from Klarna. Supports a coming update to Klarnas system.
• Fix – Prevent trying to access empty array in some cases. ( Thank you Sarang Shahane )

2020.04.29 – version 2.0.13

• Enhancement – Added custom attribute to stop password and text fields in settings to be autofilled with incorrect data.
• Enhancement – Added clearing of KCO sessions after finalizing the purchase on the confirmation page. Better support for things like custom thank you pages.
• Fix – Added jQuery Block UI as a prerequisite for our checkout Javascript. Prevents JavaScript errors in case the checkout JavaScripts are loaded in a different order than normal.

2020.04.16 – version 2.0.12

• Fix – Reverted change from 2.0.11 “Better calculations for product unit price…” due to an issue with some tax settings.

2020.04.16 – version 2.0.11

• Fix – Better calculations for product unit price and total amount. …