open menu
axerve docs
Pagamenti/Metodi di pagamento alternativi/Klarna (Nuovo)

Klarna Klarna

Klarna è un’azienda svedese che fornisce soluzioni di pagamento online e, una volta finalizzato un pagamento, salda subito l’esercente.

Klarna permette all’utente di pagare immediatamente oppure a rate, semplicemente fornendo l’e-mail e un indirizzo di fatturazione, senza password. L’esercente riceve subito l’intero importo, anche nel caso di pagamento a rate. In particolare, i servizi offerti sono i seguenti:

In particolare, i servizi offerti sono i seguenti: 

  • Pay Now (preferisco pagare subito in un modo sicuro)

  • Pay Later (preferisco ricevere l'ordine prima di pagarlo)

  • Financing (preferisco pagare nel tempo)

L’esercente riceve subito l’intero importo, anche nel caso di pagamento a rate.

In quali Paesi è disponibile? 

A seconda del Paese di residenza, i clienti possono accedere a diverse forme dei tre servizi offerti da Klarna:  

*I merchant hanno bisogno della Credit Broker Licence (CBL).

**In questo momento attivo solamente su alcuni merchant selezionati.

Come funziona per gli utenti? 

In fase di pagamento, l’acquirente deve inserire il numero di telefono e/o l'e-mail connessi all'account.

Questo permette di offrire ai clienti un’esperienza di acquisto estremamente veloce: il sistema, infatti, riconosce l'utente e per lui non sarà necessario inserire altri dati.

Come funziona per gli esercenti?

warning

Per poter iniziare ad accettare pagamenti con Klarna sarà sufficiente accettare le condizioni che Axerve ha riservato per i suoi clienti, firmando il contratto che abilita Axerve ad operare come Payment Facilitator. 

Soddisfatti anche i requisiti di esperienza d’uso, Klarna può essere utilizzato assieme agli altri strumenti di pagamento.

Questa forma di incasso permette di movimentare un pagamento entro 28 giorni, a differenza dei 25 giorni tipici delle carte di credito.

L'integrazione tecnica è molto semplice e simile ad un qualsiasi altro metodo di pagamento abilitabile sulla piattaforma Axerve Ecommerce Solution: è possibile usare il tag paymentType ed il valore da inserire è KLARNA.

Per approfondire l’uso del tag paymentType, è possibile accedere a Come indirizzare un cliente su un metodo di pagamento.

Tramite la Dashboard Axerve, è possibile verificare lo status di avanzamento nella fase di integrazione, controllare i movimenti dell'account Klarna, scaricare la reportistica, disporre storni e movimentazioni delle transazioni già autorizzate, modificare le informazioni di contatto del Customer Care da segnalare ai buyer.

Axerve mette a disposizione, per i clienti che lo richiedono, anche la possibilità di essere abilitati al Klarna Merchant Portal ed utilizzare il servizio di On-Site Messaging. Questo servizio permetterà di gestire e customizzare i messaggi nel sito del Merchant riguardanti le opzioni di pagamento messe a disposizione da Klarna. Per maggiori informazioni consultare il sito dedicato di Klarnaexternal link.

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

65

Billing Customer First Name

OrderDetails.BillingAddress.Lastname

65

Billing Customer Last Name

OrderDetails.BillingAddress.Company

75

Billing Company

OrderDetails.BillingAddress.StreetName

100

Billing street name. Accepts only alpha-numeric characters.

OrderDetails.BillingAddress.Email

100

Billing Customer email

OrderDetails.BillingAddress.City

50

Billing city name

OrderDetails.BillingAddress.ZipCode

50

Billing zip code

OrderDetails.BillingAddress.State

50

Billing Region or State

OrderDetails.BillingAddress.CountryCode

2

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

65

Shipping Customer First Name

OrderDetails.ShippingAddress.Lastname

65

Shipping Customer Last Name

OrderDetails.ShippingAddress.Company

75

Shipping Customer Company

OrderDetails.ShippingAddress.StreetName

75

Shipping street name. Accepts only alpha-numeric characters.

OrderDetails.ShippingAddress.Email

100

Shipping Customer email

OrderDetails.ShippingAddress.City

50

Shipping city name

OrderDetails.ShippingAddress.ZipCode

20

Shipping zip code

OrderDetails.ShippingAddress.State

50

Shipping Region or State

OrderDetails.ShippingAddress.CountryCode

2

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

OrderDetails.ShippingAddress.PrimaryPhone

30

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

65

Customer First Name

OrderDetails.CustomerDetail.Lastname

65

Customer Last Name

Product Details

Field
Max Length
Description

OrderDetails.ProductDetails[x].Description

255

Article’s description

OrderDetails.ProductDetails[x].SKU

50

Article’s Stock Keeping Unit

OrderDetails.ProductDetails[x].Name

100

Article’s name

OrderDetails.ProductDetails[x].UnitPrice

12

Article’s Unit Price

OrderDetails.ProductDetails[x].Quantity

3

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

2

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

21

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

copy
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)

copy
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)

copy
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)

copy
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)

copy
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>

Klarna Product Type

Type Value
Description
Country Code
Note

4

Discount

All available countries

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

5

Physical article

All available countries

Physical purchase.

6

Shipping fee

All available countries

Used when a shipping fee is added to the order.

8

Digital article

All available countries

Intangible purchase, like a license.

9

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.

10

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 CallRefundS2Sapi link, una chiamata server-to-server

Questa pagina è stata utile?

Precedente
previDEAL
Successiva
Klarna Pay Now (Sofort)next