Klarna è una società svedese specializzata in soluzioni di pagamento che permette agli esercenti di offrire ai propri clienti la possibilità di pagare subito o in modo dilazionato, grazie a un processo di acquisto semplice e veloce, senza rischi per il business: una volta completato il pagamento, l’esercente incassa immediatamente l’importo, indipendentemente dalla modalità di pagamento scelta dal cliente.

🛍️ Integrazione di Klarna su Payment Orchestra

Offri ai tuoi clienti flessibilità, fiducia e conversioni più alte grazie a Klarna.
Con l’integrazione diretta nel nostro gateway, puoi abilitare i principali metodi di pagamento Klarna per vendere facilmente e in modo scalabile in Europa, Stati Uniti, Canada, Australia e Nuova Zelanda.

✅ Vantaggi principali

Aumento delle conversioni: i clienti completano più acquisti grazie a opzioni di pagamento flessibili.
Esperienza d'acquisto migliorata: checkout rapido e intuitivo.
Copertura geografica ampia: supporto attivo in oltre 20 paesi.
Gestione del rischio: Klarna si assume il rischio di frodi e mancati pagamenti.

💳 Prodotti Klarna disponibili

Klarna offre un portafoglio ampio di soluzioni di pagamento, suddivise in tre categorie chiave:

Pay Now (pagamento immediato)
Pay Later (pagamento differito o dilazionato)
Financing (finanziamento a medio-lungo termine)

A prescindere dalla modalità di pagamento scelta dall’acquirente, l’esercente riceve subito l’intero importo della transazione.

🔹 Dettaglio prodotti Klarna

🔵Pay Now (Pagamento immediato)

Con Klarna Pay Now, permetti ai clienti di pagare istantaneamente con metodi familiari:

Bank Transfer: bonifico immediato tramite online banking
Pay by Card: pagamento con carta di credito/debito (disponibile nei principali mercati)

🟡 Pay Later (Pagamento differito o dilazionato)

Opzioni per pagare più tardi senza interessi:

Pay in 30 days: il cliente riceve il prodotto e paga entro 30 giorni
Pay in Installments: pagamento diviso in 3 o 4 rate senza interessi

🟢 Financing (Finanziamento 6–36 mesi)

Soluzioni rateali a medio-lungo termine, ideali per ordini di importo maggiore:

Financing: finanziamento Klarna fino a 36 mesi

⏱️ Tempistiche di accredito

L’accredito delle transazioni Klarna all’esercente è gestito da Fabrick, che opera come Payment Facilitator.

Le tempistiche di accredito dipendono da quanto stabilito nel contratto di adesione al servizio Payment Facilitator tra l’esercente e Fabrick.
In caso di accredito giornaliero, ad esempio, il pagamento viene accreditato all’esercente a T+9 rispetto alla data di esecuzione della transazione (dove T indica il giorno della transazione).

📌 Nota: Se la data di accredito coincide con un giorno non lavorativo (festivo o fine settimana), l’accredito viene posticipato al primo giorno lavorativo successivo.

Esempio accredito giornaliero

Questa logica si applica a tutte le modalità di pagamento Klarna (Pay Now, Pay Later, Financing): l’esercente riceve l’accredito nei tempi indicati indipendentemente dalla modalità scelta dal cliente.

👤 Come funziona per gli acquirenti

Durante il processo di pagamento, l’acquirente inserisce il numero di telefono e/o l’indirizzo e-mail associati al proprio account Klarna.
Il sistema riconosce automaticamente l’utente, evitando l’inserimento di ulteriori dati e garantendo un’esperienza rapida e fluida.

Dopo l’accesso, Klarna guida l’utente attraverso un checkout semplice e intuitivo, dove può selezionare la modalità di pagamento preferita tra Pay Now, Pay Later o Financing.

La disponibilità delle opzioni dipende da diversi fattori, tra cui:

Profilo dell’utente
Paese di residenza
Importo dell’acquisto
Policy di Klarna

L’intero processo è progettato per ridurre i passaggi e aumentare le probabilità di completamento dell’ordine.

🌍 Copertura geografica e disponibilità prodotti

Di seguito la mappatura dettagliata della disponibilità dei prodotti Klarna per paese, valuta e modalità di pagamento:

