Klarna Payments

Klarna Payments is a 3rd party payment method, that is split into three ways of payment:

• Pay Now: The order is payed now, via Direct Debit, or Bank Transfer.
• Pay Later: The order is payed on invoice.
• Slice it: The order is payed in installment rates, with an interest.

These, together with the currencies, are defined in the Klarna contract and not on Saferpay side. With each start of a new transaction, Saferpay will ask Klarna for this information. If a currency was submitted with the Payment Page Initialize Request, that isn't supported, or a certain payment category is not activated on the Klarna account, Saferpay will not show said option.

This chapter details the technical implementation of Klarna Payments, through Saferpay.

The following requirements have to be met, in order to accept Klarna Payments via Saferpay:

• The corresponding Saferpay eCommerce licence and thus the existence of a valid identification with a username and password for the Saferpay system.
• Availability of at least one active Saferpay E Commerce terminal, via which payment can be carried out and availability of the associated Saferpay TerminalId.
• A valid contract with Klarna. Please contact worldline.sps@klarna.com
• Klarna Payments is only available via the PaymentPage flow!
• SpecVersion 1.19 and up!

Unlike other payment methods, Klarna payments offers a self-onboarding service, which you can access inside the Backoffice under Settings > Terminals. Please select the terminal you want Klarna activated on and scroll down to Self Service.

This service handles differently, depending on the Saferpay environment (test|live) you are on, so please pay close attention.

You'll have two options Klarna and additionally, on the Saferpay test-environment, Klarna Simulator.

The Klarna Simulator is a Sandbox provided by Saferpay, which provides an extensive GUI for testing Klarna. In order to activate it, you first need to click on Configure. There you have to set user and password, which can be anything for the simulator. However should you enter nothing, the simulator will simulate an error, as if no, or the wrong credentials have been entered. So if you want to test that case, you can do so. Then the Environment slider will simulate live and sandbox (Test) behavior, if you want, though the differences are slim. Lastly, you have to activate the countries, you want to support Klarna in. More on that later.

Once this is done, click on Save, however you also need to activate the Simulator, by clicking on the activation-slider:

That is it! You can now use the Saferpay Klarna Simulator. And this is the Simulator on the Payment Page. Note the indicator at the top, telling you, that you are using the Saferpay Simulator:

Similar to the Klarna Simulator, it also requires the same level of configuration, like the countries, with the difference, that the user and password accept your real Klarna credentials. Enter your user and password and configure your countries.

Additionally, you also have the Test|Live slider, which does different things, depending on which Saferpay Environment you are currently on:

• Test: On the Saferpay Test Environment, this option will always point towards the Klarna Sandbox!
• Production: On the Saferpay Production-Environment, this slider will switch between the Klarna Production and Sandbox. See the next sub-chapter on why this is necessary!

Once you have entered your credentials, configured your country and, if necessary, the environment enpoint, click on Save. Lastly, make sure to activate Klarna, by clicking on the activation slider.

This is the Klarna Sandbox on the Payment Page:

Before you can accept live payments, Klarna requires a testing period. During this period, Klarna will evaluate your business and integration, before they fully activate your account. During this time, the Environment Slider inside the Klarna configuration under Settings > Terminals inside the Saferpay Backoffice, has to be turned to Testing.

Klarna requires certain datapoints to be submitted, in order for the processing to work. Most importantly, you must submit the order cart, via the Order.Items[] array. Here is a list of all the mandatory parameters, that need to be submitted:

Furthermore, for merchants in the European Union, Klarna highly recommends to also set the following parameters:

  "Payer": {
    "BillingAddress": {
      "FirstName": "John",
      "LastName": "Doe",
      "Email": "john.doe@provider.com",
      "CountryCode": "de"
    }
  },
  "Order": {
    "Items": [
      {
        "Type": "DIGITAL",
        "Id": 12345,
        "VariantId": 54321,
        "Name": "Test Product",
        "CategoryName": "Test Category",
        "Description": "Test 123",
        "Quantity": 1,
        "UnitPrice": 245,
        "IsPreOrder": false,
        "TaxRate": 1900,
        "TaxAmount": 123,
        "DiscountAmount": 0
      }
    ]
  },

Klarna requires the Billing Address to be set. There are two options you have, on how this is done.

1. The address is captured during the payment process, where the customer has to enter it him/herself:
2. If you already have the address stored in your shop, you can also submit it, with the Payment Page Initialize Request, inside the Payer.BillingAddress container. In this case the address-form will be skipped.

"Payer": {
    "BillingAddress": {
        "FirstName": "John",
        "LastName": "Doe",
        "Email": "john.doe@provider.com",
        "CountryCode": "de",
        "Gender": "MALE",
        "Street": "Fakestreet 1",
        "Zip":"12345",
        "City":"Notown",
        "DateOfBirth": "1990-03-17",
        "Phone": "+491234659870"
    }
},