Klarna
Intro
Klarna is a leading global payment provider offering Buy Now & Pay Later options and instalment solutions.
It enables your customers to pay immediately, later, or over time while helping you enhance conversion rates and basket sizes.
Integrating Klarna ensures a seamless, secure payment process, aligning with consumer preferences and boosting sales by reducing cart abandonment.
As Klarna offer various payment methods, multiple paymentProductId exist. Find all possible values in the table below.
| Payment method category |
Description | PaymentProductId | Buyer country availability |
|---|---|---|---|
| Pay Now |
Combined (Direct Bank Transfer + Direct Debit) & Pay by Card |
3301 |
Osterreich |
| Pay Now |
Direct Bank Transfer only Your customers make a transfer to Klarna sometime after the purchase, but you will get the funds right away. |
3304 |
Osterreich |
| Pay Now |
Direct Debit only Klarna debits your customer’s bank account sometime after the purchase, but you will get the funds right away. |
3305 |
Osterreich |
| Pay Later |
Pay in 30 days Your customers will pay after the purchase, but you will get the funds right away. |
3302 |
Osterreich |
| Pay Later B2B (Billie) |
A B2B variant of Pay Later/Pay Later (Pay in 3). Allow your B2B customers to split payments using various flexible options, but you will get the right away. |
3302 |
Osterreich |
| Pay in 3/4 |
Allow your customers to split payments into smaller interest-free payments. Only available for merchants with a specific contractual agreement with Klarna. |
- |
- |
| Fair Financing (Instalments) |
Financing (3, 6, 12, 24, 36 months) Allow your customers to split payments over a 6 – 36 month-period using the Klarna app, but you will get the full amount right away. |
3303 |
Osterreich |
Während des Zahlungsvorgangs schlägt Klarna je nach dem Standort des Kunden und Ihrem Vertrag mit Klarna alle verfügbaren Zahlungsarten vor.
Füllen Sie das Feld hostedCheckoutSpecificInput.locale so aus, dass bei Ort und Sprache eine Übereinstimmung mit den Angeboten von Klarna besteht. Denken Sie an Folgendes:
- Klarna bietet andere Orte/Sprachen an als unsere Hosted Checkout Page.
- Wenn Sie eine Sprache senden, die auf unserer Plattform nicht verfügbar ist, dann wird Hosted Checkout Page ins Englische übersetzt. Sie können die zwischenzeitliche Umleitung auf unsere Plattform verhindern: Senden Sie Ihre Kunden direkt zum Klarna Portal über das Property
paymentProductFilters.restrictTo.products.
Einstieg
- Sign a contract with Klarna and receive activation credentials in return.
- Provide PAYONE with the activation credentials and the list of payment categories contractually agreed with Klarna to enable the activation of Klarna.
Integration
Über unsere Hosted Checkout Page leiten Sie Ihre Kunden weiter zum Klarna-Zahlungsportal. Im Kapitel „Zahlungsablauf“ finden Sie eine Übersicht.
Fügen Sie die folgenden Eigenschaften zu einer CreateHostedCheckout-Standardanfrage hinzu:
{
"order":{
"amountOfMoney":{
"currencyCode":"EUR",
"amount":2980
},
"shipping":{
"address":{
"name":{
"title":"Miss",
"firstName":"Road",
"surname":"Runner"
},
"street":"Neptunusstraat",
"houseNumber":"13b",
"zip":"2132JA",
"city":"Hoofddorp",
"countryCode":"NL"
}
},
"customer":{
"personalInformation":{
"name":{
"title":"Mr.",
"firstName":"Wile",
"surnamePrefix":"E.",
"surname":"Coyote"
},
"dateOfBirth":"19490917"
},
"locale":"en-NL",
"billingAddress":{
"street":"Neptunusstraat",
"houseNumber":"13b",
"zip":"2132JA",
"city":"Hoofddorp",
"countryCode":"NL"
},
"contactDetails":{
"emailAddress":"Johnia.Doe@outlook.com",
"phoneNumber":"0636469107"
}
},
"shoppingCart":{
"items":[
{
"amountOfMoney":{
"currencyCode":"EUR",
"amount":2500
},
"invoiceData":{
"description":"ACME Super Outfit"
},
"orderLineDetails":{
"productName":"ACME12",
"discountAmount":0,
"productCode":"ASO45",
"productPrice":500,
"productType":"CLOTH",
"quantity":5,
"taxAmount":0,
"unit":"piece"
}
},
{
"amountOfMoney":{
"currencyCode":"EUR",
"amount":480
},
"invoiceData":{
"description":"Asperin"
},
"orderLineDetails":{
"productName":"ASPIRIN",
"discountAmount":0,
"productCode":"ASP01",
"productPrice":480,
"productType":"MEDIC",
"quantity":1,
"taxAmount":0,
"unit":"piece"
}
}
]
}
},
"hostedCheckoutSpecificInput":{
"returnUrl":"https://yourShopUrl.com"
},
"redirectPaymentMethodSpecificInput":{
"paymentProductId":3306,
"paymentProduct3306SpecificInput":{
"extraMerchantData":"{\"subscription\":[{\"subscription_name\":\"Contact_lenses\",\"start_time\":\"2020-11-24T15:00\",\"end_time\":\"2021-11-24T15:00\",\"auto_renewal_of_subscription\":false}],\"customer_account_info\":[{\"unique_account_identifier\":\"Adam_Adamsson\",\"account_registration_date\":\"2020-11-24T15:00\",\"account_last_modified\":\"2020-11-24T15:00\"}]}"
}
}
}
| Merkmale | Anmerkungen |
|---|---|
|
order.customer.contactDetails |
Die E-Mail-Adresse/Telefonnummer Ihres Kunden |
|
shipping.address.name |
Die Lieferadresse Ihres Kunden |
|
customer |
Persönliche Daten Ihres Kunden |
|
hostedCheckoutSpecificInput.locale |
Die Sprachversion unserer Hosted Checkout Page und des Klarna-Portals. Beachten Sie, dass Klarna andere Sprachen unterstützt als unsere Hosted Checkout Page |
|
billingAddress |
Die Rechnungsadresse Ihres Kunden |
|
shoppingCart.items |
Der Inhalt des Warenkorbs als Array aus items-Objekten amountOfMoney.amount: Der Gesamtbetrag der items, berechnet als orderLineDetails.productPrice X orderLineDetails.quantity Berechnen Sie in jedem Fall den Wert order.amountOfMoney.amount durch Addieren aller Instanzen von shoppingCart.items.amountOfMoney.amount |
|
hostedCheckoutSpecificInput.returnUrl |
returnUrl: Die URL, an die wir Ihre Kunden weiterleiten, nachdem die Zahlung abgeschlossen ist |
|
redirectPaymentMethodSpecificInput.paymentProductId |
Der numerische Identifikator der Zahlungsart auf unserer Plattform. Sie weist unsere Plattform an, Ihre Kunden direkt zum Klarna-Portal weiterzuleiten. Wenn die ID fehlt, leitet unsere Plattform Ihre Kunden stattdessen auf die Hosted Checkout Page weiter, wo sie diese oder eine andere Zahlungsart in Ihrem Konto wählen können |
|
redirectPaymentMethodSpecificInput. |
Zusätzliche Informationen für Klarnas Risikoanalyse, die so genannten extra merchant data (EMD). Ausführliche Informationen zu den Spezifikationen (Mögliche Parameter und wie diese gesendet werden) im Klarnas Entwicklerportal |
Ausführliche Informationen über dieses Objekt und seine Eigenschaften finden Sie in unserer CreateHostedCheckoutAPI
When processing Klarna transactions, keep the following in mind:
- Klarna does not support direct sale transactions (authorisations and data capture in one go). For each order, Klarna estimates a delivery date and issues a due invoice at the agreed date. Capture the transaction after you have sent the goods to your customers.
- Klarna allows you to perform partial and full refunds and to cancel authorisation.
Zahlungsablauf
- Ihre Kunden schließen eine Bestellung in Ihrem Shop ab und wählen Klarna.
- Sie senden diese CreateHostedCheckout an unsere Plattform
- Sie leiten Ihre Kunden über die redirectUrl zum Klarna-Portal. Ihre Kunden wählen ihre bevorzugte Zahlungsart und bestätigen die Bestellung mit deren Daten.
- Unsere Plattform leitet Ihre Kunden um zum Klarna Portal, wo sie die Bestellung mit ihren Anmeldedaten bestätigen.
- Wir erhalten das Ergebnis der Transaktion.
- Wir leiten Ihren Kunden um zu Ihrer returnUrl.
- Sie fragen das Ergebnis der Transaktion via GetPayment bei unserer Plattform an oder Sie erhalten das Ergebnis via Webhooks.
- Wenn die Transaktion erfolgreich verlaufen ist, können Sie die Güter / Dienstleistungen ausliefern.
Testdaten
In unseren Testszenarios finden Sie Testdaten und detaillierte Instruktionen.
Stellen Sie sicher, den korrekten Endpunkt anzusteuern und zurück zum Live-Endpunkt zu wechseln, sobald Sie Ihre Tests abgeschlossen haben
Zusätzliche Informationen
Bei der Verarbeitung von Klarna-Transaktionen ist Folgendes zu beachten:
- Klarna unterstützt nicht direkte Verkaufstransaktionen (Autorisierungen und Datenerfassung in einem Durchgang). Für jede Bestellung schätzt Klarna ein Lieferdatum und sendet am vereinbarten Datum eine fällige Rechnung. Erfassen Sie die Transaktion nach dem Versand der Güter an Ihre Kunden.
- Klarna erlaubt teilweise oder vollständige Gutschriften sowie die Stornierung von Autorisierungen.
- Mind that Billie shares the same paymentProductId=3302 with Pay Later/Pay Later (Pay in 3).
- If any of the Billie-specific properties are missing or incorrect, our platform will process your request as a standard Pay Later/Pay Later (Pay in 3) transaction.
Testing
- To perform test transactions, you need to have an agreement with Klarna to use Billie.
- Use the JSON sample in the "Integration with Billie" chapter to perform tests.
Stellen Sie sicher, den korrekten Endpunkt anzusteuern und zurück zum Live-Endpunkt zu wechseln, sobald Sie Ihre Tests abgeschlossen haben