Klarna Docs - Enable the smoooth purchase flow in KP

Enable the smoooth purchase flow in KP

In order to get the improved purchase flow to work in an optimal way, there are a few things to consider: 

With the new purchase flow we will also introduce additional payment methods to your checkout, in order to accommodate a predictable and consistent User Experience, regardless of where the consumer shops. 

Only if you are validating payment methods and comparing such to what you would expect prior to creating Klarna orders in your backend systems please make sure this will be fixed. You’ll find the payment methods that need to be supported below.

If you’re showing Klarna as a payment option in your check-out using Klarna Payments, see the payment methods that need to be supported here.

If you are using Klarna in your mobile app, we need you to be on the Klarna SDK versions that are compatible with the new UX!

Please make sure you are on the latest SDK versions available, but not lower than the following ones:

  • Android: 2.1.6
  • iOS: 2.1.5

In order to optimize the purchase experience, we recommend you to retain only one single widget in your check-out. This means Klarna will be shown as one payment method at your check-out in which the new purchase flow is visualized, and the consumer can choose how to pay and be remembered for future purchases. 

If a B2C or B2B session has already commenced and the customer type changes, it is necessary to initiate a new session. The reason for this is that Klarna does not handle B2B purchases directly; they are facilitated by a third-party vendor. As a result, the B2B Purchase flow operates independently from Klarna's B2C shopping experience. Therefore, it is crucial to create a session tailored to the appropriate customer type. Modifying an existing session to accommodate a new customer type will not be effective.

For additional information on supported customer types and instructions on how to configure them, please read more here.

If your checkout process involves multiple steps and allows order changes on the final order review page before submission, here are the steps you need to follow:

  • To maintain your current logic, ensure that any order update functionality for B2B transactions is disabled on the final order review page, or at least add a disclaimer to make your customers aware.

Note: If you're utilizing a platform or plugin for Klarna integration without direct control, be reassured that we have already contacted our partners to make the necessary adjustments. 

  • Otherwise, nothing is required from your end and we will update the UX automatically into your current solution in the smooothest way possible. If you have any questions about these requirements, reach out to your account manager or to merchant support. 

If you offer recurring payments, there are additional requirements you might need to consider to ensure consumers receive the optimal sign-up experience:

Create session

With the new purchase flow, we are tailoring the user experience leveraging the intent you specify when you create a session to accommodate the correct payment method offering and a predictable and consistent User Experience - regardless of if the customer makes a one off purchase, signs up for a subscription or adds Klarna as a payment method to your service. 

To ensure the correct User Experience is rendered, please make sure you set the correct intent on session creation via Klarna Payments:

For one-time payments:

  • set intent to ‘buy

For recurring payments:

  • set intent to ‘buy_and_tokenize’ if you want to place the first order at checkout. This is relevant for subscriptions without a free trial or a one time payment where Klarna is saved as a payment method to your digital wallet.
  • Set intent to ‘tokenize’ if you don’t want to place an order at checkout. This is relevant for subscriptions with a free trial or when saving Klarna as a payment method to your digital wallet.

Subscription details in order lines

If you are offering subscriptions with Klarna, we also require you to send in the details of the subscription when creating an order to ensure both the signup and recurring payments work in an optimal way. This is to guarantee  that we have the necessary  details to provide the best consumer retention experience possible.

The subscription details needs to be sent in both on the initial session and when creating an order using the customer token.

  • Learn how to create an order with authorization token HERE
  • Learn how to create an order with a customer token HERE


Why does it look different when I shop with Klarna?

  • Klarna has introduced a new and improved purchase flow that makes shopping with Klarna a consistent experience wherever you choose to pay. The flow is also more secure by introducing a new login process. 
  • We’re also aiming to make your purchase experience as consistent as possible in terms of payment methods. Therefore you might see some new payment methods available in the check-out, in order for you to choose how to pay regardless of where you shop. 

Why do I need to login to a Klarna account?

  • You will need to sign up for a Klarna account once – to verify and set up your account. You can also save your preferences and favorite payment method for any future purchases.

Will you remember me next time?

  • Klarna will remember you on your device. This will make your purchase experience shorter and easier for future purchases. You can always choose to opt out from being remembered by updating your settings in the Klarna app. 

How do I choose how to pay?

  • After you choose Klarna and authenticate with your account, you’ll see a screen where you can choose if you want to pay today, later or if you’d like to finance your purchase. Note that the payment methods can vary depending on the merchant.
  • If you’ve saved a payment method as your favourite earlier, you’ll be presented with this one in your next purchase. Regardless if you have a favourite payment method or not – you can always choose to change the payment method in the flow. Please note that this feature will not be available in Finland due to the consumer credit legislation.