Skip to main content

​
🚨 Prerequisites

Before you start, make sure you have:
  • an active Klarna merchant account
  • admin rights on the Klarna Merchant Portal: only admin users can create and manage Klarna API credentials

​
🛠 Preparation

The connection form asks for a Klarna API credential: a Username and a Password. You create it in the Klarna Merchant Portal.
1

Open the API credentials page

Sign in to the Klarna Merchant Portal and go to Settings › Klarna API credentials. You land on the list of your existing credentials.
2

Generate a credential

Click Generate new API credentials. Klarna shows a Username, a long identifier linked to your Merchant ID, and a Password.The Password is shown once. Copy both values and keep them somewhere safe: you will paste them into the connection form. If you close the window without copying the Password, generate a new credential.
Klarna disables a credential after 2 months without use and deletes it after 10 months. Once connected, the credential is used regularly, so this only matters for a credential you created but never used.

​
⚡️ Connection

1

Name your connection

Choose a name you will recognise later.The Name of connection field of the connection form
2

Select your Region

Pick the region of your Klarna merchant account: Europe, North America or Oceania. It decides which Klarna servers are used.The Region field of the connection form, a list with Europe, North America and Oceania
3

Enter your Username

Paste the Username of the credential you generated in Preparation.The Username field of the connection form
4

Enter your Password

Paste the Password shown with it.The Password field of the connection form
5

Click Connect

The connection is created straight away. Your payouts and their transactions are then read from Klarna with read-only calls.The Connect button

​
❓ Troubleshooting

Klarna refused the Username and Password, or they were sent to the wrong region.
  1. Check that both values were copied entirely, with no extra space.
  2. Check that the Region matches your merchant account.
  3. If the credential was created a while ago and never used, it may have been disabled: generate a new one in the Merchant Portal and update the connection.
Only admin users of the Merchant Portal see this page. Ask an admin of your Klarna account to generate the credential for you, or to give you admin rights.
Playground credentials only work with Klarna’s Playground environment. Ask the team that gave you the connection form whether it targets Playground or Production, and generate the credential in the matching Merchant Portal.