Skip to content

Get started with Kustom Checkout for Junipeer

Introduction

Junipeer is an integration platform (iPaaS) that connects Kustom Checkout to your accounting or ERP system — such as Fortnox, Visma, or Business Central — and automatically reconciles your Kustom settlement payouts. Each payout is matched against the corresponding invoices in your books, and Kustom's fees are written off, so your settlements reconcile without manual work.

This is a settlement-side integration. Orders and invoices reach your accounting system through your existing store or ERP setup; Junipeer's role is to make sure every Kustom payout lands correctly in your books. Because orders are not synced through this integration, there are no duplicate records.

Who this is for

Merchants using Kustom Checkout who want their Kustom payouts reconciled automatically in their accounting system.

Prerequisites

Before you start, make sure you have:

  • A Kustom Checkout account with settlement API credentials generated in the Kustom Merchant Portal (see Step 1).
  • A Junipeer account at app.junipeer.io.
  • A supported accounting or ERP system (e.g. Fortnox, Visma, Business Central) that you can authorise via OAuth.
  • Orders and invoices already flowing into that accounting system through your store or ERP setup.

Step-by-step guide

1. Get your Kustom settlement API credentials

Generate the settlement API credentials Junipeer needs from the Kustom Merchant Portal (or request them from your Kustom representative). You'll need:

  • Settlements API URL
  • API user / ID
  • API password (or secret)

In the Junipeer app, these fields are labelled with the Klarna naming — Klarna settlements API URL, Klarna API user/ID, and Klarna API password — because Kustom Checkout's settlements run on Klarna's platform. Enter each value into the matching Klarna-named field.

If you operate across multiple markets and receive more than one set of credentials, Junipeer can hold several configurations for Kustom.

2. Enable the Payouts flow

In the Junipeer app, go to Get Started → Select Flows and enable Payouts.

The Kustom integration is payout-only: it reconciles Kustom settlement payouts against the invoices already in your accounting system.

3. Connect your systems

Go to Get Started → Connect Systems and connect both Kustom and your accounting system.

  • Your accounting system (e.g. Fortnox) — authorise via OAuth; a green checkmark confirms the connection. Prepare it first; for Fortnox, see Junipeer's Fortnox preparation guide.
  • Kustom — enter the credentials from Step 1.

When both systems show a green checkmark, you're ready to configure.

4. Configure settings

Go to Configure → Settings.

  1. Required settings. Any setting marked "This setting is required and must be saved" is mandatory.
  2. Settlement (payout) account mapping. Map Kustom's payment methods to your accounting system account numbers under Configure → Settings → Booking Accounting / Settlements. You'll need:
    • The account used for Kustom payouts (your bank account or an interim account)
    • Account numbers for bank costs and outgoing tax

Without payout account mapping, payouts won't book correctly. If you're unsure of the account numbers, your accountant will know.

Under Configure → Settings → General Settings, the configuration below is the recommended starting point for a standard Kustom + Fortnox payout setup:

SettingRecommended value
Payout Reference FieldExternalInvoiceReference1
Fallback Payout Reference Field(leave empty)
Use Payment ID as Payout ReferenceNo, use payment (merchant) reference
Search for the Payout Reference on the OrderOff (search on the invoice)
Book keep invoice paymentOff — enable only if you want Junipeer to automatically pay the invoice

Junipeer General Settings — recommended best-practice configuration

5. Activate

Configure the payout sync schedule in the Junipeer app — typically set to run at 23:00, so each day's Kustom settlements are processed overnight.

How payout reconciliation works

When Kustom sends a settlement payout, Junipeer matches each payout line against the corresponding invoices or credit invoices in your accounting system and writes off Kustom's fees — giving you an accurate, reconciled record without manual matching.

After go-live: what to verify

Payouts can't be tested in advance; the schedule runs in production. After the first sync:

  • Check that your Kustom payouts have booked correctly against the right invoices.
  • Confirm fees have been written off as expected.
  • Contact your Junipeer onboarding contact to review your setup and confirm everything is mapped correctly before you rely on it.

Support