Enable Klarna payment messaging on your online store with Klarna's Mobile SDK and boost transparency and conversion. This includes our pre-qualification feature, which allows customers to check their eligibility for Klarna financing before completing a payment request. This reduces friction and increases confidence, as customers know their options upfront.
![]() | ![]() | ![]() |
| Messaging on the homepage | Messaging on the product detail page | Messaging in the checkout |
Link copied!
Before you integrate On-site messaging, please check that you meet the following conditions:
Link copied!
Adding On-Site Messaging to your native app is a straightforward process. At a high level, to achieve this tailored experience for your users, you will need to follow these steps:
Link copied!
In Xcode, navigate to File → Swift Packages → Add Package Dependency and enter the repository URL: https://github.com/klarna/klarna-mobile-sdk-ios
In Version, Select Up to Next Major and take the default option. Then choose KlarnaNetworkMessaging in the Package Product column.
If you’re using Cocoapods, you can add the SDK by adding the dependency to your Podfile:
Copied
pod "KlarnaNetworkMessaging"
Followed by performing:
Copied
pod install
You should then be able to import the KlarnaNetworkMessaging module in your workspace.
To read more about Mobile SDK versioning policy, check out this section.
Link copied!
The first step to add On-Site Messaging to your application is to initialize the Klarna SDK and provide the required configuration:
Copied
// Create an instance of KlarnaConfiguration
let configuration = KlarnaConfiguration(
clientId: clientId,
accountId: accountId,
locale: locale,
sdkToken: sdkToken
)
// Initialize Klarna
let klarnaResult = Klarna.initialize(configuration: configuration)
do {
self?.klarnaInstance = try klarnaResult.get()
// Initialization successfulLink copied!
| Param | Type | Description |
|---|---|---|
| clientId | String | The client ID of the partner account that is integrating the Mobile SDK. If the integration is done by a PSP/DP then this must be set to the distribution partners own client ID. |
| accountId | String | (Optional) When transacting on-behalf of another account then the partner account ID is specified using the accountId property. |
| locale | String | (Optional) Set the default locale(ISO 3166-1 alpha-2) for the SDK. System default locale will be used if not set. |
| sdkToken | String | (Optional) The SDK Token allows the SDK to be initialized with an existing session. Token is only retrievable from the server side via Shopping Session API. |
Link copied!
The On-Site Messaging native view on iOS is the KlarnaMessagingPlacementView. You can create this view programmatically and add it to your view controller or custom views.
Copied
// Create an instance of KlarnaMessagingPlacementConfiguration
// Depending on your requirements, you can create `CreditPromotionBadge` or
// `CreditPromotionAutoSize` configuration
let placementConfiguration = KlarnaMessagingPlacementConfiguration.creditPromotionBadge(
theme: .automatic,
amount: 10000,
currency: "USD"
)
// Create an instance of the view
let placementView = KlarnaMessagingPlacementView(
klarna: klarnaInstance,
configuration: placementConfigurationLink copied!
| Param | Type | Description - themeKlarnaTheme(Optional) Enumerated theme value to specify how to stylize the view on light, dark or automatic (system) configurations. Default value is light |
|---|---|---|
| amount | Int | Amount for the placement. Set in micro units ($120.00 = 12000), used for amount based credit promotions. |
| currency | String | 3-letter ISO 4217 currency code |
| Param | Type | Description - themeKlarnaTheme(Optional) Enumerated theme value to specify how to stylize the view on light, dark or automatic (system) configurations. |
|---|---|---|
| amount | Int | Amount for the placement. Set in micro units ($120.00 = 12000), used for amount based credit promotions. |
| currency | String | 3-letter ISO 4217 currency code |
| Name | Descriptions |
|---|---|
| light | Light style for placement view. |
| dark | Dark style for placement view. |
| automatic | Automatic theme that will use the system’s user interface style. |