CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[2.12.0] - 2026-06-23

• Added Compose support for Klarna Network Payment Button and Klarna Network Identity Button with new klarna-network-payment-button-compose and klarna-network-identity-button-compose modules.
• Added Compose support for Klarna Network Messaging with new klarna-network-messaging-compose module.
• Disabled local file access and migrated to WebViewAssetLoader in WebViews by default for improved security.
• Fixed lifecycle handling of KlarnaStandaloneWebView to prevent WebView errors and crashes.
• Fixed inconsistent internal messages with Klarna components in WebViews.
• Removed deprecated/unused messages with Klarna components in WebViews.
• ⚠️ Deprecation: KCO integrations and support has been officially deprecated and will be removed in future versions of the SDK. Please migrate to Kustom Mobile SDK if you are integrating KCO via KlarnaCheckoutView, KlarnaHybridSDK or KlarnaStandaloneWebView.

[2.11.5] - 2026-06-09

• Separated Klarna Network button integrations into klarna-network-identity-button and klarna-network-payment-button modules.
• Fixed an issue where buttons would not react to theme changes on certain Activity configurations.

[2.11.4] - 2026-06-01

• Added KlarnaAcquiringConfig to initialize Klarna instances with payment account reference and acquiring account id.
• Improved internal identification of integration and runtime environment.
• Updated handshake response payload to include SDK package name.

[2.11.3] - 2026-05-08

• Added a concurrent authorize guard to Sign in with Klarna to prevent overlapping authorize requests.
• Improved coroutine lifecycle management across SDK controllers and views to prevent memory leaks.
• Improved fallback URL allowlist matching for the authentication browser.

[2.11.2] - 2026-04-13

• Separated WebView related implementations to a new klarna-core-webview module to reduce app size for integrating apps that do not use WebView features.
• Updated payment presentation intent values.
• Updated payment and identity button configuration type and intent parameters.

[2.11.1] - 2026-03-13

• Fixed an issue where internal weak references were removed by aggressive R8 optimizations.
• Fixed Android Custom Tabs redirect flows issues when different task affinities are used in the host application.
• Fixed an issue where browser and Android Custom Tabs redirect flows were not working when the application lifecycle is changed during the flow.
• Fixed memory leaks in Android Custom Tabs redirect flows.
• Added explicit ViewModelProvider.Factory implementations to prevent crashes when provider factory is overridden by the host application.
• Removed unused internal methods.

[2.11.0] - 2026-02-12

• Added Klarna Identity integration as part of Klarna Network with new klarna-network-identity module.
• Added ondemand services and subscription options to KlarnaPaymentRequestData.
• Added klarnaNetworkSessionToken property to KlarnaConfiguration when initializing Klarna.
• Added klarnaNetworkSessionToken property to KlarnaPaymentRequestStateContext object.
• Added paymentOptionId to KlarnaPaymentRequestData object.
• Added support for app-to-app handover flow to Klarna Payment integration.
• Added support to fetch Klarna Network Session Token.
• Added support to clear Klarna Network Session login state.
• Added icon and paymentButton properties to KlarnaPaymentPresentationPaymentOption object.
• Internal changes and optimizations to Klarna component messaging within WebView integration types.

[2.10.1] - 2025-12-03

• Optimized message queues for receivers in WebViews.
• Fixed broken Android Custom Tabs integration when the default browser does not support it.

[2.10.0] - 2025-11-13

• Added Klarna Messaging integration as part of Klarna Network with new klarna-network-messaging module.
• Added Klarna Payment Presentation content fetching to KlarnaPayment integration.
• Added improved support for links inside KlarnaOSMView with System WebViews.
• Fixed configuration change handling for features using System WebViews.
• Fixed an issue where a false positive log for callback call was being reported.

[2.9.1] - 2025-10-22

• Added file name sanization to file sharing feature to address app file manipulation vulnerabilities.

[2.9.0] - 2025-10-20

