Known Constraints

1a. Currently, Klarna Payments accepts orders ONLY for customers with billing addresses in the markets that match the currency of the order, per Klarna Payments docs. Customers for non-supported regions based on the order's currency are shown an error message on page load that the Klarna order cannot be placed.

1b. Shopify limits Klarna Payments as an alternative payment method, the same for all alternative payments methods, to always transact only in the store’s single base currency, per: Shopify multi-currency docs. Even if the store displays prices in multiple currencies, including in checkout or using Shopify Markets, Shopify will update the order's currency to the store's single base currency when redirecting to the alternative payment provider. (For merchants to support multiple currencies with Klarna, multiple Shopify stores could be used or an alternate checkout, such as Global-e.)

As such, if the store base currency is SEK, Klarna Payments will be able to accept orders for customers whose billing country is Sweden.  Customers with addresses in other countries will receive an error message, e.g. as shown in the screenshot below.  The exact error message may be dependent upon region & Klarna product, i.e. such as "We can't offer you this payment method right now" or “Option not available”. For stores with base currency of EUR, Klarna can accept orders for multiple regions which transact in EUR. For other countries, a single region is supported for each currency.

When a customer places an order with an alternative payment integration, such as Klarna Payments, Shopify redirects to the payment method but does not lock the order's product inventory and thus stock inventory cannot be guaranteed.  With the upcoming new payments integration, payments apps can no longer query the Shopify store's stock inventory via API to prevent oversells. Shopify will update this functionality in the future.

Even if customers already previously entered their phone number in Shopify checkout, Shopify may not share that phone number with payments integrations when email is required in checkout, thus Klarna may request the consumer enter their phone number again.

While some Shopify custom script code does work for payment methods integrated via Shopify's new payments app integrations, renaming the payment method is not currently supported by Shopify, as payment providers can now configure translations for the payment method name. With this new Klarna payment integration for Shopify, translations are not needed since the name "Klarna" works for any language.

• Confirm that you have the Integration Guides app enabled for your account. If not, to have this enabled, see #9 below. You can confirm if Integration Guides is enabled by checking the left navigation for "Integration Guides" in the Klarna Merchant Portal. If the left side navigation menu isn't showing in your browser, click the menu navigation (black circle with 3 white lines inside the circle) at the top left of the screen to open it.
• Try using a new incognito browser window (to avoid cookies & caching).
• Did you previously complete the integration through Integration Guides step #4 (Test), and then uninstall the "Klarna" app? If so, you'll need to wait 48 hours or request Klarna to do a database update (via skosm@klarna.com) to be able to redo the integration.
• If you have multiple Klarna merchant accounts (i.e. a different merchant ID for each of multiple Shopify stores), ensure the correct Klarna merchant ID is selected in the Klarna merchant portal for the appropriate associated Shopify store.
• If you get the error stating "You already have a store that is integrated with Klarna...", please open a support case with the provided correlation_id at skosm@klarna.com Note: for migrating HPSDK merchants, the Shopify deadline for merchants to complete the migration is 2022-July-31, per: https://shopify.dev/apps/payments/hosted-payment-sdk

This error can happen for multiple reasons, but the most common reason (for new integrations) is that the Integration Guides steps within the Klarna Merchant Portal have not been completed fully. Activating the payment method (and subsequent required Klarna unlisted payments app) in your Shopify store admin are only 2 of the 3 required steps for the Klarna payment method to work successfully in checkout. Active Klarna API credentials are required. You can sign up for a new account to receive API credentials at http://klarna.com/business). Once Klarna API credentials are received, within Klarna's Merchant Portal, complete the Shopify "Integration Guides" steps.

Currently payment method footer injection is not supported via Shopify's new payments platform. This is something that Shopify may support in the future. As a workaround, instead of using liquid code shop.enabled_payment_types, you may update your store's footer theme code directly, e.g. example code below, but you'll need to test what works for your store's specific theme, another solution posted at: https://community.shopify.com/c/shopify-design/klarna-logo-doesn-t-show-in-footer/m-p/1589308

{% assign enabled_payment_types = 'paymenttype1,paymenttype2,klarna' | remove: ' ' | split: ',' %}

Customers no longer need to start a new session to pay with Klarna. If the Klarna payment page was previously loaded, the page should load successfully upon retry.

Contact skosm@klarna.com and our merchant support team can enable the Integration Guides app for your account.

We'll improve this in the future Until then, to be able to successfully integrate, uninstall the "Klarna" app from within the "Klarna" payment method (under Settings -> Payments). (Do no uninstall the "Klarna Payments" HPSDK app from the store's Apps menu, as that HPSDK app does not impact the new payments app integration, but is used for order management for previously placed HPSDK Klarna orders.) New payments apps, like the "Klarna" app, are not displayed within the store's Apps menu; they are only available for uninstall from within the payment method's configuration when the payment method is not active. If the payment method is not active in your store currently, you'll have to search for the Klarna payment method and click "Activate" to get to the payment method's configuration options to be able to see if the app is available to uninstall.

Once the Klarna app has been uninstalled, you can then retry the steps in the Integration Guides app in the Klarna Merchant Portal.

Note: for stores that have previously completed the integration guides steps (past step #4 Test), if you uninstall the "Klarna" app, you will have to wait 48 hours or request Klarna to do a database update (via skosm@klarna.com) to be able to redo the integration.

If you see the warning message below in your payment method in your Shopify store, it indicates that your Klarna API credentials are not active for your store's integration. Your Klarna API credentials may still be active with Klarna and ready for use, but the integration is not yet completed. (Klarna can't currently set the text of the error message shown in the Shopify payment method to be more clear unfortunately.) To resolve this, click the "Manage" link within the payment method and complete the steps in the Integration Guides in the Klarna Merchant Portal, particularly step #4 (Test), which sets the ready flag for the payment method's app in your Shopify store.

If customers update a related, but different Shopify session separately from the Shopify session used to place the Klarna order, the order totals between the Shopify and Klarna orders may not match, but the amount "Paid by customer" for the Shopify order should always match the Klarna order total. While not ideal, this is working as expected and designed. Care should be taken to only fulfill order line items paid for by the customer.

If additional support is needed, email skosm@klarna.com (and please include your Shopify store name) for specific Klarna support. General Klarna support available at: http://klarna.com/merchant-support

https://community.shopify.com is a good place for Shopify questions, support, and feedback, in addition to https://help.shopify.com/