Klarna

Here is an explanation of the payment settings for the Klarna operator.

Klarna is a Swedish payment operator that lets customers pay now, later or in instalments. It is available for studios from Austria, Belgium, the Czech Republic, Denmark, Finland, France, Germany, Greece, Hungary, Ireland, Italy, the Netherlands, Poland, Portugal, Romania, Slovakia, Spain, Sweden, the United Kingdom and the United States.

Available options

Here is a list of the available options with a short explanation.

Klarna API username

Determines the username of the API key from the Klarna Merchant Portal (the Username value, shown as Key ID (API Username) in the list of keys).

Klarna API password

Determines the password of the same API key (the Password value). It starts with klarna_live_ (production account) or klarna_test_ (Klarna Playground).

You create both values in the Klarna Merchant Portal. Below we show step by step how to do it.

Tip

Test mode uses a separate test account - Klarna Playground. If you enable Test mode in Foto.Guru, enter the API username and password from Klarna Playground. After you disable test mode, enter the credentials from the production Klarna Merchant Portal. Keys from one environment do not work in the other.

Currency

Klarna accepts payments only in the currency of the country where your company is registered - e.g. PLN for Poland, CZK for the Czech Republic, EUR for Germany or Slovakia. Set this currency in the Currency field in the payment settings before you select the Klarna operator. With any other currency, Foto.Guru will not save the settings and will show a message with the currency you need to use.

Settings in the Klarna Merchant Portal

The examples below show the English version of the Klarna Merchant Portal.

Klarna account

To accept payments, you need a Klarna Payments merchant account approved by Klarna.

  1. Go to the Klarna documentation and click Log in in the top menu.

  2. Select the region (Europe for studios in Europe) and the Production environment.

  3. Click Sign up and follow Klarna’s instructions.

Once your account is approved, you log in to the Klarna Merchant Portal at:

https://portal.klarna.com

Note

Only if you want to try payments in Test mode first, select the Playground environment in step 2. This creates a separate, free test account - its panel is at https://portal.playground.klarna.com, and customers cannot make real payments through it.

API keys

You create the API key in the same way in the production and the test panel - log in to the one whose credentials you want to enter in Foto.Guru.

List of API keys in the Klarna Merchant Portal
  1. In the left menu, click Settings.

  2. Select Klarna API Keys.

  3. Click Generate new Klarna API key.

New API key

Window with the new API key in the Klarna Merchant Portal

In the Klarna API keys generated window:

  1. Copy the value of the Username field and paste it in Foto.Guru in the Klarna API username field.

  2. Copy the value of the Password field and paste it in Foto.Guru in the Klarna API password field.

  3. Tick I’ve saved these credentials and click Close.

Before closing the window, you can also click Download as .txt to save the key details to a file - keep it in a safe place.

Finally, save the changes in Foto.Guru. When saving, Foto.Guru checks with Klarna that the username and password are correct.

Important

The API password is shown only once - right after the key is created. Klarna does not store it, so it cannot be read again after the window is closed. If you lose it, create a new API key and enter the new credentials in Foto.Guru.

The API password gives access to your Klarna payments - do not share it with anyone.

Common problems

Klarna did not accept the API username and password

Check that the credentials come from the right environment: with Test mode enabled - from Klarna Playground, with test mode disabled - from the production Klarna Merchant Portal. Also make sure that no character was left out when copying. Klarna disables API keys that have not been used for a long time - if in doubt, create a new key.

In ..., Klarna accepts payments only in ...

The studio currency does not match the currency of your company’s country. Change the Currency field to the one shown in the message.

The Klarna operator does not appear in the list

Klarna is available only for studios from the countries listed at the beginning of this page. What counts is the company country given in your Foto.Guru account details.