Klarna

Klarna Widget

Configure the following parameters for the Connector (see Connector Config - KlarnaHpp):

1. Fill in the mandatory Username
2. Fill in the mandatory Password
3. Fill in the optional API Secret
4. Select the mandatory Extra Data: region — EU, NA, OC
5. Fill in the Extra Data: logo_url
6. Fill in the Extra Data: page_title
7. Fill in the Extra Data: background_image_url
8. Select the Extra Data: fallback — true, false
9. Select the Extra Data: confirmationModal — true, false

Connector Config - KlarnaHpp

Klarna Widget

Configure the following parameters for the Connector (see Connector Config - KlarnaWidget):

1. Fill in the mandatory Username
2. Fill in the mandatory Password
3. Fill in the mandatory API Secret
4. Select the mandatory Extra Data: region — EU, NA, OC

Connector Config - KlarnaWidget

Klarna Invoice

Configure the following parameters for the Connector (see Connector Config - KlarnaInvoice):

1. Fill in the Username
2. Fill in the Password
3. Fill in the API Secret

Connector Config - KlarnaInvoice

Data Fetcher Configuration

You have the option to configure Data Fetchers (see section Enable and Set Up Reconciliation on the Provider Level) either on Provider or on Connector Level, depending on which setup works better for your provider.

Provider Settlement

Configure the following Parameters for the Settlements Provider Data Fetcher to fetch Settlement (see https://docs.klarna.com/api/settlements/#operation/getPayouts) via an API (Europe: https://api.klarna.com/; North America: https://api-na.klarna.com/; Oceania: https://api-oc.klarna.com/) (see Edit Provider Settlement Data Fetcher Provider Level):

1. Fill in the expected Interval in which the Provider Settlement File should be fetched - days, hours
2. Select the Adapter KlarnaWidget, KlarnaHPP
3. Enable Testmode to test fetching of Provider Settlements from the Sandbox (Europe: https://api.playground.klarna.com/; North America: https://api-na.playground.klarna.com/; Oceania: https://api-oc.playground.klarna.com/), disabled the Production environments are used
4. Fill in the mandatory Extra Data: region - EU, NA, OC; region sets the base-url for the Klarna API

Edit Provider Settlement Data Fetcher Provider Level

Settlement fields

Batch Number

The batch number is set to payment_reference.

Payment Reference

The payment reference is set to payment_reference.

Mapped Fields

We are mapping the following fields from the Klarna settlement reports (Klarna → IXOPAY platform):

Provider	IXOPAY platform	default (if not set by Provider)
merchant_reference1	transaction Id	none
order_id	reference Id	none
payment_reference	payment reference	none
type	transaction type	none
payout_date	settlement date	none
amount	settlement amount	none
currency_code	settlement currency	none
detailed_type	fee type (see Fee Mapping Table below)	none

Fee Mapping Table

Fee Type	IXOPAY platform	default
SERVICING_FEE	Gateway fee	Markup fee
DISPUTE_FEE_REFUND	Dispute fee	Markup fee
DISPUTE_FEE	Dispute fee	Markup fee