At checkout, the customer can select from the widget Klarna as the payment method for their purchase.
load() call happening on the client side.
The following information is applicable for both scenarios, one-time and recurring payments.
Display the widget in the checkout by using the
load() call. Specify the following parameters:
payment_method_category, the options to pay with Klarna that will appear in the widget. This parameter usually has the value of
klarna(for more details, see the Payment methods section).
For a better user experience, call
load() when loading your checkout. In this way, you ensure that the widget loads immediately in a hidden container, and it's ready to appear whenever your customer selects Klarna as a payment method. This strategy is to avoid any loading delay after clicking on the Klarna payment method.
You can customize the look and feel of the widget according to your brand guidelines. See the additional features section to learn more.
Don't forget to use the Klarna logo that you received in Step 1: Initiate a payment and add the payment method title. From the payload you received in Step 1, use:
identifierto dynamically load the payment widget
nameto display the correct and localized payment method title
asset_urlsto contain the Klarna logo
In practice, your customer should see a radio button for every
payment_method_category on the payment selection page.
For more information, see the Klarna payments best practices guide.
Managing the name and the Klarna logo takes place outside the Klarna widget. You can handle it when adding the widget in your checkout and use the name and
asset_urls returned in Step 1: Initiate a payment.
After processing the
show_form, indicating if the Klarna payment methods are available in the widget
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, the widget displays the Klarna payment methods available for this purchase. This is the standard response.
If the response flag is
show_form: false, your store is not able to offer the selected Klarna payment method in the loaded widget.
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: