This guide is for shop and finance staff connecting Klarna to Fortnox with Junipeer. It covers what the integration does, where the Klarna credentials go, how payouts are booked and matched to invoices, and what to check before going live.
Start with the general guide for payment providers: Connecting payment services to Junipeer. This guide only covers what is specific to Klarna and Fortnox.
What the integration does
The Klarna ↔ Fortnox integration has one flow: Export Payouts to Fortnox. It fetches your Klarna settlements, finds the matching invoices in Fortnox, registers the payments and books Klarna's fees.
It does not create orders, invoices or credit invoices. Those must already be in Fortnox – usually created by your webshop → Fortnox integration. This is why the reference settings below are so important: this integration has to find invoices that another integration created.
Credentials
Go to Get Started → Connect Systems. Connect Fortnox first (you authorise it in Fortnox), then enter your Klarna settlements API details:
Setting | What to enter |
|---|---|
Klarna settlements API Url | The address of Klarna's settlements API. Usually |
Klarna API user/id | The username or ID for Klarna's settlements API. |
Klarna API password or secret | The password or secret that goes with the user/id. It is hidden after you save it. |
All three are required. When both systems show a green checkmark, you can start configuring.
Payout booking: Booking Accounting Settings for Settlements
Go to Configure → Settings and open Booking Accounting Settings for Settlements. Add Klarna as the payment provider and fill in:
Setting | What to enter |
|---|---|
Payment Method | The payment method (betalsätt) in Fortnox that Klarna payouts are booked against. The list comes from Fortnox – if Klarna is missing, create it in Fortnox first, then click Clear Cache on the settings page. Required. |
Map Currency with Mode of Payment (if different than (default) Payment Method above) | Optional. Use it only if payouts in a certain currency should use a different payment method. Currencies you don't map use the Payment Method above. |
Account Number Bank Costs | The account for Klarna's fee, excluding VAT. Often 6570. Required. |
VAT account for provider fees | Where VAT on Klarna's fees is booked. This is input VAT you can deduct. Only used when Klarna reports VAT on a fee. Required. |
Account Number for Incoming Tax | Only used when the payout isn't from Sweden. Leave it empty for Swedish payments. |
Account Number for Penny rounding | Small differences between the invoice amount and the paid amount. Often 3740. Required. |
Account Number for Currency Profit / Account Number for Currency Loss | Small differences caused by currency conversion. Often 3960 and 7960. Leave them empty to book these on the penny rounding account instead. |
The account numbers above are common Swedish values, not rules. Confirm every account with whoever does your bookkeeping before you save. Click the ? next to each setting for details.
Without this section, payouts can't be booked in Fortnox.
How payouts are matched to invoices
How a payout is reconciled
From the customer's payment to the right account in your ERP.
Matching relies on the reference saved on the order or invoice when the order was synced. Without the reference the payout cannot be matched.
Each Klarna settlement lists the payments it contains. For each payment, Junipeer compares a reference from the settlement with a field on the Fortnox invoice or order. Both sides must hold the same value.
These settings are under General Settings:
Setting | What it does |
|---|---|
Payout Reference Field | Which Fortnox field holds the reference – usually where the shop order ID or payment order ID is stored. Required. |
Fallback Payout Reference Field | A second field to look in if the reference isn't found in the first one. Optional. |
Use Payment ID as Payout Reference | Whether to search with the merchant reference or the Payment ID (usually the Klarna Order ID). |
Search for the Payout Reference on the Order | Yes looks on the Fortnox order and then finds its invoice. No looks directly on the invoice. |
Book keep invoice payment | Books (bokför) the payment in Fortnox. On by default, and needed if invoices should be marked as paid automatically. |
Fortnox offers these fields:
DocumentNumber (ID)
ExternalInvoiceReference1
ExternalInvoiceReference2
OurReference (not commonly used)
YourOrderNumber (only on invoices – can't be used to search orders)
Use Payment ID as Payout Reference chooses which reference from the payout Junipeer searches for:
No, use payment (merchant) reference (default)
Yes, use Payment (order) ID
Use Payment (order) ID, then (merchant) Reference if not found
Use (merchant) Reference, then Payment (order) ID if not found
Align with your order integration
Because orders come from another integration, both integrations must agree on which Fortnox field carries the order reference. For example: if your webshop integration writes the order number to ExternalInvoiceReference1, set Payout Reference Field to ExternalInvoiceReference1 and keep Use Payment ID as Payout Reference on the merchant reference.
To check:
Open a recent Klarna-paid invoice in Fortnox.
Find the reference field that holds the order number (or Klarna Order ID).
Set Payout Reference Field – and Use Payment ID as Payout Reference – to match.
If invoices in Fortnox were not created through Junipeer, matching may not work reliably, because the invoices may not carry a reference that Klarna's settlement contains. Read more in Matching payout references in Fortnox.
Go-live checklist
Fortnox and Klarna both show a green checkmark under Connect Systems.
Your webshop → Fortnox integration is creating invoices for Klarna orders.
Klarna exists as a payment method in Fortnox.
Booking Accounting Settings for Settlements is filled in for Klarna, and your bookkeeper has approved the accounts.
Payout Reference Field matches the field your invoices actually use. Check it on a real invoice.
Schedule Export Payouts to Fortnox to run once a day, typically at 23:00. Payouts usually can't be tested beforehand – watch the first runs in production.
Contact your Junipeer onboarding contact to review the setup before you go live.
Common pitfalls
"No invoice found" on payouts. Junipeer is looking in the wrong field, the settlement carries a different reference than the invoice (Klarna Order ID instead of your order number, or the other way round), or the invoice hasn't been created yet. Check Payout Reference Field and Use Payment ID as Payout Reference, then re-run the failed payout task.
Expecting orders or refunds from this integration. It only handles payouts. Orders, invoices and credit invoices come from your order integration.
"The payment date cannot precede the invoice date". The invoice was created after Klarna registered the payment. Make sure invoices are created often enough.
Currency mismatch. A payout in a different currency than the invoice can't be matched. Contact Junipeer support if you sell in several currencies.
Payment method missing in the list. Create it in Fortnox, then click Clear Cache.
Klarna turned on in the webshop before Junipeer was set up. Early orders can get the wrong payout references. Always configure Junipeer first.
For more errors, see the Error Codes reference or contact support@junipeer.io.