This article details the order operations you can manage in the Klarna payments app integration for Shopify.
The Klarna payments app integration for Shopify comes with an integrated order management feature.
We recommend that you manage the Klarna orders as part of the standard order management within your Shopify admin.
While order management can be done directly via the Klarna Merchant portal, this will cause Klarna data and Shopify order data to be out of sync and could result in unintended updates, for example, duplicated refunds. Unless there is a problem, you should manage all orders through the Shopify admin and not the Klarna Merchant portal.
The payment status of captured orders depends on the Payment capture method configuration setting in the Shopify admin under Settings > Payments. You can set the payment capture method to automatic or manual. This Payment capture setting applies to all orders in a Shopify store.
Usage of automatic capture is restricted to specific business rules and categories. Please refer to our guidelines before enabling this functionality.
Shopify currently adds the Expiring badge to Shopify orders at a default time period of 7 days, which doesn't match the Klarna order expiration date, as set by Klarna in the authorizationExpiresAt field when resolving the payment on Shopify. Even when a Shopify order has an Expiring badge, Klarna payment can still be captured from the Shopify order, as long as the Klarna order hasn't expired or already been captured. By default, Klarna orders expire after 28 days.
While Klarna orders can be captured directly in the Klarna Merchant portal, we recommend keeping Shopify and Klarna order data in sync whenever possible.
The capture of Klarna orders is not based upon the Shopify order being fulfilled and shipped, as was previously. If you'd like to have the Klarna order based on Shopify order fulfillment, you may be able to build that specific to your store using the Shopify Flow app. If you use Shopify Flow to capture the orders, please note the recommended time delay settings.
Based on your Klarna contract, Klarna charges merchant fees for captured orders. When Shopify orders are automatically captured, that is, immediately after the order is placed, Klarna fees will apply for each order, even if the order is canceled in the Shopify admin without being fulfilled.
If you’re using the Shopify Flow app to trigger the capture of a Shopify order when the Payment capture method is set to Manually, we recommend that you include a time delay of around 30 minutes after the check, if the payment method is Klarna step to avoid the Payment gateway being set to null in some Shopify webhooks, for example for webhooks used by Signifyd and similar apps.
Partial capture (multi-capture) is supported for Klarna orders for Shopify Plus merchants. There is a UI bug in Shopify that currently occurs if trying to complete another capture while the first capture is pending. During this time it may appear to be possible to capture a much larger amount than the original order amount, however this is incorrect and will lead to an error if attempted.
Refunds made in Shopify will update the Klarna order after a short time delay of less than 10 minutes. This applies for all types of Shopify refunds: before or after Shopify order fulfillment, full or partial refunds, order line based refunds, and amount-based refunds.
The Klarna refund doesn’t include order line data as refund order line data is not shared by Shopify.
You can remove and add items to a Klarna order that has been placed. Editing order lines is possible for both automatically and manually captured Klarna orders.
For more information about editing orders see the article about Editing order items in Shopify documentation.
For orders that aren’t automatically captured based on your store's Payment capture method setting, we recommend that you manually capture the order prior to the Klarna order expiration date. The expiration time frame depends on your Klarna contract. By default, orders expire after 28 days.
The Klarna order's authorization time can’t be extended within the Shopify admin. You can extend the authorization time for Klarna orders in the Klarna Merchant portal, if applicable for the order.