Understand how your Acquiring Partner account and its related resources are modeled in Klarna so you can configure settlement, pricing, and partner onboarding correctly.
This article explains how an Acquiring Partner manages and configures their Partner Account within Klarna’s system. It provides a conceptual understanding of the resources connected to your account and how these components interact to support integration and settlement flows.
Your Partner Account is the entry point to Klarna’s acquiring ecosystem. It is connected to a Payment Acquiring Product, which gives you access to Klarna’s APIs both to manage your own account and also onboard, manage and operate your Partner's accounts.
The sections below describe each core resource in your setup and how they fit together.
Your Payment Acquiring Product allows you to use all Klarna's APIs as an Acquiring Partner. It contains the configuration needed to operate even complex acquiring structures, such as:*Multiple legal entities across regions.
Even with these variations, you still use a single integration entry point to Klarna’s APIs through your Payment Acquiring Product.
A Payment Profile defines the combination of a Price Plan and a Payment Program Plan that you apply when onboarding a Partner. This lets you standardize how pricing and Payment Programs are applied across your portfolio.
/v2/distribution/products/payment/profiles| Parameter | Required | Description |
|---|
You can retrieve all available Payment Profiles using the listPaymentDistributionProfiles
When you onboard a Partner, you select which Payment Profile applies to that Partner. This choice determines which Price Plan and a Payment Program Plan will be used for the Partner’s orders.
A Payment Acquiring Account links one of your acquiring legal entities to a specific Settlement configuration in Klarna’s systems.
Each acquiring legal entity has at least one Payment Acquiring Account. More complex setups can have multiple Payment Acquiring Accounts, for example:
When you onboard a Partner, you must assign the correct Payment Acquiring Account ID. This ensures that Klarna:
For example, an Acquiring Partner with legal entities in the EU and US regions will typically have two Payment Acquiring Accounts, one for each legal entity. Each account is connected to its own Settlement configuration. When onboarding a Partner that operates only in the EU, you use the EU Payment Acquiring Account. If the Partner later expands globally with additional legal entities, you can connect multiple Payment Acquiring Accounts to the same Partner, as described in Modeling your Partner Account.
You can list all Payment Acquiring Accounts using the listAcquiringAccounts
These resources work together to define how orders are settled and how pricing and Payment Programs are applied:
In practice:
By understanding how these resources are connected, you can design an account model that matches your legal, commercial, and operational requirements while still using a single integration entry point to Klarna’s APIs.