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?
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 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
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
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
OrderDetails.CustomerDetail.FirstName
65
Customer First Name
OrderDetails.CustomerDetail.Lastname
65
Customer Last Name
Product Details
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
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/, il buyer sarà in grado di monitorare tutti gli step della spedizione direttamente dall'app Klarna.
Order Details
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
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
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 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.
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.
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:
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.
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.
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