A Settlement configuration defines how Klarna settles payment transaction events and funds for a Partner through an Acquiring Partner.
A Settlement configuration defines how Klarna aggregates Partner balance transactions and produces settlements for a Payment Acquiring Account. It determines:
Setting Settlement configurations 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 currently create or update these configurations through an API.
Ultimately, a settlement represents the net result of all Partner balance transactions. Examples include:
A payout occurs if the resulting settlement balance is positive or carried forward and netted against future positive settlements when negative.
Link copied!
A Settlement configuration always belongs to a Payment Acquiring Account.
Each Payment Acquiring Account has one Settlement Account, which acts as the running balance that receives all Partner balance transactions, which means all individual financial entries posted to the Settlement Account. These represent events such as captures, refunds, chargebacks, fees, and other payment transaction events. Partner balance transactions are summed into a settlement and are reflected in the settlement report. With this information it will generate the settlements according to the defined schedule.
Additionally, payment transaction events (such as captures, refunds, and chargebacks) contribute entries to the Partner balance and ultimately affect the settlement outcome.
Link copied!
A Settlement configuration includes the following elements:
| Element | Description |
|---|---|
| Settlement schedule | Defines when settlement cycles occur and which Partner balance transactions are included in each cycle. |
| Settlement Account | The account used to aggregate all payment transaction events and Partner balance transactions. |
| Bank accounts for payouts | The bank accounts that may receive payout amounts when a settlement is positive. |
| Payout reference prefix | A prefix to the reference used for the payouts, helping identify and reconcile settlement entries. |
| Currency | The currency associated with the Settlement Account, where applicable. |
Note: Settlement schedules produce settlements, not payouts. Payouts occur only when the settlement balance is positive; negative balances roll forward and are netted against future positive balances.
Link copied!
Link copied!
Klarna sets up a Payment Acquiring Account and creates the associated Settlement Account. Klarna then configures the settlement schedule, the payout bank accounts, and any reference prefixes. The Acquiring Partner does not perform these steps directly.
Link copied!
If an Acquiring Partner changes its banking setup or reorganizes its legal structure, Klarna updates the Settlement configuration to reflect the new arrangement. Changes to bank accounts, schedules, or reference prefixes are performed by Klarna.
Link copied!
If an Acquiring Partner uses separate Payment Acquiring Accounts by region or market, Klarna creates multiple Settlement Accounts and Settlement configurations, enabling independent settlement and payout routing.
Link copied!
Local-Pay prefers one settlement setup for all Partners globally.
Global-Pay separates settlements for operational and reporting reasons.
Link copied!