Klarna Docs - How to install Klarna payments in your Shopify store

How to install Klarna payments in your Shopify store

This article provides a step-by-step guide on installing Klarna payments in your Shopify store.

In order to go live with Klarna payments on Shopify, you need to log in into the Klarna Merchant portal. If you don’t yet have a Klarna merchant account, you can sign up at http://klarna.com/business.

We recommend that you first log into both your Shopify admin as the full account owner and the Klarna Merchant portal. 

Make sure to select the correct store to be associated with the desired Klarna merchant ID. Once the store is associated in Klarna's database, you’ll have to wait 48 hours for the association to be removed after uninstalling the Klarna app, or after a manual update by Klarna.

Once a store is associated with a merchant ID, that merchant ID will be blocked from use for another store. Each Shopify store must have its own unique Klarna merchant ID. Merchant IDs can’t be shared across stores.

Once the below steps are started, we recommend that you complete at the minimum steps 1 through 4 to avoid a partial entry in Klarna's database, which results in an incomplete integration.

Step 5 (activate, or deactivate the payment method) can be done multiple times, whenever desired, without breaking the integration.

If you‘re not contracted directly with Klarna, for example, contracted instead via Shopify Payments, Mollie, and so on, follow your integrator's steps for activating Klarna, not the steps in this guide.

Step 1

Click the Integration guides link in the Klarna Merchant portal and click the Shopify option. If you don't have the Integration guides option displayed for your account when logged into Klarna Merchant portal, contact Merchant support and we can enable this option if you’re contracted directly with Klarna.

Screenshot of Step 1, Start, in the Klarna Merchant portal Integration Guides.

Step 1: Start the installation by choosing Shopify in the Klarna Merchant portal Integration guides.

Step 2

Install the app. Since only the full store account owner can install Shopify payments apps and activate payment methods in their store, make sure you're logged into your Shopify store as the store account owner. Click the Install Klarna Shopify Application button.

Note: while this app is a public app, it isn't listed in the Shopify app store, and won’t be displayed in your store's Apps menu like other apps, which is expected for Shopify new payments apps.

Screenshot of Step 2, Install app, in the Klarna Merchant portal Integration Guides.

Step 2: Install the Shopify Klarna app in the Shopify store admin.

Step 3

Generate and connect new Klarna API credentials. As directed, for security purposes, download these API credentials to your local computer, even though you won't enter these credentials anywhere for this new payments integration flow, as that is done automatically for you. You can't continue past this step until you click Generate and connect credentials and save the newly generated API credentials.

Screenshot of Step 3, Connect, in the Klarna Merchant portal Integration Guides.

Step 3: Connect your Klarna and Shopify accounts by generating API credentials in Settings.

Step 4

In this step, the integration is verified.

Screenshot of Step 4, Test, in the Klarna Merchant portal Integration Guides.

Step 4: Click Verify integration to check that your Klarna Shopify integration is set up correctly.

Step 5

Activate the new, single alternative payment method, named Klarna, in your Shopify admin (which is only available if you’re the full account owner of the store).

  • There may be other payment methods supporting Klarna available to activate, for example, such as Paymentwall or pay.nl, but those other payment methods require different credentials and different corresponding payments apps to work successfully. 
  • Activating a payment option other than the one named only Klarna will result in an error upon redirect from Shopify checkout without appropriate credentials. When the appropriate Klarna payment method is activated, Klarna will display as a payment method in your Shopify checkout.
Screenshot of Step 5, Activate, in the Klarna Merchant portal Integration Guides.

Step 5: To activate the Klarna payment method in your checkout, you’ll be redirected to your Shopify store admin.

Activating the payment method in your store enables Klarna to display in checkout. Make sure to verify that Klarna loads successfully though as this step does no validation if the integration was completed successfully.

Activating Klarna in your Shopify store.

Step 6

Verify the integration by adding a product to your cart. Note that Klarna won’t appear on the cart page.

◦ Go through all the pages of your Shopify checkout, select the new Klarna payment method in your store's checkout payment page, and after clicking the Pay Now or Complete button (or after the Review Order page, if enabled for your store), make sure the Klarna payment flow starts. Placing a test order isn't necessary. Be aware that fees could apply if the payment method isn't in Test mode.

Step 7

Ensure that your Customer contact method is set to only Email, as described in this article on Klarna.Docs.

Screenshot of the Customer contact method menu in the Shopify admin, with Email selected.

Email should be set as required in Shopify checkout

Step 8

We recommend that both email and phone number are configured in your Shopify admin as required in your store's checkout. When the Customer contact method (configured in Settings > Checkout > Customer contact method) is set to email only, you can configure the phone number field to be a required field further down in the checkout (configured in Settings > Checkout > Customer information > Shipping address phone number).

Screenshot of the Contact information section in Shopify Checkout.

Configure the phone number field to be a required field in the Customer information section.

Klarna is now live in your Shopify store!

Check out the video to see the new installation in action.

In summary:

  • To install Klarna payments in your Shopify store, you need to log into the Klarna Merchant portal with your Klarna Merchant account.
  • To complete the installation, you need to log into Shopify admin with store owner access.
  • You have to select the correct store to be associated with the desired Klarna merchant ID.
  • If you‘re not contracted directly with Klarna, follow your integrator's steps for activating Klarna.