The Payout Reference Field setting tells Junipeer which field on the Fortnox invoice (or order) contains the reference used to match incoming payouts back to their invoices. This is one of the most important settings in any PSP integration — get it wrong and payouts cannot be reconciled, invoices are never marked as paid, and your accounting drifts out of sync.
What this setting does
When a payout arrives from your PSP (Qliro, Svea, Klarna, etc.), Junipeer receives a batch of transactions. Each transaction carries a reference — typically the shop order ID or a payment reference. To book the payout correctly, Junipeer must find the corresponding invoice in Fortnox.
The Payout Reference Field setting tells Junipeer which Fortnox field to search in when looking for that reference.
Who configures this — you or Junipeer?
In most setups, this setting is configured by Junipeer as part of the connector setup, not by the merchant. This is because:
If Junipeer is responsible for sending order data to Fortnox (e.g. Shopify → Fortnox via Junipeer), we already know which field the order ID gets written into — so we set the payout side to match
The merchant does not need to know the internal mapping mechanics; they just need it to work
When you would configure it yourself:
You are running a hybrid setup where orders arrive in Fortnox via a different integration (e.g. a legacy connector, manual entry, or another iPaaS)
You migrated from another integration and your existing invoices use a non-standard field
Junipeer's default does not match how your Fortnox invoices are actually structured
You generate/send the order data externally from Junipeer
How to verify the correct field
Open a recent invoice in Fortnox and look at the Invoice details section. You'll see several reference fields populated with values. Identify which field contains the reference the PSP will send in its payout report (usually the shop order ID). Set Payout Reference Field to match.
If you're unsure, look at your PSP's payout report or sample settlement CSV — whatever reference appears there is what Junipeer will search for in Fortnox.
What happens if this is wrong
Payout reconciliation will fail with errors like:
Could not identify an invoice to use in Fortnox by ExternalInvoiceReference1=XXXXX for this payout transaction: no invoice foundThe invoice may exist perfectly well in Fortnox — Junipeer just isn't looking in the right field. Correct the setting and re-run the failed payout task.