On-site Messaging integration prerequisites
Add personalized messaging throughout the customer journey for higher conversion rates and increased spend.
Overview
On-site messaging enables Partners to display tailored Klarna payment messaging on their online store, mobile app, or both. On-site messaging informs customers about available Klarna payment options, such as flexible payment methods, before they reach checkout. Messaging can be placed throughout the Klarna Purchase Journey, including product, cart, and landing pages, to increase transparency and conversion.
Before starting the integration
Partners must already have a Klarna payment solution in place before integrating any Boost feature.
1. Access the Klarna Partner Portal
Verify access to the Klarna Partner Portal.
2. Create the client identifier
When integrating Boost features using the Web SDK, a
client identifier is required. To generate one:- 1.Go to Settings → Client Identifiers.
- 2.If multiple MIDs are managed under the same user, select the correct MID from the “Store” dropdown at the top.
- 3.Click Generate. A new screen appears displaying the client identifier; copy it now.
- 4.To retrieve the identifier later, return to Settings → Client Identifiers, select the correct MID, and click the “copy” icon in the identifiers table.
3. Allowlist the domain
Each origin domain where the Web SDK will be deployed must be registered before the client identifier can be used:
- 1.Go to Settings → Client Identifiers.
- 2.If multiple MIDs exist, select the correct one from the “Store” dropdown.
- 3.Click the Allowed origins tab.
- 4.Add the URL(s). At least one origin must be registered to activate the client identifier.
Alternatively, allowed origins can also be added directly within each Boost feature section.
4. Generate API key
Ensure API keys are available for the integration:
- 1.Go to Settings → Klarna API keys.
- 2.If multiple MIDs exist, select the correct one from the “Store” dropdown.
- 3.Click + Generate new Klarna API key. A new screen appears displaying the API keys; copy them now. They can only be accessed once, so downloading them is essential.
5. Add Web SDK Terms and Conditions
When integrating the Klarna Web SDK on a website, for example to enable Klarna's conversion boosters or other similar features, Partners are responsible for informing users about the tracking technologies employed. This information must be provided prior to any tracking taking place, for instance via a cookie banner or similar mechanism.
Partners must disclose both strictly necessary tracking technologies and any specific technologies used by the Klarna Web SDK, including details such as name, purpose, provider, use of local storage, and retention period.
The wording below can be used as is, or adapted to align with the Partner's existing cookie banner or privacy policy, provided the information remains complete, accurate, and compliant with applicable laws:
Strictly necessary cookies are necessary for the website to function and cannot be switched off in our systems. They are usually only set in response to actions made by the user which amount to a request for services, such as setting privacy preferences, logging in or filling in forms. For the purpose of ensuring service security and prevention of fraud, we do also collect device fingerprints, including, but not limited to, browser name, IP address, time zone and language preference and service availability.
| Name | Purpose | Supplier (First/Third) | Session/Persistent/Local | Expiry |
|---|---|---|---|---|
| __klarna_sdk_klarna-shopping-session | This cookie is used to ensure service security, service availability, and to prevent fraud. | Third party | Local storage | 48h |
| __klarna_sdk_config | This cookie is used to:
| Third party | Session | Until you close your browser |