Nota: la disponibilità effettiva può variare in base a policy di Klarna, al profilo dell’utente e al contesto locale. La tabella fornisce una panoramica aggiornata e orientativa.

💼 Come funziona per gli esercenti

Per iniziare ad accettare pagamenti con Klarna, è sufficiente aderire alle condizioni dedicate riservate da Fabrick ai propri clienti, firmando il contratto che abilita Fabrick a operare come Payment Facilitator.

Una volta completate le procedure contrattuali e tecniche richieste, Klarna potrà essere utilizzato insieme agli altri metodi di pagamento disponibili su Fabrick Payment Orchestra.

L’integrazione è semplice: è sufficiente utilizzare il tag paymentType con valore KLARNA. Per maggiori dettagli sull’uso del tag, si rimanda alla sezione Come indirizzare un cliente su un metodo di pagamento.

Questa modalità di incasso consente di movimentare il pagamento entro 28 giorni, rispetto ai 25 giorni generalmente previsti per le carte.

Tutte le principali funzionalità sono gestibili tramite la Fabrick Dashboard:

consultazione dei movimenti dell’account Klarna
disposizione di catture, rimborsi e cancellazioni
riconciliazione finanziaria avanzata
accesso alla reportistica
modifica dei contatti del Customer Care da mostrare agli acquirenti

Su richiesta, è possibile attivare anche l’accesso al Klarna Merchant Portal, che consente di utilizzare il servizio di On-Site Messaging per mostrare e personalizzare i messaggi Klarna nel sito dell’esercente. Per maggiori informazioni, è possibile consultare il sito ufficiale di Klarna.

Campi da inviare nella chiamata verso Klarna

I paramentri obbligatori richiesti per la chiamata verso il servizio sono quelli che identificano:

il Billing Address
i Product Details (campi: Name, Unit Price e Quantity)

Nelle tabelle di seguito sono riportati i parametri che è possibile inviare (in grassetto i campi obbligatori):

Billing Address

Field

Max Length

Description

OrderDetails.BillingAddress.FirstName

Billing Customer First Name

OrderDetails.BillingAddress.Lastname

Billing Customer Last Name

OrderDetails.BillingAddress.Company

Billing Company

OrderDetails.BillingAddress.StreetName

100

Billing street name. Accepts only alpha-numeric characters.

OrderDetails.BillingAddress.Email

100

Billing Customer email

OrderDetails.BillingAddress.City

Billing city name

OrderDetails.BillingAddress.ZipCode

Billing zip code

OrderDetails.BillingAddress.State

Billing Region or State

OrderDetails.BillingAddress.CountryCode

Should follow the standard of ISO 3166 alpha-2. E.g. GB, US, DE, SE.

OrderDetails.BillingAddress.PrimaryPhone

100

Customer’s phone including prefix.

Shipping Address

Field

Max Length

Description

OrderDetails.ShippingAddress.FirstName

Shipping Customer First Name

OrderDetails.ShippingAddress.Lastname

Shipping Customer Last Name

OrderDetails.ShippingAddress.Company

Shipping Customer Company

OrderDetails.ShippingAddress.StreetName

Shipping street name. Accepts only alpha-numeric characters.

OrderDetails.ShippingAddress.Email

100

Shipping Customer email

OrderDetails.ShippingAddress.City

Shipping city name

OrderDetails.ShippingAddress.ZipCode

Shipping zip code

OrderDetails.ShippingAddress.State

Shipping Region or State

OrderDetails.ShippingAddress.CountryCode

Should follow the standard of ISO 3166 alpha-2. E.g. GB, US, DE, SE

OrderDetails.ShippingAddress.PrimaryPhone

Customer’s phone including prefix

OrderDetails.ShippingAddress.ShippingMethod

Shipping Method [STORE | PICKUP_POINT | CARRIER] - campo non obbligatorio ma se ne consiglia la compilazione

Customer info

Field

Max Length

Description

OrderDetails.CustomerDetail.FirstName

Customer First Name

OrderDetails.CustomerDetail.Lastname

Customer Last Name

Product Details

Field

Max Length

Description

OrderDetails.ProductDetails[x].Description

255

Article’s description

OrderDetails.ProductDetails[x].SKU

Article’s Stock Keeping Unit

