Klarna

Introduction

Étant donné que Klarna propose différentes méthodes de paiement, plusieurs paymentProductId existent. Trouvez toutes les valeurs possibles dans le tableau ci-dessous.

Klarna propose une solution de paiement mondiale, permettant aux clients d'acheter maintenant et de payer plus tard.

Les options flexibles de Klarna — Payez Maintenant, Payez Plus Tard et Financement — améliorent l'expérience de paiement, augmentant les taux de conversion et la satisfaction.

En intégrant Klarna, vous offrez un processus de paiement fluide et sécurisé qui s’aligne sur les préférences des consommateurs, réduisant l'abandon de panier et augmentant les ventes.

Offrez cette expérience de paiement exceptionnelle à tous vos clients partout dans le monde :

Catégorie de méthode de paiement	Description	PaymentProductId	Disponibilité par pays
Pay Now	Combiné (Virement bancaire direct + Débit direct) & Payer par Carte	3301	Autriche Australie Belgique Canada Suisse République tchèque Allemagne Danemark Espagne Finlande France Royaume-Uni Grèce Hongrie Irlande Italie Pays-Bas Norvège Nouvelle-Zélande Pologne Portugal Roumanie Suède États-Unis
Pay Now	Virement bancaire direct uniquement Vos clients effectuent un virement à Klarna quelque temps après l'achat, mais vous recevrez les fonds immédiatement.	3304	Autriche Belgique Suisse Allemagne Danemark Espagne Finlande Pays-Bas Suède
Pay Now	Débit direct uniquement Klarna débite le compte bancaire de votre client quelque temps après l'achat, mais vous recevrez les fonds immédiatement.	3305	Autriche Allemagne Pays-Bas Suède
Pay Later	Payer dans 30 jours Vos clients paieront après l'achat, mais vous recevrez les fonds immédiatement.	3302	Autriche Australie Belgique Suisse Allemagne Danemark Espagne Finlande Royaume-Uni Grèce Hongrie Italie Pays-Bas Norvège Pologne Suède États-Unis
Pay Later B2B (Billie)	Une variante B2B de Pay Later/Pay Later (Pay in 3). Permettez à vos clients B2B de fractionner les paiements en utilisant diverses options flexibles, mais vous obtiendrez immédiatement le montant. Bien que Billie partage le même paymentProductId avec Payer Plus Tard, des différences s'appliquent. Consultez le chapitre dédié pour savoir comment intégrer Billie et traiter les transactions.	3302	Autriche Allemagne Finlande France Royaume-Uni Pays-Bas Norvège Suède
Pay in 3/4	Permettez à vos clients de fractionner les paiements en petits paiements sans intérêt. Disponible uniquement pour les marchands avec un accord contractuel spécifique avec Klarna.	-	-
Fair Financing (Instalments)	Financement (3, 6, 12, 24, 36 mois) Permettez à vos clients de fractionner les paiements sur une période de 6 à 36 mois en utilisant l'application Klarna, mais vous obtiendrez immédiatement le montant total.	3303	Autriche Canada Allemagne Espagne Finlande Royaume-Uni Italie Pays-Bas Norvège Suède États-Unis

Au cours du processus de paiement, Klarna suggère toutes les méthodes de paiement disponibles en fonction de la localisation de vos clients et de votre contrat avec Klarna.
Renseignez le champ hostedCheckoutSpecificInput.locale pour indiquer la localisation et la langue parmi toutes les valeurs proposées par Klarna. Veuillez noter les points suivants :

Klarna propose différentes localisations/langues par rapport à notre Hosted Checkout Page .
Si vous envoyez une langue non disponible sur notre plateforme, la Hosted Checkout Page est traduite en anglais. Vous pouvez éviter la redirection intermédiaire vers notre plateforme : Envoyez directement vos clients au portail Klarna en utilisant la propriété paymentProductFilters.restrictTo.products.

Optimisé pour Desktop Tablet Mobile

Aperçu

Groupe de paiement :

