Integration Types
Altre funzionalità
Card Payments
Mobile Wallets
Alternative Payment Methods
Resources
Klarna Pay Now è una modalità di pagamento immediata offerta da Klarna AB, una famosa banca svedese, ai paganti in Europa. I paganti possono pagare tramite bonifico bancario, addebito diretto o qualsiasi carta.
Klarna Pay Now è supportato nel Mastercard Gateway. In questa pagina vengono descritti i dettagli specifici dell'integrazione di Klarna Pay Now. Si consiglia di leggere le Linee guida per l'integrazione per il pagamento tramite browser prima di creare un'integrazione Klarna Pay Now.
Per offrire Klarna Pay Now tramite il Mastercard Gateway,
Klarna Pay Now supporta le transazioni provenienti da più paesi con le rispettive valute.
Paese | Valuta |
---|---|
Austria (AUT) | EUR |
Belgio (BEL) | EUR |
Germania (DEU) | EUR |
Italia (ITA) | EUR |
Paesi Bassi (NLD) | EUR |
Svezia (SWE) | SEK |
Spagna (ESP) | EUR |
Svizzera (CHE) | CHF |
L'integrazione di Hosted Checkout consente di raccogliere i dettagli di pagamento dal pagante tramite un'interazione ospitata e visualizzata dal gateway.
A partire dalla versione 65 dell'API, Klarna Pay Now è 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 la modalità di pagamento Klarna Pay Now sulla propria pagina di checkout.
Klarna Pay Now è supportato a partire dalla versione 63 di DirectAPI.
Effettuare un richiesta Initiate Browser Payment
in cui sourceOfFunds.type = KLARNA_PAY_NOW
e browserPayment.operation = PAY
(l'operazione Authorize non è supportata da Klarna Pay Now).
A partire dalla versione 65 dell'API, utilizzare il campo bankAccountCountryCode
. Questo campo specifica il paese in cui sono situati i conti correnti bancari dei paganti.
{ "apiOperation":"INITIATE_BROWSER_PAYMENT", "billing":{ "address":{ "city":"Edinburgh", "company":"MPGS", "country":"DEU", "postcodeZip":"EH123AB", "stateProvince":"Scotland", "street":"OceanPoint", "street2":"OceanDrive" } }, "browserPayment":{ "operation":"PAY", "returnUrl":"<your_merchant_URL>" }, "customer":{ "account":{ "id":"custoAccount" }, "dateOfBirth":"1999-12-31", "email":"john.smith@example.com", "firstName":"John", "lastName":"Smith", "mobilePhone":"01234567890", "nationalId":"X4RTBPFW4" }, "order":{ "amount":"154.16", "currency":"EUR", "item":[ { "name":"Diesel Jeans", "quantity":"1", "unitPrice":"70.83" }, { "name":"Adidas Trainers", "quantity":"1", "unitPrice":"83.33" } ] }, "shipping":{ "address":{ "city":"Shipsville", "country":"GBR", "postcodeZip":"EH67DX", "stateProvince":"Scotland", "street":"2ShippingHeights", "street2":"ShipsDrive" }, "contact":{ "email":"john.smith@example.com", "firstName":"John", "lastName":"Smith" } }, "sourceOfFunds":{ "type":"KLARNA_PAY_NOW", "provided":{ "klarnaPayNow":{ "bankAccountCountryCode":"GBR" } } } }
Per l'elaborazione dei pagamenti Klarna Pay Now, 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 di Klarna Pay Now. 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. customer.nationalId
: Questo campo è facoltativo.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 Klarna Pay Now di convalidare e visualizzare correttamente queste informazioni ai paganti e per supportare i processi di controllo del rischio e del credito di Klarna Pay Now.
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à.È necessario fornire il codice del paese del conto corrente bancario del pagante nel campo sourceOfFunds.provided.klarnaPayNow.bankAccountCountryCode.
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 da Klarna Pay Now per le pagine mostrate al pagante fornendo il campo browserPayment.preferredLanguage
nella richiesta Initiate Browser Payment. Tuttavia, per Klarna Pay Now sarà supportata solo la lingua nazionale principale del billing.address.country
o l'inglese.
Klarna Pay Now è a rischio di chargeback. Se i paganti contestano con esito positivo un pagamento con Klarna Pay Now, 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 Klarna Pay Now.
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 Klarna Pay Now ha assegnato a questo ordine nel campo transaction.acquirer.additionalResponseData
. Tale informazione potrebbe essere utile per comunicare direttamente con Klarna Pay Now.
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 Klarna Pay Now.