OrderDetails.ProductDetails[x].Name

100

Article’s name

OrderDetails.ProductDetails[x].UnitPrice

Article’s Unit Price

OrderDetails.ProductDetails[x].Quantity

The number of products

OrderDetails.ProductDetails[x].ImageUrl

2048

Article's image

OrderDetails.ProductDetails[x].ProductInfoUrl

2048

Link to product informations

OrderDetails.ProductDetails[x].Type

The type of article. [Per controllare tutti i possibili tipi di prodotto e quando utilizzarli è disponibile una tabella dedicata riportata di seguito]

Shipping Method

Field

Max Length

Description

FullFillment.FullFillmentlst.FullfillmentDetail.TrackingCompany

512

Tracking company Name*

FullFillment.FullFillmentlst.FullfillmentDetail.TrackingNumbers

1024

Tracking number*

FullFillment.FullFillmentlst.FullfillmentDetail.TrackingUrls

2048

Link to tracking information

*Queste informazioni permettono al cliente di visualizzare sull'app di Klarna i dati relativi alla spedizione. In particolare se il Carrier Partner è uno di quelli presenti nel documento di seguito https://docs.klarna.com/order-management/delivery/klarna-carrier-partner-list/ external link , il buyer sarà in grado di monitorare tutti gli step della spedizione direttamente dall'app Klarna.

Order Details

Field

Max Length

Description

OrderDetails.PaymentPageDetails.LogoUrl

2048

Logo displayed on the Payment Page

OrderDetails.ProviderPageDetails.BackgroundUrl

2048

Backgroung Image dispayed on the Payment Page

OrderDetails.ProviderPageDetails.BackgroundWidth

Background Image width

OrderDetails.ProviderPageDetails.PageTitle

255

Title displayed on the Payment Page

OrderDetails.ProviderPageDetails.PrivacyUrl

2048

Link to Privacy Conditions

OrderDetails.ProviderPageDetails.TermsAndCondsUrl

2048

Link to Terms and Conditions

SOAP

REST

Esempi di integrazione

Esempi di integrazione sono disponibili nella sezione API, dove troverete un esempio di autorizzazione, storno e cattura parziali.

Autorizzazione transazione