Échéance

Identifiant du moyen de paiement:

3301

Avantages clés

Exigences PCI faibles
Paiement garanti
Grande variété de méthodes de paiement pour s'adapter aux préférences de vos clients

Pays & devises

Pays pris en charge

Autriche
Belgique
Danemark
Finlande
France
Allemagne
Irlande
Italie
Pays-Bas
Norvège
Pologne
Portugal
Espagne
Suède
Suisse
Royaume-Uni

Afficher tout

Devises prises en charge

Danish krone (DKK)
Euro (EUR)
Norwegian krone (NOK)
Polish zloty (PLN)
Pound sterling (GBP)
Swedish krona/kronor (SEK)
Swiss franc (CHF)

Intégration

Redirigez vos clients vers le portail de paiement Klarna via notre Hosted Checkout Page. Retrouvez une vue d'ensemble dans le chapitre "Cinématique".

Ajoutez les paramètres suivants à une demande standard de CreateHostedCheckout :

{
   "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":3301
   }
}

Propriétés	Remarques
order.customer.contactDetails emailAddress phoneNumber	L'adresse e-mail/le numéro de téléphone de votre client.
order.shipping.address.name name title firstName surname street houseNumber zip city countryCode	L'adresse de livraison de votre client.
order.customer personalInformation name title firstName surname dateOfBirth	Les informations personnelles de votre client.
hostedCheckoutSpecificInput.locale	La version linguistique de notre Hosted Checkout Page et du portail Klarna. Sachez que Klarna prend en charge différentes langues par rapport à notre Hosted Checkout Page.
billingAddress street houseNumber zip city countryCode	L'adresse de facturation de votre client.
shoppingCart.items amountOfMoney currencyCode amount invoiceData.description orderLineDetails productName discountAmount productCode productPrice productType quantity taxAmount unit	Le contenu du panier sous forme de tableau d'objets items. amountOfMoney.amount : Le montant total des items, calculé comme orderLineDetails.productPrice X orderLineDetails.quantity. Assurez-vous de calculer la valeur de order.amountOfMoney.amount en additionnant toutes les instances de shoppingCart.items.amountOfMoney.amount .
.hostedCheckoutSpecificInput.returnUrl	returnUrl : L'URL vers laquelle nous redirigeons vos clients après la finalisation du paiement.
redirectPaymentMethodSpecificInput.paymentProductId	L'identifiant numérique de la méthode de paiement sur notre plateforme. Il instruit notre plateforme d'envoyer vos clients directement au portail Klarna. En cas d'omission, notre plateforme redirige vos clients vers la Hosted Checkout Page, leur permettant de choisir ce mode de paiement ou tout autre actif dans votre compte.

Retrouvez des informations détaillées sur cet objet et ses propriétés dans notre documentation CreateHostedCheckoutAPI.

Lors du traitement des transactions avec Klarna, gardez à l'esprit les points suivants :

Klarna ne prend pas en charge les transactions de Direct Sale (autorisations et captures de données en une fois). Pour chaque commande, Klarna estime une date de livraison et émet une facture à la date convenue. Capturez la transaction après avoir envoyé les marchandises à vos clients.
Klarna vous permet d'effectuer des remboursements partiels et totaux et d'annuler une autorisation.

Cinématique

Vos clients finalisent une commande dans votre boutique et sélectionnent Klarna.
Vous envoyez cette demande CreateHostedCheckout à notre plateforme.
Vous redirigez vos clients via l'URL redirectUrl vers le portail Klarna. Ils sélectionnent leur méthode de paiement préférée et confirment la commande avec leurs identifiants.
Nous recevons le résultat de la transaction.
Nous redirigeons votre client vers votre returnUrl.
Vous demandez le résultat de la transaction depuis notre plateforme via GetHostedCheckout ou recevez le résultat via webhooks.
Si la transaction a réussi, vous pouvez livrer les biens/services.

Ce graphique montre les étapes individuelles du processus de paiement d'une transaction Klarna.