• Separated payments integrations KlarnaPaymentView and KlarnaExpressCheckoutButton to a new klarna-payments library module.
• Improved error handling and reporting for Sign in with Klarna flows.

[2.8.1] - 2025-10-10

• Removed KlarnaInitProvider in favor of App Startup library.
• Made KlarnaReturnReceiverActivity the default Activity that handles return URLs.
• Fixed incorrect/excessive logging of signInLoginFailed event.
• Discontinued publication of sdk-full and sdk-basic packages.

[2.8.0] - 2025-09-23

• Added support for Klarna Payment integration as part of Klarna Network.
• Added Shopping Session integration as part of Klarna Network.
• Added two new modules klarna-network-core and klarna-network-payment to support Klarna Network with least size impact to the integrating applications.
• Added more secure persistence support, including supporting expiry time for stored data.
• Added theme property to WebViews to support dark mode in Klarna components.
• Internal optimizations and improvements.

[2.7.1] - 2025-07-30

• Added transparency to KlarnaPaymentView.
• Added distribution relocation for sdk-basic and sdk-full variants prior to discontinuation.
• Added internal modularization for future product modules and improved maintenance.
• Replaced Gson with Kotlin Serialization.
• Internal fixes and improvements.

[2.7.0] - 2025-06-19

• Added Klarna Express Checkout integration with a native button.

[2.6.29] - 2025-06-12

• Removed full variant build with card scan support and made default basic the single artifact.
• Fixed an issue when reading the API endpoint URLs from the config JSON file.
• Internal fixes and improvements.

[2.6.28] - 2025-04-30

• Fixed a rendering issue in Sign in with Klarna button.
• Fixed an input verification issue in Sign in with Klarna.
• Internal fixes and improvements.

[2.6.27] - 2025-03-07

• Updated consumer proguard rules to prevent issues with R8 full mode.
• Removed IO operations from app startup initializer.
• Fixed issue with cached configuration not being used prior to updates.
• Fixed Sign in with Klarna button layout issues.
• Added more internal lint checks for security improvements.

[2.6.26] - 2025-03-04

• Fixed an issue related to handling runtime permission requests.
• Added new client ID and endpoint support in On-Site Messaging (OSM).
• Internal fixes and improvements.

[2.6.25] - 2025-01-10

• Added support for Single sign-on using Custom Tabs.
• Added handling of minimized Custom Tabs.
• Updated UI for Sign in with Klarna button.

[2.6.24] - 2024-12-04

• Fixed Klarna badge padding in KlarnaOSMView.
• Removed Google Play redirects for missing external applications.

[2.6.23] - 2024-11-19

• Fixed live camera preview for ID scanning in SDK WebViews.
• Updated development and build JDK to Java 17 and AGP to version 8.

[2.6.22] - 2024-10-30

• Fixed an issue when a merchant's app name contains non-ASCII characters.

[2.6.21] - 2024-10-22

• Added Sign in with Klarna tokenization.
• Improved OSM text rendering process.
• Bug fixes and security improvements.

[2.6.20] - 2024-09-04

• Added countermeasures for intent redirection vulnerability.
• Added additional logs for Sign in with Klarna integrations.
• Removed enforced consent prompt in Sign in with Klarna integrations.

[2.6.19] - 2024-08-05

• Removed unused HTTP url from source.
• Removed remote webview debugging configuration.
• Fixed internal events.
• Enabled Kotlin Explicit API mode.

[2.6.18] - 2024-07-03

• Implemented minor internal improvements.
• Fixed the ClassNotFoundException issue regarding the KlarnaShareFileProvider class.

[2.6.17] - 2024-05-10

• Added support for customizing the appearance of the On-Site Messaging (OSM) view.
• Fixed the "Learn more" text to not start from a new line in OSM view.
• Fixed encoding issue with non-UTF8 characters in a merchant's app name.

[2.6.16] - 2024-04-10