1<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:ecom="https://ecomm.sella.it/">
2    <soap:Header/>
3    <soap:Body>
4        <ecom:Encrypt>
5            <ecom:shopLogin> --MERCHANT SHOP LOGIN HERE-- </ecom:shopLogin>
6            <ecom:apikey> --MERCHANT API KEY HERE-- </ecom:apikey>
7            <ecom:uicCode>242</ecom:uicCode>
8            <ecom:amount>516.49</ecom:amount>
9            <ecom:shopTransactionId>KLARNA_TEST_20220512_S02</ecom:shopTransactionId>
10            <ecom:languageId>1</ecom:languageId>
11            <ecom:paymentTypes>
12                <ecom:paymentType>KLARNA</ecom:paymentType>
13            </ecom:paymentTypes>
14            <ecom:OrderDetails>
15                <ecom:providerPageDetails>
16                    <ecom:LogoUrl>https://www.axerve.com/images/logos/logo-color-positive.svg</ecom:LogoUrl>
17                    <ecom:BackgroundUrl>https://www.axerve.com/images/logos/logo-color-positive.svg</ecom:BackgroundUrl>
18                    <ecom:BackgroundWidth>100</ecom:BackgroundWidth>
19                    <ecom:PageTitle>Completa il pagamento</ecom:PageTitle>
20                    <ecom:PrivacyUrl>https://www.google.it</ecom:PrivacyUrl>
21                    <ecom:TermsAndCondsUrl>https://www.google.it</ecom:TermsAndCondsUrl>
22                </ecom:providerPageDetails>
23                <ecom:CustomerDetail>
24                    <ecom:FirstName>Test</ecom:FirstName>
25                    <ecom:Lastname>Person-it</ecom:Lastname>
26                    <ecom:PrimaryEmail>customer@email.it</ecom:PrimaryEmail>
27                </ecom:CustomerDetail>
28                <ecom:ShippingAddress>
29                    <ecom:FirstName>Test</ecom:FirstName>
30                    <ecom:Lastname>Person-it</ecom:Lastname>
31                    <ecom:StreetName>Via Enrico Fermi 150</ecom:StreetName>
32                    <ecom:City>Roma</ecom:City>
33                    <ecom:ZipCode>00146</ecom:ZipCode>
34                    <ecom:CountryCode>IT</ecom:CountryCode>
35                    <ecom:Email>customer@email.it</ecom:Email>
36                    <ecom:PrimaryPhone>+393339741231</ecom:PrimaryPhone>
37                    <ecom:ShippingMethod>STORE</ecom:ShippingMethod>
38                </ecom:ShippingAddress>
39                <ecom:BillingAddress>
40                    <ecom:FirstName>Test</ecom:FirstName>
41                    <ecom:Lastname>Person-it</ecom:Lastname>
42                    <ecom:StreetName>Via Enrico Fermi 150</ecom:StreetName>
43                    <ecom:City>Roma</ecom:City>
44                    <ecom:ZipCode>00146</ecom:ZipCode>
45                    <ecom:CountryCode>IT</ecom:CountryCode>
46                    <ecom:Email>customer@email.it</ecom:Email>
47                    <ecom:PrimaryPhone>+393339741231</ecom:PrimaryPhone>
48                </ecom:BillingAddress>
49                <ecom:ProductDetails>
50                    <ecom:ProductDetail>
51                        <ecom:Description>Borsa</ecom:Description>
52                        <ecom:SKU>48696138_M</ecom:SKU>
53                        <ecom:Name>Borsa</ecom:Name>
54                        <ecom:UnitPrice>500</ecom:UnitPrice>
55                        <ecom:Quantity>1</ecom:Quantity>
56                        <ecom:ImageUrl>https://www.axerve.com/images/logos/logo-color-positive.svg</ecom:ImageUrl>
57                        <ecom:ProductInfoUrl>https://www.axerve.com/borsa</ecom:ProductInfoUrl>
58                        <ecom:Type>5</ecom:Type>
59                    </ecom:ProductDetail>
60                    <ecom:ProductDetail>
61                        <ecom:Description>Scarpe</ecom:Description>
62                        <ecom:SKU>48696138_S</ecom:SKU>
63                        <ecom:Name>Chiba silk bandeau top</ecom:Name>
64                        <ecom:UnitPrice>16.49</ecom:UnitPrice>
65                        <ecom:Quantity>1</ecom:Quantity>
66                        <ecom:ImageUrl>https://www.axerve.com/images/logos/logo-color-positive.svg</ecom:ImageUrl>
67                        <ecom:ProductInfoUrl>https://www.axerve.com/scarpe</ecom:ProductInfoUrl>
68                        <ecom:Type>5</ecom:Type>
69                    </ecom:ProductDetail>
70                </ecom:ProductDetails>
71            </ecom:OrderDetails>
72        </ecom:Encrypt>
73    </soap:Body>
74</soap:Envelope>

Movimentazione parziale della transazione autorizzata (1/2)

1<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ecom="https://ecomms2s.sella.it/">
2    <soapenv:Body>
3        <ecom:callSettleS2S xmlns="https://ecomms2s.sella.it/">
4            <ecom:shopLogin> --MERCHANT SHOP LOGIN HERE-- </ecom:shopLogin>
5            <ecom:apikey> --MERCHANT API KEY HERE-- </ecom:apikey>
6            <ecom:uicCode>242</ecom:uicCode>
7            <ecom:bankTransID>578</ecom:bankTransID>
8            <ecom:amount>500</ecom:amount>
9            <ecom:FullFillment>
10                <ecom:FullFillmentlst>
11                    <ecom:FullfillmentDetail>
12                        <ecom:TrackingCompany>TNT</ecom:TrackingCompany>
13                        <ecom:TrackingNumbers>TNT100</ecom:TrackingNumbers>
14                        <ecom:TrackingUrls>https://www.tnt.com/tnt100</ecom:TrackingUrls>
15                        <ecom:ProductDetails>
16                            <ecom:Description>Borsa</ecom:Description>
17                            <ecom:SKU>48696138_M</ecom:SKU>
18                            <ecom:Name>Borsa</ecom:Name>
19                            <ecom:UnitPrice>500</ecom:UnitPrice>
20                            <ecom:Quantity>1</ecom:Quantity>
21                            <ecom:ImageUrl>https://www.axerve.com/images/logos/logo-color-positive.svg</ecom:ImageUrl>
22                            <ecom:ProductInfoUrl>https://www.axerve.com/borsa</ecom:ProductInfoUrl>
23                            <ecom:Type>5</ecom:Type>
24                        </ecom:ProductDetails>
25                    </ecom:FullfillmentDetail>
26                </ecom:FullFillmentlst>
27            </ecom:FullFillment>
28        </ecom:callSettleS2S>
29    </soapenv:Body>
30</soapenv:Envelope>

