A Settlement configuration defines how Klarna settles financial activity for a Partner through an Acquiring Partner. It specifies the Settlement Account used for settlement, the bank accounts linked to that Settlement Account, and the schedule on which Klarna aggregates transactions and produces a settlement and the payout.
Configuring Settlement settings ensures that settlement schedules, account structures, and bank details align with the Acquiring Partner’s platform. When these structures match, settlements from Klarna can be reconciled more easily against the Acquiring Partner’s internal ledger and banking records.
Klarna creates and maintains the Settlement configuration for each Payment Acquiring Account on behalf of the Acquiring Partner. Acquiring Partners do not create or update the configuration themselves.
Link copied!
A Settlement configuration defines how Klarna aggregates financial activity and produces settlements for a Payment Acquiring Account. It determines:
A settlement represents the net result of all Partner balance transactions such as:
A payout occurs if the resulting settlement balance is positive, which is the normal case.
Link copied!
A Settlement configuration always belongs to a specific Payment Acquiring Account. Each Payment Acquiring Account has one Settlement Account, which acts as the running balance that receives all financial transactions and produces settlements according to the defined schedule.
The Settlement configuration depends on:
Link copied!
The Settlement configuration defines how settlements are produced and, when applicable, how positive balances are paid out. Actual schema details may vary; refer to the official API schema when published.
| Field | Type | Description | Required |
|---|---|---|---|
| settlement_schedule | object | Defines when settlement cycles occur and which transactions are included. | Yes |
| settlement_account_id | string | Identifier of the Settlement Account used to aggregate activity. | Yes |
| bank_accounts | array<string> | Bank accounts used if a settlement results in a payout. | Yes |
| payment_prefix | string | Prefix used for the payment reference in settlement outputs and payouts. | Optional |
| currency | string | Settlement currency. | Yes |
Note: Settlement schedules produce settlements, not payouts. Payouts occur only when the settlement balance is positive.
Link copied!
Klarna creates and maintains Settlement configurations on behalf of Acquiring Partners. There is currently no public API for creating or modifying these configurations.
Link copied!
Link copied!
Link copied!
Link copied!
Link copied!
Klarna sets up a Payment Acquiring Account and assigns one Settlement Account. Klarna then creates the Settlement configuration with the appropriate schedule, bank accounts, and other properties.
Link copied!
If an Acquiring Partner updates its internal banking structure or reorganizes entities, Klarna updates the Settlement configuration and Settlement Account accordingly.
Link copied!
An Acquiring Partner uses different Payment Acquiring Accounts per market; Klarna configures separate Settlement Accounts and Settlement configurations for each.
Link copied!
Local-Pay prefers one settlement setup for all Partners, globally.
Global-Pay separates settlements for operational and reporting reasons.
Link copied!