Klarna Checkout v2

Klarna Checkout is a service from Klarna that gathers all your payment options into one agreement. You only have one supplier, one integration, one agreement, one payout, one settlement and one customer support. Plus Klarna assumes the customer risk, meaning you get paid even if the customer doesn't pay Klarna. Klarna Checkout is rendered through an iframe where all popular payment methods are included.

Dynamicweb integrates with both Klarna Checkout v2 and Klarna Checkout v3. 

Since Klarna Checkout v2 is being phased out and will be unsupported from September 2020, we recommend that you use the Klarna Checkout v3 provider instead.

The documentation below is provided as is, primarily to support legacy implementations.

Klarna is only available in the following combinations of country, currency and locale

Country

Language

purchase_country

purchase_currency

locale

Sweden

Swedish

SE

SEK

sv-se

Finland

Finnish

FI

EUR

fi-fi

Finland

Swedish

FI

EUR

sv-fi

Norway

Norwegian

NO

NOK

nb-no

Germany

German

DE

EUR

de-de

Austria

German

AT

EUR

de-at

Refunds and partial/full returns are not a part of the integration, and your site should have a public IP - if it doesn't the order is not completed and is shown as red in Dynamicweb administration.

Testing an integration with Klarna requires a Klarna test account.When testing you can view orders here: https://online.testdrive.klarna.com. 

Once your account has been configured, you can create and configure the matching payment method in Dynamicweb.

To do so:

  • Create or edit a payment method in the Settings > Ecommerce > Orders > Payment following the regular procedure
  • Select the Klarna Checkout checkout handler from the dropdown
  • Fill in the associated parameters (Figure 3.1)
Figure 3.1 The parameters available for the checkout handler

You must:

  • Enter your Merchant ID (EID) and Shared secret provided to you by Klarna
  • Enter a URL to terms and conditions
    In Germany and Austria it is required to have a link to your terms and conditions. Select the page with your terms and conditions.

 

Additionally, you can:

  • Customize any templates
    • Payment template is used in a Payment information step where the customer is able to write e.g. the social security number and fetch the address. Check Update billing/shipping info if the user is allowed to update the fields
    • Cancel template is used when a payment is cancelled
    • Error template is used when an error occurs in a payment
  • Choose to send invoice via e-mail
    When checked​, an invoice will be e-mailed to the customer upon authorizing the order.
  • Make the phone field/date of birth mandatory
    In some countries, where phone/the date of birth are optional to submit when finalizing an order, the phone/date of birth field can be changed to be forced to be filled instead. When checked, the iframe will control that a phone number/date has been entered, even if it was optional at first. When not checked, countries where phone/date of birth is optional will remain optional. Please note that Klarna might overwrite the field if it is not allowed to use that setting.
  • Allow separate shipping addresses
    Allow the customer to ship to a different shipping address than the billing address. Only for Germany and Austria.
  • Enable packstation
    This setting only applied for Klarna Checkout in Germany. When checked, the user will have the possibility to select DHL packstation as delivery address. When checked the option will be available as an option.
  • Update billing/shipping info
    These settings allow the customer to update the billing/shipping addresses in the Klarna Infomation section which means that the merchant doesn't need to make an information step in the cart.
    When checked it is allowed for the customer to modify the billing/shipping address.
  • Choose to exclude shipping address
  • Choose to use Test mode
    Check this to simulate Klarna transactions without involving real money transfers.

 

There’s a link for Klarna’s online order management tool which leads you to the live Klarna administration website where you are able to manage your orders.

You should test your setup thoroughly before going live. You can use these test credentials to test out your website:

https://developers.klarna.com/en/no+php/kco-v2/test-credentials

Once the integration is successfully tested in the developer test environment, you set up the checkout handler with the credentials for the Klarna merchant account that you want to use for live transactions and without a check mark in the Test mode field in the checkout handler settings. Contact Klarna to get a live account: https://www.klarna.com/.