Movimentazione parziale della transazione autorizzata (1/2)

1<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ecom="https://ecomms2s.sella.it/">
2    <soapenv:Body>
3        <ecom:callSettleS2S xmlns="https://ecomms2s.sella.it/">
4            <ecom:shopLogin> --MERCHANT SHOP LOGIN HERE-- </ecom:shopLogin>
5            <ecom:apikey> --MERCHANT API KEY HERE-- </ecom:apikey>
6            <ecom:uicCode>242</ecom:uicCode>
7            <ecom:bankTransID>578</ecom:bankTransID>
8            <ecom:amount>16.49</ecom:amount>
9            <ecom:FullFillment>
10                <ecom:FullFillmentlst>
11                    <ecom:FullfillmentDetail>
12                        <ecom:TrackingCompany>TNT</ecom:TrackingCompany>
13                        <ecom:TrackingNumbers>TNT200</ecom:TrackingNumbers>
14                        <ecom:TrackingUrls>https://www.tnt.com/tnt200</ecom:TrackingUrls>
15                        <ecom:ProductDetails>
16                            <ecom:Description>Scarpe</ecom:Description>
17                            <ecom:SKU>48696138_S</ecom:SKU>
18                            <ecom:Name>Chiba silk bandeau top</ecom:Name>
19                            <ecom:UnitPrice>16.49</ecom:UnitPrice>
20                            <ecom:Quantity>1</ecom:Quantity>
21                            <ecom:ImageUrl>https://www.axerve.com/images/logos/logo-color-positive.svg</ecom:ImageUrl>
22                            <ecom:ProductInfoUrl>https://www.axerve.com/scarpe</ecom:ProductInfoUrl>
23                            <ecom:Type>5</ecom:Type>
24                        </ecom:ProductDetails>
25                    </ecom:FullfillmentDetail>
26                </ecom:FullFillmentlst>
27            </ecom:FullFillment>
28        </ecom:callSettleS2S>
29    </soapenv:Body>
30</soapenv:Envelope>

Storno parziale della transazione movimentata (1/2)

1<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ecom="https://ecomms2s.sella.it/">
2    <soapenv:Body>
3        <ecom:callRefundS2S xmlns="https://ecomms2s.sella.it/">
4            <ecom:shopLogin> --MERCHANT SHOP LOGIN HERE-- </ecom:shopLogin>
5            <ecom:apikey> --MERCHANT API KEY HERE-- </ecom:apikey>
6            <ecom:uicCode>242</ecom:uicCode>
7            <ecom:bankTransactionId>578</ecom:bankTransactionId>
8            <ecom:amount>16.49</ecom:amount>
9            <ecom:settlementID>578_1</ecom:settlementID>
10            <ecom:OrderDetail>
11                <ecom:ProductDetails>
12                    <ecom:ProductDetail>
13                        <ecom:Description>Scarpe</ecom:Description>
14                        <ecom:SKU>48696138_S</ecom:SKU>
15                        <ecom:Name>Chiba silk bandeau top</ecom:Name>
16                        <ecom:UnitPrice>16.49</ecom:UnitPrice>
17                        <ecom:Quantity>1</ecom:Quantity>
18                        <ecom:ImageUrl>https://www.axerve.com/images/logos/logo-color-positive.svg</ecom:ImageUrl>
19                        <ecom:ProductInfoUrl>https://www.axerve.com/scarpe</ecom:ProductInfoUrl>
20                        <ecom:Type>5</ecom:Type>
21                    </ecom:ProductDetail>
22                </ecom:ProductDetails>
23            </ecom:OrderDetail>
24        </ecom:callRefundS2S>
25    </soapenv:Body>
26</soapenv:Envelope>

