Connect Klarna
Updated
You connect Klarna directly with the API credentials from the Klarna merchant portal. The special thing about Klarna: it offers no webhooks, so Rechnungskit fetches new data automatically.
- Fetch every 4 hoursnew transactions as soon as Klarna provides them. Right away: "Sync now"
- Matchingthrough the order number your shop plugin stores at Klarna
- Daily reconciliationevery payout split up and checked against the payout amount
Setup
- In the Klarna merchant portal, open the Klarna API credentials under Settings and create new credentials. You get a username and an API key.
- Enter both under Connections → Connect at Klarna. Rechnungskit checks the credentials directly against the Klarna API. Important: use the credentials of your live account, even if you are only testing Rechnungskit. Rechnungskit only reads and never initiates payments. Playground credentials connect Klarna's empty test environment, where your real payments never show up.
- Rechnungskit detects automatically whether you entered live or Playground credentials (Playground is Klarna's test environment).
That is all. There is no webhook URL to enter, because Klarna does not support webhooks.
How the data comes in
- PurchaseVisible in the merchant portalright away, but not yet in the settlement data
- One to several daysKlarna processes for payoutdepending on your contract's payout schedule
- At most 4 hours laterNext fetchor right away through "Sync now"
- MatchedInvoice is createdwith the order number from your shop
- Every 4 hours Rechnungskit fetches new Klarna transactions: payments (captures), refunds and lost buyer disputes. Important: Klarna only provides a payment in this settlement data once it has been processed for the payout; right after the purchase it is not visible there yet (see Limits).
- Instant fetch: the button "Sync now" (under /payments or Connections → Connect) fetches transactions and payouts on demand, for example right after connecting or for testing.
- Once a day the payouts are reconciled as well: each Klarna payout is split into its parts (payments, refunds, fees per transaction, Klarna commission) and checked against the payout amount.
- Your payout schedule does not matter: with weekly or monthly Klarna payouts too, all included payments are imported in full, because every payout brings its own transactions.
- The order is matched by the order number your shop plugin stores at Klarna.
What happens automatically
- Each Klarna payment produces the matching invoice as soon as the order is matched.
- Refunds create the cancellation invoice (Storno) automatically.
- A buyer dispute lost at Klarna is treated like a returned direct debit: the item reopens and lands in the tasks for clarification, with no automatic cancellation invoice.
- Klarna fees are shown per payment (fee column and detail view under /payments) and go into the DATEV export separately, on their own clearing account.
In the DATEV payments batch, a Klarna payment books by default as Klarna clearing account to customer account (SKR03 1365, SKR04 1465). Rechnungskit books the fees of a payout collectively as bank charges (SKR03 4970, SKR04 6855), and the payout as bank against clearing (SKR03 1200, SKR04 1800).
The export nets a Klarna fee correction against the fees of the same payout. If Klarna refunds fees, the fee booking goes down; if Klarna charges more, it goes up. Payouts that Rechnungskit fetched before 12 September 2026 are read from Klarna once more, because fees and returns were stored with the wrong sign back then. Payouts in locked DATEV batches or locked periods stay as they are.
Limits
- Klarna provides payments with a delay, in live accounts too: a Klarna payment is visible in the Klarna merchant portal right away, but it only appears in Klarna's settlement data (the only data source Klarna offers to systems like Rechnungskit) once Klarna has processed it for the payout. Depending on the payout schedule in your Klarna contract, that can be one to several days after the purchase. This is normal Klarna behavior, not a fault. As soon as Klarna provides the data, Rechnungskit imports it with the next fetch, after 4 hours at the latest.
- If you don't want to wait for the next fetch once the data is available, use "Sync now".
- The Playground environment (test) has the same delay, sometimes longer; it does not always create test payouts.
- If an order ships in several steps (partial captures), each capture becomes its own payment; differences from the order total land in a task for clarification.
- If Klarna runs through Mollie, Stripe or Unzer for you, you don't need this connection: the payments already come in through that provider.
Where to find it in the app
Rechnungskit is not a tax advisory or law firm. This article explains general principles and does not replace advice from a tax advisor (Steuerberater, § 5 StBerG) or a lawyer (§ 3 RDG). Rechnungskit is built for businesses based in Germany and prepares documents, tax rates and bookings automatically. How your specific case is treated remains your decision, ideally together with your tax advisor or a lawyer.