Technical and integration

Pre-qualification is enabled automatically when On-site messaging is advertising Financing. You won’t have to do anything to activate this. Currently we do not support pre-qualification for any other products.

If you have any issues with rendering placements from On-site messaging, please check the following:

• Are you using the right endpoints? Make sure not to use playground on production, it can happen by mistake! Here you find some help.
• Are you using the correct locale? The locale defines for which country and in which language the advertisement will be shown.
• A typical issue can be that the purchase amount is not correct. Make sure you are sending the correct purchase amount (in micro units format)! Here you find some help.
• Make sure that in the placement ”inline” is not set to true as that can cause issues if your setup is not enabled for inline placements.
• Make sure not to hide the placements using CSS, it can happen by mistake!
• Check that your <klarna-placement> and script tags are valid html. Make sure you are only loading one instance of our javascript library.
• If all the above is working, check the network requests to klarnaservices.com. Look for errors and 204s, you can detect small mistakes easily.

Shopify Merchants: We suggest Shopify merchants utilize our Shopify Klarna On-Site Messaging app. It’s good to know that this feature can not be used at the same time as our manual OSM, and they will overwrite each other. Use only one form of Klarna On-site Messaging to avoid this.

All the placements of On-site messaging are dynamic meaning that the content is based on your available payment methods. We automatically update every placement with the correct payment methods. So for the landing page (About Klarna page), we only show those payment methods which are actively used by you. If you see any problems with the shown information, please double check you are using the correct environment (playground vs. production).

We recommend using our assets which have auto size as those can be adjusted easily to your website. You can find the information about the size in Merchant Portal under “Placements” for every placement.

Shopify merchants: Shopify On-site messaging app does not support mini-cart or pop-cart pages.

Other Ecommerce merchants: You can place On-site messaging on mini-cart or pop-cart pages. Just go to the Merchant Portal, pick the placement you want to show and add the html tag to your site. We recommend using placements with autoXauto size as those fit this purpose well. In the Merchant Portal you can customize the styling of the placement, e.g. changing font size.

We can recognize our Klarna users and great them in our On-site messaging placements. We call this “personalization”. Personalized ads are similar to normal ads, but they start with greeting the user such as ”Hey Anna”. The user can click on their first name and opt-out from this experience if they want to. Based on our data and research, users like this experience and rarely opt-out from it. This feature creates trust with the help of the Klarna brand.

The content is dynamically populated by Klarna. We take into consideration several parameters such as the payment options you are offering your users in Klarna Payments or in the Klarna Checkout – so in that sense you control the offer. Due to our dynamic algorithm we are able to choose the best performing content for your customers. You cannot change the content / copy of our advertisements.

A fulfillment action for Shopify order XXX/ Klarna order id XXX for store NXXXXX has resulted in an error. To determine the cause of the error, please review the order in your Shopify admin tool and in the Klarna Merchant portal.

If you’ve received this email then an order fulfillment has failed. This can be due to an order being expired or already captured in the Merchant portal. Contact Merchant support if further assistance is needed.

Some first steps to go through if your integration does not work:

• Make sure that test mode is switched off.
• Make sure that the Klarna API credentials are entered in the correct place in your plugin.
• Make sure you have the correct version of Klarna’s plugin installed.

If you can not see Klarna’s iframe it might be due to:

• Klarna’s plugin is not activated.
• The page with terms and conditions is not linked.
• Another plugin is disrupting Klarna’s plugin.
• The design of your webshop, meaning your theme, is not compatible with Klarna’s plugin.

Check the following:

– If you use Klarna API credentials for production, make sure that the test mode is switched off.
– If you use Klarna API credentials for our test environment, make sure that the test mode is switched on.
– If the problem is still there please contact our Merchant support for further assistance.

Make sure that the shipping method is entered correctly. If you use Magento, it might also be because Magento requires details in the checkout that Klarna does not collect, such as state and province.

To test your checkout you will need test Klarna API credentials. These can be found by signing up here with the same login details you use for the Merchant portal. It’s important to note that regular Klarna API credentials will not work with test mode in your Ecommerce. You can find more information about our Playground enviornment here

To be able to start integrating with Klarna you need to have a functional website. This means that you need to have information on your products and it need to be possible to add products to a shopping cart.

Your username and password are your Klarna API credentials. If you do not have your Klarna API credentials, you can generate these by going to the Settings app in the Merchant portal.

Automatically onboarded merchants can use the Merchant portal Products app to complete integration. If further assistance is needed our Developers page contains more information. For Merchants onboarded with the help of a sales representative, our team will reach out to assist with integration.

Go to the Settings app in the Merchant portal. There you can generate new Klarna API credentials by clicking on “Generate new API-credentials”. Remember to save the new Klarna API credentials since you will only be able to see them once.

Klarna offers a simple tool to insert dynamic payment plans directly on your web store. Follow the instructions at https://developers.klarna.com/documentation/on-site-messaging/integration/ to get started with the On-site Marketing Platform.

By adding the Klarna badge(s) to your website, your shoppers will know they have trusted payment options at time of checkout. Head to https://guidelines.klarna.com/co-marketing#/merchants to retrieve the payment badges for your site.

We have assembled a toolkit complete with logos, icons, text, and other inspiration to be used on your website. Read more about promoting Klarna payment options to your shoppers at https://guidelines.klarna.com/co-marketing-us.