• Fixed class conflict issues due to obfuscation.
• Fixed conflicting FileProvider class manifest merger issue.

[2.6.15] - 2024-04-04

• Added NA and OC region support for Sign in with Klarna.
• Added native support for sharing/opening file contents.
• Card scanning results are wiped from memory after usage in the scanning module.
• Minor bug fixes and improvements.

[2.6.14] - 2024-02-29

• Bug fixes and stability improvements.

[2.6.13] - 2024-02-08

• Updated development and build JDK to JDK 11 and AGP to AGP 7.
• Resolved an issue preventing Sign in with Klarna integration when using a non-AppCompat theme.
• Deleted several internal APIs that were mistakenly exposed in earlier versions.
• Implemented several internal improvements and optimizations to enhance performance and reliability.

[2.6.12] - 2024-01-09

• Set the default variant of the SDK to basic.
• Implemented minor internal security fixes and improvements.

[2.6.11] - 2023-12-18

• Fixed javascript code execution vulnerability.
• Added URL validations for SDK WebViews.
• Improved Sign in with Klarna Redirects with a separate Activity.
• Updated SDK User-Agents.
• Improved Activity referencing for view operations.
• Improved SDK monitoring.

[2.6.10] - 2023-11-03

• Added system browser fallback support for Sign in with Klarna.
• Fixed On-site Messaging link click area.
• Changed default autoFinalize value to null for KlarnaPaymentView.

[2.6.9] - 2023-09-05

• Changed the launchMode attribute for KlarnaCustomTabActivity from singleTop to singleTask
• Minor internal improvements.

[2.6.8] - 2023-08-22

• Changed Sign in with Klarna button logo layout.
• Added support for loading indicator for Sign in with Klarna button.
• Improved performance by caching for Sign in with Klarna logins.
• Fixed text scaling issues for native buttons.
• Added support for skipping load calls in legacy tokenize flows.
• Added permission support for hybrid integrations.

[2.6.7] - 2023-08-09

• Card scanning results are wiped from memory after usage.
• KlarnaPaymentView is made visible also on authorize call.

[2.6.6] - 2023-07-27

• Fixed a proguard issue for fullscreen dialogs.

[2.6.5] - 2023-07-06

• Fixed proguard issues for public Sign in with Klarna classes.
• Fixed an issue with cancelling dialogs with the back button.

[2.6.4] - 2023-06-21

• Internal Browser now uses dialog fragments instead of an Activity.
• Fixed user cancel false-positives for Sign in with Klarna.
• Fixed proguard issues for internal Sign in with Klarna data classes.

[2.6.3] - 2023-05-26

• Fixed blank pages reporting error from background.
• Updated assets.
• Improved monitoring for application lifecycle.

[2.6.2] - 2023-05-09

• Added support for permission handling in Separate Fullscreen.
• Fixed redirect URI validation for Sign in With Klarna.
• Removed max width and height limits for KlarnaSignInButton.

[2.6.1] - 2023-04-21

• Fixed initial validation errors for KlarnaSignInButton.
• Internal optimization and improvements for Sign In With Klarna.

[2.6.0] - 2023-04-11

• Added Sign in with Klarna integration.

[2.5.2] - 2023-02-21

• Renamed internal assets of the SDK to fix conflicts with host applications.

[2.5.1] - 2023-01-30

• Fixed OkHttp header encoding issues.
• Optimized internal OkHttpClient usage.

[2.5.0] - 2023-01-19

• Added Klarna Express Button integration.

[2.4.3] - 2023-01-13

• Bug fixes and stability improvements.

[2.4.2] - 2022-12-19

• Use English locale in the SDK's internal string functions instead of device's/app's locale configuration.

[2.4.1] - 2022-11-29

• Updated SDK assets for Klarna Payments.

[2.4.0] - 2022-11-21

