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.
Creating a test account
Testing an integration with Klarna requires a Klarna test account.When testing you can view orders here: https://online.testdrive.klarna.com.
Configure the checkout handler
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)
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.
Testing
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
Going live
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/.