API and SDKsSupport
Changelog Salesforce

List of changes to the Klarna cartridge for Salesforce Commerce Cloud releases.

VersionRelease DateNotes
18.1.0Initial release of Klarna Payments SFRA.
19.1.0June 2019Added SFRA version
19.1.1Updated VCN to use the newest API version
19.1.2Fix auto capture for the pipelines cartridge
19.1.4
  • New country locales added
  • Minor bug fixes
  • Cartridge templates and forms updated for latest SFRA
19.1.5
  • Added additional verification for all notifications
  • Minor fixes around the configuration objects. Added Canadian support
  • Documentation updates
  • New country locales added
  • Updated VCN to store encrypted card details
21.1.0March 2021
  • Fixes around discounts taxation & VCN error handling
  • Added VCN improvements, additional OSM placements, BOPIS support
  • New IT, CA, FR & NZ country locales
  • Removed acknowledge call
  • Documentation updates
21.1.1March 2021
  • New On-Site Messaging attribute for Canada
  • Remove not required locale templates for SG Spain & Belgium
  • Documentation updates
21.1.2April 2021
  • Fixed core file naming convention issues in 21.1.0 and 21.1.1. Please upgrade to the latest version if you are currently using 21.1.0 or 21.1.1
  • Removed deprecated “scripts/util/Builder.js” file
21.2.0June 2021
  • Added Klarna Express Button
  • Moved Klarna session ID & client token from SFCC session privacy to Basket attributes
  • Changed KlarnaCountries definition to not replicable
  • Code cleanup
  • Documentation updates
21.3.1November 2021
  • Improvements for create_session errors
  • Expired user session issues related to empty shipment.shippingMethod
  • Additional locale (PL) included in config files
21.3.1November 2021Documentation updates.
22.1.0February 2022
  • Improvements for create and update session errors
  • Added Klarna Express Button in minicart.
  • Support for long running basket
  • Rate-limits by operations
22.2.0March 2022
  • One Klarna Optimisation
  • Mexico locale support
22.2.1April 2022Rollback of One Klarna Optimisation
22.3.0May 2022
  • SFRA ver. 6.0.0 support
  • Rollback hide VAT from Checkout functionality
22.3.1May 2022Fix User-agent version sent to Klarna services
22.4.0July 2022
  • Intent field addition in Klarna Payment session creation
  • Combine Klarna Authorization and Create Order in Checkout Review Step
22.4.0January 2023OM support
23.1.0July 2023
  • Fix issue with incorrect values for EMD
  • Improvement Klarna Auto Capture and error handling
  • Logging information for troubleshooting bugs
  • Add Auto_finalise=True to the review checkout flow
23.1.1September 2023
  • Fixed an issue where sessions with negative ordertax_amount occurred due to SFCC session expiration.
  • Support for compatibility mode 21.2
  • Replaced window.KlarnaOnsiteService.push with window.Klarna.OnsiteMessaging.refresh
23.2.0December 2023
  • Subscription Payments support: recurring payments and subscription handling directly within the SFCC environment. This update includes configuration options, subscription
management in the cart and checkout pages, and a customer dashboard for subscription oversight.
  • Klarna Bank Transfer payments: added a new server-side authorization callback feature for Klarna Bank Transfer payments, enhancing reliability across EU markets and supporting all existing KP cartridge functionalities.
24.1.0January 2024
  • Klarna Express checkout: a new feature introduced in Storefront where Express Checkout Button will be displayed in PDP, Cart and Mini Cart. Klarna Express checkout enables quick and easy checkout where Shipping Address, Billing Address and Payment details will be preselected so that Checkout can be completed in fewer clicks.
  • Fix for creating order service calls with 500 status responses: now orders are not created and error is thrown for these cases.
24.2.0March 2024
  • Update of On-Site Messaging functionality that is more aligned with current web standards, provides a consistent identifier system as used in Klarna Express Checkout, and offers enhanced customization options to our merchants. This will not only improve the user experience but also reinforce Klarna’s commitment to providing versatile and state-of-the-art e-commerce solutions. CSS customizations are available only in the new library version.
  • Documentation update - new section added for cartridge upgrade process.