• Added support for Klarna Checkout in Standalone, Hybrid and WebView integrations.
• Added KlarnaCheckoutView extends KlarnaSingleComponent and KlarnaStandaloneComponent.

[2.3.2] - 2022-10-26

• Improved handling of files and links.
• Removed network security config file.
• Improved debugging capabilities during development.
• Minor internal improvements.

[2.3.1] - 2022-10-03

• Fixed fullscreen height issue with quick authorize calls for One Klarna payment flows.

[2.3.0] - 2022-09-23

• Added KlarnaComponent. General class that envelops any Klarna Component, regardless of integration.
• Added KlarnaMultiComponent. Components conforming to this interface protocol may render multiple products at once.
• Added KlarnaStandaloneComponent. For components that host and own their content.
• Added KlarnaSingleComponent. Components conforming to this protocol render a single Klarna product at a time.
• Added KlarnaEventHandler interface. Provides methods that will notify events happening to a product in a Klarna component.
• Added KlarnaStandaloneWebView class.
• Added KlarnaEnvironment enum class.
• Added KlarnaProduct enum class.
• Added KlarnaProductEvent data class.
• Added KlarnaOSMRegion enum class.
• Added KlarnaOSMTheme enum class.
• Added public constructor to KlarnaProductOptions data class.

Klarna Payments

• KlarnaPaymentView extends KlarnaSingleComponent and KlarnaStandaloneComponent.

Hybrid

• KlarnaHybridSDK extends KlarnaMultiComponent.

OSM

• KlarnaOSMView extends KlarnaStandaloneComponent and KlarnaSingleComponent.

Deprecations

• KlarnaOSMEnvironment is deprecated. Use KlarnaEnvironment instead.
• KlarnaOSMRegion is deprecated. Use KlarnaRegion instead.
• KlarnaOSMTheme is deprecated. Use KlarnaTheme instead.

Post Purchase

• KlarnaPostPurchaseSDK extends KlarnaSingleComponent and KlarnaComponent.

Deprecations

• KlarnaPostPurchaseEnvironment is deprecated. Use KlarnaEnvironment instead.
• KlarnaPostPurchaseRegion is deprecated. Use KlarnaRegion instead.

[2.2.1] - 2022-08-19

• KlarnaOSMView has been made an open class.

[2.2.0] - 2022-07-13

• Added Post Purchase standalone integration.

[2.1.8] - 2022-06-02

• Added checks for WebView availability on the device.
• Allow verbose logs in debug mode.

[2.1.7] - 2022-05-04

• Added support for opening Custom Tabs.

[2.1.6] - 2022-03-23

• Added support for "One Klarna" payment flow.
• Minor bug fixes and improvements.

[2.1.5] - 2022-02-11

• Updated application lifecycle implementation.
• Disabled some proguard optimizations.
• Changed proguard rules to apply obfuscation in consumer builds for some core parts.

[2.1.4] - 2022-02-10

• Updated consumer proguard rules to prevent detected obfuscation issues.

[2.1.3] - 2022-01-24

• Fixed an issue with opening external apps from internal browser.

[2.1.2] - 2022-01-18

• Fixed an issue caused by render process crash in WebViews.

[2.1.1] - 2021-12-03

• Fixed an issue while creating an instance of the SDK in background thread.

[2.1.0] - 2021-11-12

• Improved support for 3DSecure flows in new markets.
• Added "returnURL" to the KlarnaPaymentView constructor parameters. Read more.
• Deprecated KlarnaHybridSDKCallback and added separate callbacks for events and fullscreen transitions. Read more.
• Internal optimization and improvements.

[2.0.44] - 2021-07-23

• Change hardware requirements to be optional.

[2.0.43] - 2021-07-13

• Improve transition animation to/from full screen content.
• Added support to open Klarna App in Android API level 30.

[2.0.42] - 2021-06-28

• Improve internal parts using random integers and UUIDs.
• Fix string resources with special characters.

[2.0.41] - 2021-06-14

