Klarna

Klarna is a sweedish based e-commerce company that provides payment services for online stores. When a purchase is completed, Klarna will pay the merchant instantly, but will bill the acquirer upon receiving the goods.

Klarna allows the user to pay only with an email address and a delivery address - no password. They operate in Sweden, Norway, Denmark, Germany, Netherlands, Finland, United Kingdom, Austria and United States.

Klarna is available for Professional accounts.

The maximum payable amount by a customer, for Klarna, is:

Currency Amount EUR Amount
EUR 3000  
DKK 20000 2600
NOK 31500 3400
SEK 50000 5200

How does it work for the user?

After checkout, the customer must only insert email, zip code and a billing address. For returning customers it’s a one tap payment experience: the system will recognize you and will avoid to reenter sensitive data. This has prooved to be effective especially with mobile payments.

How do I activate it on Gestpay?

Contact Gestpay support to add Klarna to your payment options.

Klarna requires you to accept their terms and conditions, and they will also perform some tests to verify that the User Experience is compliant to their standards.

If you satisfy these requirements, you’ll be able to use Klarna with Gestpay.

Klarna permits to authorize a payment and settle it in max 14 days. This is different from the default Gestpay behaviour of 25 days.

How do I use it on Gestpay?

If you want to use the paymentType tag for this method, the value to use is S2PKLA. See the section How to redirect the customer to a payment method to learn how to use the paymentType tag.

Please refer to the API section on how to use Klarna on Gestpay.

Mandatory fields

To use Klarna you must send some mandatory parameters, children of OrderDetails:

Billing Details

Based on the buyer’s country, you might need to set fields differently.

If the shipping address is different than the billing address, then Shipping needs to be sent in the request too, with full details, otherwise the transaction will be rejected.

Some exception apply to DE and NL Countries:

If the Billing Address CountryCode differs from Shipping Address CountryCode, the transaction will fail.

ProductDetails

ProductDetails contains info about products bought by your customers. It can have one or more ProductDetail along with all the info about pricing and discount. Klarna requires the price to follow some rules, described in the following paragraphs.

Product Type

Based on the Billing Address CountryCode, the Type attribute in ProductDetail can have different values.

Let’s see a table with all the possible Product types and when they’re used.

Type Value Description Country Code Note
4 Discount All available countries Entered as a negative value to be subtracted from the total order
5 Phisical article All available countries Physical purchase
6 Shipping fee All available countries Used when a shipping fee is added to the order
7 Sales tax US Only for USA VAT tax
8 Digital article All available countries Intangible purchase, like a license
9 Gift Card All available countries Gift card purcase
10 Store credit All available countries Entered as a negative value to be subtracted from the total order
11 Surcharge All available countries Used for additional fees

For all countries, you can use all product types listed above except 7. Choose the type the better represents the item you’re selling.

Type 7 is only used when a product is sold in a US country.

About type 4, Discount:

Since both discounts can be used together, here is a formula to calculate the price along with discounts:



Let’s do an example. You can see three products and their attributes in this table.


  Product 1 Product 2 Product 3
ProductCode 1 2 3
Name 1 2 3
Description This is an example WITH percentage discount This is an example WITHOUT percentage discount this is the discount
Quantity 3 2 1
Price 10 10 -5
Type 1 1 4
In this case, the type tells klarna that this is a discount product.
Discount
Applied only to the item, in percentage
10    

The total price is:


The discount, either global or per-product, can influence the refund process.

Optional details

The remaining data, besides product & billing details, should be sent in full (ie: customer FirstName; customer LastName; phone, email address, social security number). However, these details can be added on Klarna’s page if not sent by Merchant.

Handling Failure on Klarna page

If the phone is not sent in the request and if on Klarna the customer enters incorrect details for this parameter, the customer will be redirected to the Failed page, without the possibility to re-enter the phone details. This does not apply for sandbox environment.

Credentials for test environment

Ask Gestpay customer support to enable Klarna in test environments.

You can use the following parameters value in order to test Klarna in test environment. Use a low amount like 10.00 EUR. Remember to set the mandatory fields:

When landing of Klarna payment page use the following parameter to fill the field or send it directly in the parameters like as described above in order to have a successful test payment:

You might want to test for other countries. Here are other Personal Numbers:

Country Personal Number
SE 410321-9202
SE 4103219202
FI 190122-829F
FI 190122829F
NO 1087000571
DK 801363945

Partial reversal

You can perform partial or total refunds in two ways: