> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://ixopay.ferndocs.com/user-manual/adapters/klarna/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://ixopay.ferndocs.com/_mcp/server.

# Klarna

## Klarna Hpp

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
10. Select the **Extra Data: fallbackShippingToBilling** — true, false

* Use shipping details as fallback in case billing details were not provided

11. Select the **Extra Data: treatBackAsCancel** — true, false

* Treat Klarna Webhook status `BACK` as `CANCELLED`

12. Select the **Extra Data: sendReferenceInCaptures** — true, false

* Send UUID of capture transaction to Klarna. The UUID will be then available in the settlements to reconcile capture transactions

13. Select the **Extra Data: disableHppSessionOnTxExpiration** — true, false

* Upon expiration of the transaction (see [Expire transaction with a given status after given minutes](https://documentation.ixopay.com/manual/docs/connector/edit/connector-settings#transaction-processing-settings)) the Klarna Hosted Payment Session will also be expired

![Connector Config - KlarnaHpp](https://documentation.ixopay.com/manual/assets/ideal-img/connector-config-klarnahpp.086002a.1320.png)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](https://documentation.ixopay.com/manual/assets/ideal-img/connector-config-klarnawidget.a6abb78.1280.png)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](https://documentation.ixopay.com/manual/assets/ideal-img/connector-config-klarnainvoice.8d096b5.937.png)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](https://documentation.ixopay.com/manual/docs/post-processing/provider)) 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](https://docs.klarna.com/api/settlements/#operation/getPayouts)) via an API (Europe: [https://api.klarna.com/](https://api.klarna.com/); North America: [https://api-na.klarna.com/](https://api-na.klarna.com/); Oceania: [https://api-oc.klarna.com/](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/](https://api.playground.klarna.com/); North America: [https://api-na.playground.klarna.com/](https://api-na.playground.klarna.com/); Oceania: [https://api-oc.playground.klarna.com/](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](https://documentation.ixopay.com/manual/assets/ideal-img/edit-provider-settlement-data-fetcher-provider-level.3c83d26.984.png)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                             |
| merchant\_capture\_reference | capture transaction Id                 | none                             |
| merchant\_refund\_reference  | refund 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 |