Test

Consultez nos Cas de test pour des données de test et des instructions détaillées.

Assurez-vous d'utiliser le bon endpoint et de renseigner l'URL de production dès que vous avez terminé vos tests.

Informations supplémentaires

Intégration avec Billie

Billie est une variante B2B de Payer Plus Tard/Payer Plus Tard (Pay in 3), offrant à la fois à vous et à vos clients divers avantages (c'est-à-dire des arrangements de paiement individuels, protection contre les défauts de paiement).

L'intégration est presque identique aux autres méthodes de paiement Klarna, mais nécessite d'ajouter la propriété order.customer.companyInformation.name à votre requête CreateHostedCheckout :

{
  "hostedCheckoutSpecificInput": {
    "locale": "de_DE",
    "returnUrl": "https://yourReturnUrl.com"
  },
  "order": {
    "amountOfMoney": {
      "amount": 6108,
      "currencyCode": "EUR",
      "taxAmount": 0
    },    
    "customer": {
      "type": "organization",
      "organization_entity_type": "REGISTERED_SOLE_TRADER",
      "organization_registration_id": "HRB 934855",
      "vat_id": "DE812345678",
      "companyInformation": {
        "name": "Zeta Electronics Gold GmbH"
      },
      "billingAddress": {
        "city": "Haslach im Kinzigtal",
        "countryCode": "DE",
        "houseNumber": "4",
        "street": "Tannenweg",
        "zip": "77716"        
      },
      "personalInformation": {
        "name": {
          "title": "Mr.",
          "firstName": "Wile",
          "surnamePrefix": "E.",
          "surname": "Coyote"
        }
      },
      "contactDetails": {
        "emailAddress": "test@test.de",
        "mobilePhoneNumber": "+43123456789"
      },
      "locale": "de_AT",
      "personalInformation": {
        "name": {
          "firstName": "Jack",
          "surname": "Black",
          "title": "Male"
        }
      }
    },
    "discount": {
      "amount": 0
    },
    "shipping": {
      "address": {
        "city": "Haslach im Kinzigtal",
        "countryCode": "DE",
        "houseNumber": "4",
        "name": {
          "firstName": "Test",
          "surname": "Test",
          "title": "Male"
        },
        "street": "Tannenweg",
        "zip": "77716"
      },
      "emailAddress": "test@test.de",
      "method": {
        "name": "DELIVERY"
      },
      "shippingCost": 500
    },
    "shoppingCart": {
      "items": [
        {
          "amountOfMoney": {
            "amount": 1018,
            "taxAmount": 0,
            "currencyCode": "EUR"
          },
          "invoiceData": {
            "description": "+20% Reservierung"
          },
          "orderLineDetails": {
            "productName": "+20% Reservierung",
            "productPrice": 1018,
            "productType": "+20% Reservierung",
            "quantity": 1,
            "taxAmount": 0,
            "taxRate": 0
          }
        },
        {
          "amountOfMoney": {
            "amount": 4590,
            "taxAmount": 0,
            "currencyCode": "EUR"
          },
          "invoiceData": {
            "description": "Your-description"
          },
          "orderLineDetails": {
            "productCode": "00-636234",
            "productName": "Hendrick's Gin",
            "productPrice": 4590,
            "productType": "Getränke",
            "quantity": 1,
            "unit": "Flasche",
            "taxAmount": 0,
            "taxRate": 0
          }
        }
      ]
    }
  }
}

Sachez que Billie partage le même paymentProductId=3302 avec Pay Later/Pay Later (Pay in 3).
Si l'une des propriétés spécifiques à Billie est manquante ou incorrecte, notre plateforme traitera votre requête comme une transaction standard Pay Later/Pay Later (Pay in 3).
.

Tests

Pour effectuer des transactions de test, vous devez avoir un accord avec Klarna pour utiliser Billie.
Utilisez l'exemple de JSON dans le chapitre "Intégration avec Billie" pour effectuer des tests.