Skip to main content

Overview​

On Site Message (OSM) is a free Klarna tool that lets customers know Klarna is available as a payment option on your website. It’s available to all retailers using Klarna Payments or Klarna Checkout.

Installation​

  1. Confirm that your Shopify store uses a version 2.0 theme. If it doesn’t, follow Shopify’s instructions to upgrade to a version 2.0 theme: Upgrade themes.
  2. Make sure you have applied for a Klarna payment channel through Oceanpayment.
  3. Contact Oceanpayment Technical Support to obtain the MID and clientid for your store.
MID and ClientID
  1. Each domain has a corresponding MID and Client ID for North America and Europe. North American MIDs begin with N, while European MIDs begin with K.
  2. MID stands for Merchant ID. It is a unique identifier assigned to each merchant using Klarna and consists of a letter followed by a series of numbers.
  3. Examples of MIDs and Client IDs:
  • North America: MID: N3210944; ClientID: 8a2b11ac-7f55-645e-8fcd-3154f28ebca8
  • Europe: MID: K8685421; ClientID: 71305f12-e8e5-5caa-812e-bfcddfad6f9i

Installation Steps​

  1. Find and install On-Site Messaging (OSM) from the Shopify App Store: https://apps.shopify.com/klarna-on-site-messaging

Account Configuration​

  1. Open On-Site Messaging in the Apps section of your Shopify admin, then go to Account Setup > Klarna Account.
  2. Under Select endpoint, choose the appropriate region (Europe, NA, or Oceania), then enter the corresponding MID in the field below. Click Connect Account when finished.

Theme Settings​

  1. If your store uses a version 2.0 theme, click App Block Instructions to configure the app.
  2. If an Unable to Detect App Blocks message appears after you click Verify and Continue, click Continue without Verifying to complete the setup.

Add Klarna OSM to a product page​

  1. In your Shopify admin, go to Online Store > Themes > Customize to edit your theme.
  1. In the settings panel on the right, select the desired Placement type and Locale Setting, then click Save.

Frequently Asked Questions​

  1. Klarna OSM does not appear on the storefront after setup..
  • Check that the domain and region (North America or Europe) associated with the MID are correct.
  • Klarna OSM detects the user’s IP address. Make sure the IP address is within the corresponding supported region.
  • Some themes may have compatibility issues between the product page’s Product Block and Klarna OSM. In the theme editor, add a separate App Block to the product details page, then add the Klarna app to that block. Klarna OSM should then display correctly.
  1. Can I customize the details displayed by Klarna OSM?
  • No. The details page content cannot be customized.
  1. The details page is blank after clicking “Learn more” in Klarna OSM.
  • Check whether you are using a page-blocking tool. If so, contact the third-party provider and ask them to stop blocking Klarna content. Third-party tools such as Consent Manager may prevent the Klarna OSM details page from displaying correctly.