Understand your own account

Understand how your Acquiring Partner account and its related resources are modeled in Klarna so you can configure settlement, pricing, and partner onboarding correctly.

Overview

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.

graph PAY_PROFILE(Payment Profile) PAY_PRICE(Payment Price Plan) PAY_PROGRAM(Payment Program Plan) %% Payments TRANSACTION(Payment Transaction) %% Acquiring Partner PA_AP(Partner Account<br/>Acquirer) ACQ_PRO(Payment Acquiring Product) PA_AP_API_KEY(API Keys) PA_AP_WEBHOOK_CONFIG(Webhook Configuration) %% Payment Acquiring Resources ACQ_ACC(Payment Acquiring Account) ACQ_SETTL(Settlement Configuration) ACQ_ALE(Acquiring Legal Entity) PAY_PROFILE -.->|defines configuration for| TRANSACTION PAY_PROFILE -->|n..1| PAY_PRICE PAY_PROFILE -->|n..1| PAY_PROGRAM %% Acquiring Partner PA_AP -->|1| ACQ_PRO PA_AP -->|1..n| PA_AP_API_KEY PA_AP -->|1..n| PA_AP_WEBHOOK_CONFIG ACQ_PRO -->|1..n| PAY_PROFILE ACQ_PRO -->|1..n| ACQ_ACC ACQ_ACC -->|n..1| ACQ_SETTL ACQ_ACC -->|n..1| ACQ_ALE class PA_AP primaryEntity

The sections below describe each core resource in your setup and how they fit together.

Payment Acquiring Product

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.
  • Different settlement configurations per legal entity.
  • Distinct commercial setups for different Partner segments.

Even with these variations, you still use a single integration entry point to Klarna’s APIs through your Payment Acquiring Product.

Payment Profiles

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.

Payment profiles are provisioned by Klarna and can be read using the listPaymentDistributionProfilesKlarna Icon action.

Payment Acquiring Accounts

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:

  • One account per legal entity.
  • One account per legal entity and region.
  • Separate accounts for specific regulatory or banking requirements.

When you onboard a Partner, you must assign the correct Payment Acquiring Account ID. This ensures that Klarna:

  • Settles funds to the correct legal entity and settlement configuration.
  • Keeps reporting and reconciliation aligned with your internal accounting structure.

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 [ getAcquiringAccounts] action.

Settlement Configuration, Price Plans and Payment Program Plans

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.