Storno parziale della transazione movimentata (2/2)

1<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ecom="https://ecomms2s.sella.it/">
2    <soapenv:Body>
3        <ecom:callRefundS2S xmlns="https://ecomms2s.sella.it/">
4            <ecom:shopLogin> --MERCHANT SHOP LOGIN HERE-- </ecom:shopLogin>
5            <ecom:apikey> --MERCHANT API KEY HERE-- </ecom:apikey>
6            <ecom:uicCode>242</ecom:uicCode>
7            <ecom:bankTransactionId>578</ecom:bankTransactionId>
8            <ecom:amount>500</ecom:amount>
9            <ecom:settlementID>578_0</ecom:settlementID>
10            <ecom:OrderDetail>
11                <ecom:ProductDetails>
12                    <ecom:ProductDetail>
13                        <ecom:Description>Borsa</ecom:Description>
14                        <ecom:SKU>48696138_M</ecom:SKU>
15                        <ecom:Name>Borsa</ecom:Name>
16                        <ecom:UnitPrice>500</ecom:UnitPrice>
17                        <ecom:Quantity>1</ecom:Quantity>
18                        <ecom:ImageUrl>https://www.axerve.com/images/logos/logo-color-positive.svg</ecom:ImageUrl>
19                        <ecom:ProductInfoUrl>https://www.axerve.com/borsa</ecom:ProductInfoUrl>
20                        <ecom:Type>5</ecom:Type>
21                    </ecom:ProductDetail>
22                </ecom:ProductDetails>
23            </ecom:OrderDetail>
24        </ecom:callRefundS2S>
25    </soapenv:Body>
26</soapenv:Envelope>

Autorizzazione della transazione

1{
2    "shopLogin": "{shopLogin}",
3    "amount": "516.49",
4    "currency": "EUR",
5    "shopTransactionID": "{shopTransactionID}",
6    "languageId": 1,
7    "paymentType":["KLARNA"],
8    "OrderDetails": {
9        "providerPageDetails": {
10            "LogoUrl": "https://www.axerve.com/images/logos/logo-color-positive.svg",
11            "BackgroundUrl": "https://www.axerve.com/images/logos/logo-color-positive.svg",
12            "BackgroundWidth": 100,
13            "PageTitle": "Completa il pagamento",
14            "PrivacyUrl": "https://www.google.it",
15            "TermsAndCondsUrl": "https://www.google.it"
16          },
17        "CustomerDetail": {
18            "FirstName": "Test",
19            "Lastname": "Person-it",
20            "PrimaryEmail": "customer@email.it"
21        },
22        "ShippingAddress": {
23            "FirstName": "Test",
24            "Lastname": "Person-it",
25            "StreetName": "Via Enrico Fermi 150",
26            "City": "Roma",
27            "ZipCode": "00146",
28            "CountryCode": "IT",
29            "Email": "customer@email.it",
30            "PrimaryPhone": "+393339741231",
31            "ShippingMethod": "STORE"
32        },
33        "BillingAddress": {
34            "FirstName": "Test",
35            "Lastname": "Person-it",
36            "StreetName": "Via Enrico Fermi 150",
37            "City": "Roma",
38            "ZipCode": "00146",
39            "CountryCode": "IT",
40            "Email": "customer@email.it",
41            "PrimaryPhone": "+393339741231",
42            "ShippingMethod": "STORE"
43        },
44        "ProductDetails": [
45            {
46                "Description": "Borsa",
47                "SKU": "48696138_M",
48                "Name": "Borsa",
49                "UnitPrice": "500",
50                "Quantity": "1",
51                "ImageUrl": "https://www.axerve.com/images/logos/logo-color-positive.svg",
52                "ProductInfoUrl": "https://www.axerve.com/borsa",
53                "Type": 5
54            },
55            {
56                "Description": "Scarpe",
57                "SKU": "48696138_S",
58                "Name": "Chiba silk bandeau top",
59                "UnitPrice": "16.49",
60                "Quantity": "1",
61                "ImageUrl": "https://www.axerve.com/images/logos/logo-color-positive.svg",
62                "ProductInfoUrl": "https://www.axerve.com/scarpe",
63                "Type": 5
64            }
65        ]
66    }
67}