24.3.0May 2024
  • Update of Klarna Express checkout configuration. The display of Klarna Express checkout buttons is now customizable by selecting preferred placements. By default, none is selected.
  • Documentation update – new section added “Klarna Display Conditions and Authorization Handling”.
24.4.0June 2024New features
  • RO and CZ countries support
  • Klarna Activation Custom Object
  • New Site Preferences: Klarna Activation (Klarna_Activation), Klarna Payments (Klarna_KP), Klarna Express Checkout (Klarna_KEC), Klarna On-site Messaging (Klarna_OSM)
Deprecations
  • Klarna Countries Custom Object
  • Site Preferences: Klarna Payments (Klarna_Payments), Klarna Recurring Payments (Klarna_RecurringPayments), Klarna Express Checkout (Klarna_ExpressCheckout)
  • Removed Site Preferences Attributes: kpServiceName, kpBankTransferCallback, kpRejectedMethodDisplay, kpNotAvailableMessage, vcnPrivateKey, vcnPublicKey, KpRateLimitByOperation, kpCreateNewSessionWhenExpires and sendProductAndImageURLs
Note: Site preferences and service credentials for the deprecated items are now obsolete and must be migrated to the new site preferences or activation custom object.
24.5.0October 2024
  • Sign In With Klarna (SIWK) feature, which allows customers to quickly and securely sign up for your store using their Klarna account.
  • this version includes migration to SFRA version 7.0.0.
  • Update of KEC parameter from client_key to client_id .
  • Fixed issue of KEC button not being displayed in mobile view for some users.
  • Fixed issue on the redirect back for some KEC users.
24.6.0November 2024
  • Updated the authorization token retrieval logic: the authorization callback now serves as a fallback for frontend communication failures across all payment methods, with a get session API call as a safeguard.
  • Defined a constant DATE_FORMAT = yyyy-MM-dd to replace hardcoded values in customerToken.js.
  • Fixed a reference error where requestUrl was undefined in klarnaPaymentsUpdateSession.js.

The Site Preferences and Custom Objects outlined in this section were deprecated in release 24.4.0 and will be removed in a future update. To ensure continued functionality, please upgrade to the latest version of the Klarna cartridge.

  1. In SFCC Business Manager, click Merchant Tools > Custom Objects > Custom Object Editor.
  2. Set the Object Type dropdown to KlarnaCountries.
  3. Click the Find button. Select the desired country to edit (see screenshot below).
  4. Update the required fields as mentioned in the KlarnaCountries section.
  5. Repeat for the other countries as necessary.
SFCC - Klarna Countries Custom Object

KlarnaCountries custom object settings

Configure Klarna Payments custom preferences

  1. In SFCC Business Manager, click Merchant Tools > Site Preferences> Custom Preferences > KlarnaPayments.
  2. Complete the settings as desired. Descriptions of the site preferences are in the Site Preferences section.

Configure Klarna Payments service

  1. In SFCC Business Manager, click Administration > Operations > Services.
  2. Click the Credentials tab. Each Klarna credential corresponds to one of the KlarnaCountries custom objects. Click on the one you want to edit.
  3. Enter the MID API username and API password received from Klarna.
  4. Update the URL field if using the Production environment. For Klarna API URLs, refer to Klarna API URLs.
SFCC - Klarna Payment Service Settings

Klarna Payment Service Settings

Configure Klarna rate limited service profile

  • Rate limits are managed by Klarna. The plugin handles the errors in case these are exceeded.
  • Default service klarna.http.defaultendpoint will be used for all Klarna Payments API calls.
  • For more information on rate limits please refer refer here.
  1. In SFCC Business Manager, go to Merchant Tools > Site Preferences > Custom Site Preferences Group > Klarna Payments.
  2. Set Rate Limit By Operation to Yes. If set to No, the default service will control the rate limit.
  1. Log into the SCC Business Manager.
  2. Go to Administration -> Operations -> Services.
  3. Choose a required profile (e.g., Klarna.http.createSession).
  4. Check the Enable Rate Limit box.
  5. Max Rate Limit Calls: Set to 50 (example: Higher rate limit of 50 requests/sec agreed with Klarna).
  6. Rate Limit Interval (milliseconds): Set to 1000.
  7. Repeat for all service operations with respective agreed rate limits.
SFCC - Example of create session rate limit profile

Example of create session rate limit profile