Setting Up Klarna

To offer your customers the benefit of paying with Klarna, you must first sign up for a Klarna account and gain access to the Klarna Merchant Portal. Then, complete the Klarna configuration from the Admin of your Magento store.

Important: Klarna does not support currency switches to display multiple currencies in one website. Magento uses a base currency and tax configured at the website level (not store view) to avoid rounding and mismatch issues. To support multiple currencies, create a website per currency, using different URLs configured at the Magento website level (not store view).

Klarna Merchant Portal Klarna Merchant Portal

Step 1: Set Up Your Klarna Account

  1. Do the following from the Admin of your Magento installation:

    • In the Admin sidebar, choose Stores. Then under Settings, choose Configuration.

    • In the panel on the left under Sales, choose Payment Methods.

    • In the Klarna section, tap Configure. Then under Klarna Payments, click the link to visit the Klarna Merchant Onboarding page.

  2. Do one of the following:

    • To create a new account, complete the Onboarding form to create a Klarna merchant account. Then, tap Create account.

    • If you already have an account, click Log in here.

      Create a Klarna Merchant Account Create a Klarna Merchant Account

  3. To generate your API Credentials for Klarna’s Playground environment, do one of the following:

    • Tap the Settings icon.

    • In the main menu, choose Settings.

    Then, do the following:

    • On the API Credentials tab, tap Generate new API credentials.

    • Copy your credentials to a text editor like Notepad. You will need them later to complete the Magento configuration.

      Generate API Credentials Generate API Credentials

  4. If necessary, sign in to your Klarna account. Then on the Store Settings tab, do the following:

    • Take note of your Store ID in the upper-left corner of the page. Copy and paste the value into a text editor like Notepad, along with your API credentials.

    • Complete the following store information:

      • Store name
      • Homepage URL
      • Customer Support Email
      • Customer Support Phone

      Store Settings Store Settings

    • In the upper-right corner, click the Menu icon ( ). Then, choose Branding.

      If your logo and icon files are ready, follow the onscreen instructions to upload them to the Klarna portal. If the files aren’t ready, you can complete this step later.

      Feature Instructions
      Icon Your icon appears in the Klarna app.
      Recommended size: 180 x 180 pixels
      Aspect ratio 1:1
      Supported File types: PNG or JPG (JPEG)
      Logo Your logo appears in communications and statements sent to customers. For best results save your logo as a PNG file with a transparent background.
      Supported File types: PNG or JPG (JPEG)
      Feature Image Your feature image appears in the Klarna app. Recommended size: At least 1340 x 1000 pixels.Aspect ratio: 1.34:1
      Supported File types: PNG or JPG (JPEG)

      Branding Branding

Step 2: Configure Magento

  1. Open another browser tab, and log in to the Admin of your Magento store.

  2. On the Admin sidebar, choose Stores. Then under Settings, choose Configuration.

  3. In the upper-left corner, choose the Store View where the configuration applies. If your installation has only one view, accept the “Default Config” setting.

  4. In the panel on the left, under Sales, choose Payment Methods. Under Other Payment Methods, expand the Klarna section. Then, tap Configure.

    Klarna Klarna

  5. Expand the Klarna API section. Then, do the following:

    • Set API Version to one of the following:

      • Klarna Payments (Europe)
        Supported countries: AT, DE, DK, FI, NL, NO, SE, UK
      • Klarna Payments (North America)
    • In the Merchant ID/EID field, enter the Store ID from your Klarna account.

    • Enter the Password/Shared secret from your Klarna account.

    • To use the Klarna Playground for test transactions, set Test Mode to “Yes.”

    • To generate a record of interactions while testing the integration, set Debug Mode to “Yes.”

      Turn Debug Mode off before going live with Klarna in your production store.

      Klarna API Klarna API

  6. Expand the Klarna Payments section. then, do the following:

    • Set Enable this Solution to “Yes.”

    • Set Payment from applicable countries to one of the following:

      All Allowed Countries Customers from all countries specified in your store configuration can use this payment method.
      Specific Countries After choosing this option, the Payment from Specific Countries list appears. Hold down the Ctrl key and select each country in the list where customers can make purchases from your store.
    • (U.S. Only) If you want Klarna to prepare set of personalized credit options for each customer, set Data sharing to “Yes.”

    • Enter a Sort Order number to determine the position of Klarna in the list of payment methods during checkout. (0 = first, 1 = second, 2 = third, and so on.)

      Klarna Payments Klarna Payments

  7. If you want to stop here, tap Save Config.

  8. When prompted, click the Cache Management link at the top of the page.  Then, refresh all invalid caches.

Step 3: Complete the Design Settings (Optional)

You can complete the Klarna Payment Design Settings now, or at a later time. You might use a color picker to experiment with different colors for each element to match your store’s theme. The results might vary, depending on theme.

Enter the hexadecimal value of the color that you want to use for each element.

  • Details color
  • Button color
  • Button text color
  • Checkbox color
  • Checkbox check mark color
  • Header color
  • Link color
  • Border color
  • Selected border color
  • Text color
  • Secondary text color
  • Border radius

Klarna Payments Design Klarna Payments Design

When complete, tap Save Config. Then when prompted, click the Cache Management link at the top of the page to refresh all invalid caches.