I campi “UnitPrice” e “Quantity” sono obbligatori, e vanno valorizzati coerentemente col carrello.

Submit

1{
2    "shopLogin": "{shopLogin}",
3    "paymentType": "KLARNA"
4}

Movimentazione della transazione

1{
2    "shopLogin": "{shopLogin}",
3    "currency": "EUR",
4    "bankTransactionID": "614",
5    "amount": "500",
6    "FullFillment": {
7        "FullFillmentlst": [
8            {
9                "TrackingCompany": "TNT",
10                "TrackingNumbers": "TNT100",
11                "TrackingUrls": "https://www.tnt.com/tnt100",
12                "ProductDetails": [
13                    {
14                        "Description": "Borsa",
15                        "SKU": "48696138_M",
16                        "Name": "Borsa",
17                        "UnitPrice": "500",
18                        "Quantity": "1",
19                        "ImageUrl": "https://www.axerve.com/images/logos/logo-color-positive.svg",
20                        "ProductInfoUrl": "https://www.axerve.com/borsa",
21                        "Type": "5"
22                    }
23                ]
24            }
25        ]
26    }
27}

Storno della transazione movimentata

1{
2    "shopLogin": "{shopLogin}",
3    "currency": "EUR",
4    "bankTransactionID": "614",
5    "amount": "16.49",
6    "settlementID": "614_0",
7    "orderDetails": {
8        "ProductDetails": [
9            {
10                "Description": "Scarpe",
11                "SKU": "48696138_S",
12                "Name": "Chiba silk bandeau top",
13                "UnitPrice": "16.49",
14                "Quantity": "1",
15                "ImageUrl": "https://www.axerve.com/images/logos/logo-color-positive.svg",
16                "ProductInfoUrl": "https://www.axerve.com/scarpe",
17                "Type": "5"
18            }
19        ]
20    }
21}

Klarna Product Type

Type Value

Description

Country Code

Note

Discount

All available countries

Negative value. Used to add a discount order line and reduces the total value of the order.

Physical article

All available countries

Physical purchase.

Shipping fee

All available countries

Used when a shipping fee is added to the order.

Digital article

All available countries

Intangible purchase, like a license.

Gift Card

All available countries

It can take either a positive or negative value.

When used with a negative sign it is used to reduce the order total to be paid with Klarna when using a giftcard for part of the order.

When used with a positive sign to indicate that the user is purchasing a giftcard using Klarna.

Store credit

All available countries

Negative value. Used to reduce the order total to be paid with Klarna when using an in-store credit to settle a part of the order.

Gestire un esito negativo sulla pagina di Klarna

Se il numero di telefono non viene inviato nella richiesta di pagamento e se sulla pagina di Klarna l’acquirente inserisce dettagli non corretti per questo parametro, viene mostrata la pagina con esito negativo, senza la possibilità di reinserire i dati. Quanto appena descritto non è replicabile in sandbox.

Credenziali per l’ambiente di test

Prima di inviare i campi richiesti nella chiamata verso il metodo di pagamento, è necessario richiedere le credenziali per l'ambiente di Sandbox all'assistenza tecnica (credenziali valide per tutti i metodi di pagamento) e l’abilitazione all’utilizzo di Klarna (onboarding su Orchestra).

Rimborso parziale

È possibile procedere con un rimborso parziale o totale in due modi:

direttamente dal backoffice del merchant
utilizzando CallRefundS2S, una chiamata server-to-server

Gestione delle dispute e relative commissioni di Klarna

La policy di Klarna prevede che il Merchant, in qualità di fornitore di beni e/o servizi, sia responsabile della risoluzione delle eventuali dispute sollevate dal cliente. La gestione delle dispute avviene all’interno del Merchant Portal di Klarna: per maggiori informazioni, consultare il sito dedicato di Klarna external link .

Le tempistiche previste per la risoluzione delle diverse tipologie di dispute sono riportate di seguito:

*A partire dalla data di restituzione fornita a Klarna dal cliente. Se la data di restituzione è inferiore a 21 giorni, la data di escalation verrà automaticamente posticipata di 21 giorni dalla data di restituzione.

