Integration Types
Altre funzionalità
Card Payments
Mobile Wallets
Alternative Payment Methods
Resources
Il Finanziamento Klarna è una modalità di pagamento fornita da Klarna AB, una famosa banca svedese, ai paganti in Europa. Il Finanziamento Klarna offre un'opzione di finanziamento flessibile ai paganti quando acquistano beni online.
I paganti stipulano un accordo di finanziamento a lungo termine che prevede l'acquisto di un articolo e il relativo pagamento a rate. I paganti possono scegliere di effettuare il rimborso in sei o trentasei rate mensili uguali compresi gli interessi (se presenti), pagare un importo minimo ogni mese o pagare l'intero importo entro un mese.
Il Finanziamento Klarna è supportato nel Mastercard Gateway. In questa pagina vengono descritti i dettagli specifici dell'integrazione del Finanziamento Klarna. Si consiglia di leggere le Linee guida per l'integrazione per il pagamento tramite browser prima di creare un'integrazione Finanziamento Klarna.
Per offrire il Finanziamento Klarna tramite il Mastercard Gateway,
Il Finanziamento Klarna supporta le transazioni provenienti da più paesi con le rispettive valute.
Paese | Valuta |
---|---|
Austria (AUT) | EUR |
Germania (DEU) | EUR |
Paesi Bassi (NLD) | EUR |
Finlandia (FIN) | EUR |
Svezia (SWE) | SEK |
Norvegia (NOR) | NOK |
Gran Bretagna (GBR) | GBP |
Danimarca (DNK) | DKK |
L'integrazione di Hosted Checkout consente di raccogliere i dettagli di pagamento dai paganti tramite un'interazione ospitata e visualizzata dal Mastercard Gateway.
A partire dalla versione 62 dell'API, il Finanziamento Klarna è automaticamente disponibile come modalità di pagamento dopo che il your payment service provider ha abilitato e configurato l'esercente per questa modalità di pagamento.
Per ulteriori dettagli, vedere Pagamenti tramite browser mediante integrazione Hosted Checkout.
L'integrazione di Direct Payment consente di offrire il Finanziamento Klarna sulla propria pagina di checkout.
Il Finanziamento Klarna è supportato a partire dalla versione 61 di DirectAPI.
Effettuare un richiesta Initiate Browser Payment
in cui sourceOfFunds.type = KLARNA_FINANCING
e browserPayment.operation = PAY
(l'operazione Authorize non è supportata dal Finanziamento Klarna).
{ "apiOperation":"INITIATE_BROWSER_PAYMENT", "browserPayment":{ "operation":"PAY", "returnUrl":"<your_merchant_URL>" }, "customer":{ "email":"john.smith@example.com", "firstName":"John", "lastName":"Smith", "mobilePhone":"01234567890" }, "billing":{ "address":{ "street":"10 Upper Bank Street", "postcodeZip":"E14 5NP", "city":"London", "country":"GBR" } }, "order":{ "amount":99.2, "currency":"GBP", "item":[ { "name":"Blue Jeans", "quantity":"1", "unitPrice":70.83, "unitDiscountAmount":48.16, "unitTaxAmount":4.53, "detail":{ "unitTaxRate":0.2 } }, { "name":"Red Shirt", "quantity":"1", "unitPrice":20.83, "unitTaxAmount":4.17, "detail":{ "unitTaxRate":0.2 } }, { "name":"Leather Belt", "quantity":"1", "unitPrice":25, "unitTaxAmount":5, "detail":{ "unitTaxRate":0.2 } }, { "name":"Baseball Cap", "quantity":"1", "unitPrice":10, "unitTaxAmount":2, "detail":{ "unitTaxRate":0.2 } }, { "name":"Shipping and Handling", "quantity":"1", "unitPrice":4.17, "unitTaxAmount":0.83, "detail":{ "unitTaxRate":0.2 } } ] }, "sourceOfFunds":{ "type":"KLARNA_FINANCING" } }
Per l'elaborazione del Finanziamento Klarna, in una richiesta di pagamento tramite browser, oltre ai campi standard obbligatori, è necessario fornire le informazioni indicate di seguito.
Questi campi sono obbligatori, salvo diversa indicazione, e sono necessari per supportare la stima del rischio e i processi di controllo del credito del Finanziamento Klarna. Le informazioni di contatto del pagante vengono utilizzate per comunicare con il pagante e per fornire fatture elettroniche e notifiche di pagamento.
billing.address.city
billing.address.country
billing.address.postcodeZip
billing.address.street
customer.email
customer.firstName
customer.lastName
customer.mobilePhone
: questo campo è obbligatorio se customer.phone
non viene fornito. customer.phone
: questo campo è obbligatorio se customer.mobilePhone
non viene fornito. Questi campi sono obbligatori quando viene fornito un valore shipping.address.*
o shipping.contact.*
.
shipping.address.city
shipping.address.country
shipping.address.postcodeZip
shipping.address.street
shipping.contact.email
shipping.contact.firstName
shipping.contact.lastName
Fornire tutti i dettagli di ogni articolo ordinato e acquistato per consentire a Finanziamento Klarna di convalidare e visualizzare correttamente queste informazioni ai paganti e per supportare i processi di controllo del rischio e del credito del Finanziamento Klarna.
order.item[n].name
order.item[n].quantity
: il valore di questo campo deve essere un numero intero.order.item[n].unitPrice
order.item[n].unitDiscountAmount
: questo campo è obbligatorio se l'articolo è stato scontato e deve essere specificato se viene fornito un valore nel campo order.discount.amount
.order.item[n].unitTaxAmount
: questo campo è obbligatorio se un pagante è tenuto a pagare le imposte sull'articolo.order.item[n].detail.unitTaxRate
: questo campo è obbligatorio se è stato fornito un valore per l'importo dell'imposta per unità.L'importo totale dell'imposta pagabile per l'ordine viene visualizzato al pagante durante il flusso di pagamento. Se l'importo esigibile per la spedizione e il trasporto include le imposte, è necessario creare una riga dell'ordine per indicare la spedizione e il trasporto, in modo da fornire separatamente l'importo dell'imposta. Se le imposte non sono applicabili, l'importo di spedizione e trasporto può essere fornito nel campo order.shippingAndHandlingAmount
.
È possibile impostare la lingua che si desidera sia utilizzata dal Finanziamento Klarna per le pagine mostrate al pagante fornendo il campo browserPayment.preferredLanguage
nella richiesta Initiate Browser Payment. Tuttavia, per il Finanziamento Klarna sarà supportata solo la lingua nazionale principale del billing.address.country
o l'inglese.
I pagamenti con Finanziamento Klarna sono a rischio di chargeback. Se i paganti contestano con esito positivo un pagamento con il Finanziamento Klarna, verrà creata una transazione di chargeback sull'ordine. Per ulteriori informazioni, vedere transazione di chargeback.
Nella tabella che segue sono illustrati i possibili scenari per i codici di risposta della transazione restituiti dopo l'avvio di un Finanziamento Klarna.
Risposta Initiate Browser Payment |
Cosa significa... |
---|---|
response.gatewayCode=SUBMITTED result=SUCCESS |
Reindirizzare il pagante utilizzando l'URL fornito nella risposta. |
Risposta di Retrieve Transaction/Retrieve Order |
Cosa significa... |
response.gatewayCode=APPROVED result=SUCCESS |
Il pagamento è avvenuto correttamente. |
response.gatewayCode= PENDING result=PENDING |
Il Mastercard Gateway sta aspettando una notifica dall'acquirer sul risultato del pagamento. Riprovare RETRIEVE_TRANSACTION più tardi o controllare le notifiche del Mastercard Gateway. |
response.gatewayCode= CANCELLED result=FAILURE |
Il pagante ha annullato l'interazione per il pagamento. Offrire al pagante la possibilità di provare ad utilizzare un'altra modalità di pagamento. |
response.gatewayCode= DECLINED or ACQUIRER_SYSTEM_ERROR result=FAILURE |
Il pagamento è stato rifiutato. Offrire al pagante la possibilità di provare ad utilizzare un'altra modalità di pagamento. In presenza di un ACQUIRER_SYSTEM_ERROR è possibile richiedere all'acquirer il motivo dell'esito negativo del pagamento, oppure riprovare RETRIEVE_TRANSACTION . |
response.gatewayCode=TIMED_OUT result=FAILURE |
Considerare questo pagamento come rifiutato. Il Mastercard Gateway tenterà di garantire che la transazione non abbia esito positivo o revocherà la transazione. |
Per i pagamenti approvati, il Mastercard Gateway fornirà all'esercente l'ID che il Finanziamento Klarna ha assegnato a questo ordine nel campo transaction.acquirer.additionalResponseData
. Tale informazione potrebbe essere utile per comunicare direttamente con il Finanziamento Klarna.
Se si è effettuata la sottoscrizione alle notifiche webhook del Mastercard Gateway, è possibile ricevere notifiche aggiuntive con aggiornamenti su stato del finanziamento e chargeback.
Il Mastercard Gateway fornisce un simulatore di pagamento tramite browser che consente di verificare la propria integrazione con il finanziamento Klarna.