• Replaced the default SDK variant to include all features just like the full variant. SDK variant supporting limited features with a smaller size will be the basic variant starting with this version.

[2.0.40] - 2021-06-01

• Permissions & WebRTC support.
• Improved fullscreen implementation.

[2.0.39] - 2021-05-25

• Reduce singletons for less memory usage.
• Improve internal error handling.

[2.0.38] - 2021-05-12

• Support JS Bridge caching.
• Internal optimization and improvements.

[2.0.37] - 2021-04-23

• Support for alternative resource endpoints

[2.0.36] - 2021-04-15

• Fullscreen keyboard improvements.
• Updated analytic events.

[2.0.35] - 2021-03-22

• Revert WebRTC support and fullscreen improvements.

[2.0.34] - 2021-03-11

• ⚠️ This version has some functionality issues: Please use a newer version of the SDK. Future releases with new features will be cautiously checked to prevent these warnings.
• WebRTC support.
• Improved fullscreen implementation.

[2.0.33] - 2021-02-18

• Internal optimizations.
• Fix obfuscation errors.

[2.0.32] - 2021-01-13

• Internal optimizations.
• Updated SDK resources to prevent conflicts.
• Migrated dependencies to AndroidX.

[2.0.31] - 2020-12-08

• Internal optimizations and stability improvements.

[2.0.30] - 2020-12-03

• Overall stability improvements.

[2.0.29] - 2020-11-04

• Fixed an issue with Post Purchase in Hybrid integration.
• Overall stability improvements.

[2.0.28] - 2020-10-21

• Fix compile-time errors for some dependencies.

[2.0.27] - 2020-10-20

• Minor stability improvements and bug fixes.

[2.0.26] - 2020-10-19

• Overall stability improvements and bug fixes.

[2.0.25] - 2020-09-03

• Upgraded the target Android SDK version to 30
• Enabled the file access for web views on Android SDK version 30 and above

[2.0.24] - 2020-08-12

• Basic support for static On site marketing - beta version

[2.0.23] - 2020-07-29

• Added callback API for merchant events from Klarna components inside a WebView.

[2.0.22] - 2020-07-14

• Improved API for Java applications.
• Fixed an issue with base64 encoding.
• Improved thread safety for WebView implementations.

[2.0.21] - 2020-06-17

• Fixed an issue with internal browser URL parameter and navigation.

[2.0.20] - 2020-06-05

• Fixed an issue when the payment view was having blank white space.

[2.0.19] - 2020-05-27

• Full artifact with card scan.
• Default/basic artifact without card scan.

[2.0.18] - 2020-05-22

• Removed READ_PHONE_STATE permission usage and requirement.

[2.0.17] - 2020-05-14

• Fixed an issue with the Context instance being used to move or create separate web views.

[2.0.16] - 2020-04-09

• Fixed an issue with showing an error message inside the web view without hiding it.

[2.0.15] - 2020-03-20

• Fix issue with showing fullscreen, primarily affecting post purchase widgets.

[2.0.14] - 2020-02-21

• Overall performance and error handling improvements.

[2.0.13] - 2020-02-17

• Fixed a crash with JSONException in WrapperManager when initializing the SDK.

[2.0.12] - 2020-01-30

• Fixed a Proguard issue that would cause the payment view to not load.

[2.0.11] - 2020-01-28

• Internal optimizations.

[2.0.10] - 2020-01-14

• Enabled cookies for internal web views.

[2.0.9] - 2019-12-19

• Renamed internal assets to avoid merchant app conflicts.

[2.0.8] - 2019-12-05

• Improvements of internal web view identification towards Klarna components.

[2.0.7] - 2019-11-27

• Fix rare crash with NullPointerException when invalid message is sent to the SDK.

[2.0.6] - 2019-11-20

• Fix rare crash on certain Android devices with JSONException in ConfigManager when initializing the SDK.
• Improved link handling in fullscreen web views.