Se una disputa non dovesse risolversi entro le tempistiche indicate, il servizio clienti di Klarna interverrà per permettere alle parti di raggiungere un accordo. Tale intervento potrebbe risultare nell’applicazione di una commissione addizionale da parte di Klarna, da addebitare retroattivamente nel caso in cui l’esito della disputa indicasse il Merchant come responsabile.

Al Merchant non verrà addebitato alcun costo per la disputa quando un cliente:

Viene ritenuto colpevole.
Non è in grado di fornire le informazioni richieste da Klarna per procedere.
Cancella la controversia di propria iniziativa.

Per maggiori informazioni sulla gestione delle dispute sui pagamenti effettuati con Klarna e sulle relative commissioni, consultare il sito dedicato di Klarna external link .

Extra Merchant Data (EMD)

In base al tipo di Ecommerce e/o servizi disponibili per i consumatori, Klarna potrebbe richiedere ulteriori informazioni relative al cliente, al commerciante e/o all'acquisto. Queste informazioni, conosciute come Extra Merchant Data (EMD), consentono a Klarna di effettuare una valutazione accurata del rischio e di migliorare i tassi di conversione per aumentare le prestazioni. Sebbene in alcuni casi la condivisione degli EMD sia opzionale, in altri casi potrebbero essere obbligatori.

È obbligatorio fornire a Klarna Extra Merchant Data nel caso in cui si operi nei seguenti settori o se si rientra nei casi d'uso specificati in tabella:

Settori e casi d'uso

EMD richiesti

Dettagli

Viaggi

air_reservation_details, train_reservation_details, bus_reservation_details, ferry_reservation_details, car_rental_reservation_details, hotel_reservation_details, trip_reservation_details

Per servizi correlati al settore dei viaggi, occorre fornire informazioni sui passeggeri e sull'itinerario tramite l'EMD applicabile per il servizio fornito.

Marketplace

marketplace_seller_info, marketplace_winner_info

Nel caso di servizi marketplace e viene creato un ordine per un sub-venditore, è necessario condividere informazioni sul sub-venditore, inclusa la categoria dei prodotti venduti e l'ID del venditore.

Biglietteria

Eventi

Nel caso di vendita di biglietti per un evento, occorre fornire informazioni sull'evento.

Informazioni cliente

customer_account_info, payment_history_full, payment_history_simple

Nel caso in cui sia prevista la registrazione al sito, L'EMD consente di identificare i clienti negli accessi successivi, per migliorare l'esperienza e anche se non hanno una cronologia di pagamenti effettuati con Klarna.

Ritiro in negozio

other_delivery_address

Nei casi di acquisto online e ritiro in negozio, è necessario inviare l'EMD per consentire un'adeguata analisi del rischio della transazione.

Maggiori informazioni sui diversi campi dati per ciascun pacchetto sono disponibili su Klarna Docs - Extra merchant data external link .

Come inviare EMD

Innanzitutto, è necessario aggiungere i dati in base alle specifiche e al proprio settore merceologico (per sapere quale settore di prodotti è adatto a te, possibile contattare il proprio Account di riferimento). Occorre anche includere gli Extra Merchant Data nella proprietà degli allegati e aggiungerli all'ordine, come appreso dalla chiamata di payment/create. L'esempio qui sotto riguarda gli ordini ricorrenti, che richiedono i dettagli dell'abbonamento e le customer_account_info.

SOAP

REST

1<ecom:OrderDetails>
2      <ecom:ProviderData>{"customer_account_info":[{"unique_account_identifier":"test@gmail.com","account_registration_date":"2017-02-13T10:49:20Z",
3        "account_last_modified":"2019-03-13T11_45_27Z"}]}</ecom:ProviderData>

1"OrderDetails": {
2    "ProviderData": "{\"event\": {\"event_name\":\"EsempioEvento",
3        \"ticket_delivery_method\":\"email\",\"ticket_delivery_recipient":\"mario rossi\"
4        \"event_company\":\"Azienda S.r.l.\",\"arena_name\":\"San Siro\",\"arena_location\":
5        {\"city\":\"Milano\"},\"start_time\":\"2024-05-15T19:55:00Z\",
6        \"end_time\":\"2024-05-15T22:55:00Z\"}}"

iDEAL

Klarna Pay Now (Sofort)