At checkout, your customers can choose to pay with Klarna. Then, a pop-up window is opened where your customers log into their Klarna account and select their preferred Klarna payment method.
load() call happening on the client side.
The following information is applicable for both scenarios, one-time and recurring payments.
At checkout, display Klarna as a payment option by using the
load() call. Specify the following parameters:
payment_method_categories, an array that lists the Klarna payment methods for this purchase (from the ones you received in the Initiate a payment response). You may send one or more categories in your request, these are specified in
identifierusually has the value of
klarna.For one category, the used parameter is the
payment_method_category. We accept both
payment_method_categorieswith an array, and
payment_method_category,with a string.
For a better user experience, call
load() when loading your checkout. In this way, you ensure that the container of Klarna payments loads immediately in a hidden container, and it's ready to appear when needed.
Don't forget to use the Klarna logo that you received in Step 1: Initiate a payment and add the payment method name. From the payload you received in Step 1, use:
identifierto dynamically load the payment option
nameto display the correct and localized payment method title
asset_urlsto contain the Klarna logo
For more information, see the Klarna payments best practices guide.
After processing the
show_form, indicating if Klarna payments is available
error,containing details of potential error messages
We know that you want to give customers a great checkout experience. For this reason, we created a functionality to alert your store when your customer cannot use any Klarna payment method. This alert is through the
show_form boolean parameter, which is used as a response flag to the
load() call. We recommend you listen to it all the time.
There are two potential cases that you need to handle based on the response flag:
If the response flag is
show_form: true, your checkout displays Klarna as a payment option for this purchase. This is the standard response.
If the response flag is
show_form: false, your store is not able to offer Klarna as a payment option.
This negative response results from the pre-assessment that Klarna executes for the purchase.
To handle the negative response, you can set up one of the following visual arrangements in your checkout: