Payment Acquiring Account
A Payment Acquiring Account defines a specific configuration an Acquiring Partner uses when operating on the Klarna Network.
23 min read
The Payment Acquiring Account defines a specific configuration for an Acquiring Partner. It connects configuration data points from the Acquiring Partner, such as an Acquiring Legal Entity and a Settlement Configuration, to one or more Payment Accounts. Payment Transactions are indirectly linked to a Payment Acquiring Account through the Payment Accounts that reference it.
Each Payment Acquiring Account has a unique identifier and is defined under a Payment Acquiring Product. This setup lets an Acquiring Partner model multiple operating structures in Klarna (for example, a regional Acquiring Legal Entity with its own Settlement Configuration) and reuse those structures across the Klarna Network.
Relationships and Dependencies
graph
%% Partner objects
PA(Partner Account
Partner)
PAY_PRO(Payment Product)
PA_PBE(Partner Business Entity)
PAY_ACC(Payment Account)
%% Payments
TRANSACTION(Payment Transaction)
%% Acquiring Partner
PA_AP(Partner Account
Acquirer)
ACQ_PRO(Payment Acquiring Product)
%% Payment Acquiring Resources
ACQ_ACC(Payment Acquiring Account)
ACQ_SETTL(Settlement Configuration)
ACQ_ALE(Acquiring Legal Entity)
ACQ_KLE(Klarna Legal Entity)
%% Partner relationships
PA -->|1..n| PA_PBE
%% Partner Payment relationships
PA -->|1..n| PAY_PRO
PAY_PRO -->|1..n| PAY_ACC
PAY_ACC -->|1| PA_PBE
PAY_ACC -->|1..n| TRANSACTION
%% Acquiring Partner
PA_AP -->|1| ACQ_PRO
ACQ_PRO -->|1..n| ACQ_ACC
ACQ_ACC -->|1..n| PAY_ACC
ACQ_ACC -->|n..1| ACQ_SETTL
ACQ_ACC -->|n..1| ACQ_ALE
ACQ_ACC -->|n..1| ACQ_KLE
ACQ_ALE -.->|counterparty for| PAY_ACC
class PA tertiaryEntity
class PA_AP tertiaryEntity
class ACQ_ACC primaryEntity
- Partner Account: Represents the overall Partner-level relationship with Klarna. Each Payment Acquiring Product, and therefore each Payment Acquiring Account, belongs to a specific Partner Account.
- Payment Acquiring Product: Groups one or more Payment Acquiring Accounts under a specific acquiring proposition or product offered to the Acquiring Partner.
- Settlement Configuration: Defines how transactions that are indirectly connected to this Payment Acquiring Account are settled to the Acquiring Partner.
- Acquiring Business Entity: Represents the specific legal entity of the Acquiring Partner responsible for processing transactions associated with this Payment Acquiring Account.
- Klarna Legal Entity: Identifies the specific Klarna Legal Entity that is party to the transactions tied to this Payment Acquiring Account.
- Payment Account: Each Payment Account must be associated with a specific Payment Acquiring Account. It connects individual Payment Transactions to the correct Payment Acquiring Account.
These relationships provide important business, legal, and settlement context for the Payment Acquiring Account. They are not currently exposed as direct, queryable fields on the Payment Acquiring Account resource in the Klarna Management API.
Resource Properties
Lifecycle
There is currently no lifecycle or webhook event management for Payment Acquiring Accounts. These resources are static configurations maintained by Klarna and are not dynamically created or updated through the API.
Frequent Use Cases
Read Payment Acquiring Accounts
Use the [ getAcquiringAccounts] operation in the Klarna Management API to retrieve all Payment Acquiring Accounts available for your Partner Account.
Create, Update and Delete Payment Acquiring Accounts
Creation, update, and deletion of Payment Acquiring Accounts are handled exclusively by Klarna. You cannot perform these operations through the Klarna Management API.
If you need a new Payment Acquiring Account, or a change to an existing one (for example, a new Settlement Configuration or Partner Business Entity), contact your Klarna representative. After Klarna applies the change, the updated configuration will be available when you call [ getAcquiringAccounts] .
API & SDK references
Jump to section...