Contenu

Plus d'informations

Activer Klarna sur mon compte

Vous devez vous rapprocher de votre responsable de compte ou d'un commercial pour la création de ce moyen de paiement.
Monext Online réalise toute la configuration.

Contactez le support Monext Online.

Une fois votre le nom de l’alias du numéro de contrat créé alors le moyen de paiement est disponible.
Vous devez réaliser des transactions 'pilote' pour valider le bon fonctionnement en production.

Le code (card_code) du moyen de paiement est : KLARNA_MNXT

L'écran de configuration :

Proposer le paiement Klarna à vos acheteurs

Les principes d'utilisation

Une fois le moyen de paiement activé, il est utilisable au travers des fonctions Monext Online en indiquant le contrat du moyen de paiement Contrat_Number.
Le mode d'intégration est disponible avec l'API WebPayment : services doWebPayment et getWebPaymentDetails.

Les web services en mode Web

Interfaces de paiement : API WebPayment.
Paiement à la commande : en utilisant le service doWebPayment avec payment.mode à CPT et code Action à 101.
Mode de paiement : sélectionner votre mode de paiement : comptant avec le code Mode = CPT.
Demande d'annulation d'une autorisation non encaissée : utilisez la fonction doReset permet au marchand de demander l’annulation totale ou partielle de la commande.
Demande de remboursement d'une transaction remisée : utilisez la fonction doRefund pour rembourser la commande.
Réponse de paiement : consulter la réponse du service getWebPaymentDetails pour obtenir les informations du moyen de paiement et de l'acheteur.

Libellé sur le ticket de paiement

Vous pouvez choisir d'alimenter un libellé sur le ticket de paiement avec le champ payment.softDescriptor du service doWebPayment.

S'il est vide alors le nom d'enseigne du moyen de paiement dans le centre administration sera sélectionné.

Et si ce dernier est vide alors le nom d'enseigne du compte commerçant dans le centre administration sera sélectionné.

Les champs obligatoires

Les champs obligatoires doivent être renseignés lors de la demande de paiement, dans le cas contraire la demande sera refusée.

Les balises ci-dessous sont obligatoires dans la trame SOAP Payline lors de la demande de paiement.

Services SOAP	Services REST	Description
payment.amount	payment.amount
payment.currency		Code de la devise du paiement. Liste des paires devises/pays supportées .
buyer.title	buyer.title	Titre de l'acheteur.
buyer.lastName	buyer.lastName	Nom de l’acheteur.
buyer.firstName	buyer.firstName	Prénom de l’acheteur.
buyer.birthDate	buyer.birthDate	Date de naissance de l'acheteur.
buyer.legalDocument	buyer.legalDocument	Numéro d'identification du document officiel.
buyer.shipping	buyer.billingAddress	Adresse de livraison
buyer.shippingAddress.title
buyer.shippingAdress.lastName
buyer.shippingAdress.phone
buyer.shippingAdress.email
buyer.shippingAdress.street1
buyer.shippingAddress.street2
buyer.shippingAdress.cityName
buyer.shippingAdress.zipCode
buyer.shippingAdress.country		Pays de la livraison (ISO 3166-1).
buyer.shippingAdress.phone
buyer.billing	delivery.address	Adresse de facturation.
buyer.billingAddress.title
buyer.billingAddress.firstName
buyer.billingAddress.lastName
buyer.billingAddress.phone
buyer.billingAddress.email
buyer.billingAdress.street1
buyer.billingAddress.street2
buyer.billingAdress.cityName
buyer.billingAdress.zipCode
buyer.billingAdress.country		Pays de la facturation (ISO 3166-1).
languageCode		Code de la langue (ISO 639-1).
order.ref	order.reference	Référence de la commande donnée par le commerçant.
order.taxes	order.taxes	Montant taxes TTC. Taux de TVA appliqué à l'article. Pour information : une TVA > 100% est interdite.
order.country	order.country	Pays de la commande.
order.deliveryCharge	delivery.charge	Frais de transport. RELEASE 24.9
order.discountAmount	order.discount	Somme des discount tag=total_discount_amount de additionalData. RELEASE 24.9
order.details	items	Détail d'une commande.

La liste des balises ci-dessous présente le détail des articles d'une commande KLARNA y compris les frais de transport et les frais de manutention :

Services SOAP	Services REST	Description
orderDetail.comment	items.comment	Description d'un article.
orderDetail.price	items.price	Prix unitaire TTC avec TVA comprise dans le prix de l'article.
orderDetail.quantity	items.quanbtity	Quantité de l'article.
orderDetail.additionalData avec la clé "total_discount_amount"	items.miscellanneous.total_discount_amout	Taux de réduction. Par exemple 20,00 € : <obj:additionalData>total_discount_amount=2000</obj:additionalData>
orderDetails.additionalData avec la clé "imageURL"	items.miscellanneous.imageURL	URL de l'image de l'article.
orderDetail.additionnalData avec la clé "GTIN"	items.miscellanneous.GTIN	Numéro d'article : The product's Global Trade Item Number (GTIN).
orderDetail.additionnalData avec la clé "MPN"	items.miscellanneous.MPN	Numéro du fabricant : The product's Manufacturer Part Number (MPN).
orderDetail.additionnalData avec la clé "productUrl"	items.miscellanneous.productUrl	URL du produit : URL to the product that can be later used in communications between Klarna and the customer.
orderDetail.additionnalData avec la clé "KlarnaMerchantData1"	items.miscellanneous.KlarnaMerchantData1	API SOAP : KlarnaMerchantData1=Data1;KlarnaMerchantData2=Data2; API REST : "miscellaneous":{"KlarnaMerchantData1":"Data1"}
orderDetail.taxRate	items.taxRate	Taux de la taxe.
orderDetail.ref	items.reference	Référence.
orderDetails.brand	items.brand	Marque.
orderDetails.category	items.category	Catégorie.

Release 24.9

Calcul des avoirs et des frais de livraison

Actuellement Monext vous propose de rajouter les frais de livraison dans un article. La prochaine version vous permettra de le rajouter dans une balise.

Les avoirs ne sont pas possibles dans cette version.

Calculs des montants RELEASE 24.9

Si les règles ci dessous ne sont pas respectées, le moyen de paiement ne sera pas affiché sur le formulaire de paiement.

Le montant de la transaction doit être égale au montant de la commande : payment.amount
Le montant de chaque article est indiqué TTC, n'inclut pas les avoirs et sans frais de livraison : order.details.details.price
Le montant des taxes est la somme des taxes des articles : order.taxes

Pour chaque article le total_tax_amount_article = (article_amount/( 100+(tax_rate_acticle/100) )*(tax_rate_acticle/100)) avec arrondi
Le montant de la commande order.amount doivent être égale à la somme du détails de la commande :
1. du prix unitaire TTC de chaque article x nombre d'article.
2. du montant des frais de livraison.
3. du montant des avoirs utilisés.
Le montant des frais de transport : order.deliveryCharge

Si les frais de transport sont envoyés sur un orderDetails alors order.taxes inclut les taxes des frais de livraison.
Si les frais de transport sont envoyés via le champ deliveryCharge, alors order.taxes n'inclut pas les taxes des frais.

Les devises et les pays déclarés dans la commande, l'adresse de livraison, l'adresse de facturation et d'adresse de l'acheteur doivent correspondre au même pays, ainsi que la langue déclarée dans la balise languageCode.

Pour plus d’information concernant les formats et champs attendus coté Klarna, veuillez consulter la page suivante: docs.klarna.com/customer-data-requirements

Exemple de panier

1 article à 90 € avec une taxe 10 % et une réduction de 15 €
2 article à 6 € chacun avec une taxe de 15% et avec une réduction de 10 €

API SOAP	API REST	Version 24.8	Version 24.9
Payment.amount		20000	20000
Order.taxes	order.taxes	2177	2177
Order.amount	order.amount	20000	18500
Order.discount	discount.amount		2500
Order.deliveryCharge	delivery.charge		1500
Article 1
Order.Details.price	order.items.price	9000	9000
Order.Details.quantity	order.items.quantity	1	1
Order.Details.taxRate	order.items.taxeRate	1000	1000
Order.Details.additionalData avec "total_discount_amount"	order.items.total_discount_amount	1500	1500
total amount		7500	7500
total_tax_amount		682	682
Article 2
Order.Details.price	order.items.price	600	600
Order.Details.quantity	order.items.quantity	2	2
Order.Details.taxRate	order.items.taxeRate	1500	1500
Order.Details.additionalData avec "total_discount_amount"	order.items.total_discount_amount	1000	1000
total amount		11000	11000
total_tax_amount		1435	1435

Exemples RELEASE 24.9

API SOAP

<impl:doWebPaymentRequest xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:impl="http://impl.ws.payline.experian.com" xmlns:obj="http://obj.ws.payline.experian.com">

    <impl:version>34</impl:version>

    <impl:payment>
      <obj:amount>18500</obj:amount>
      <obj:currency>978</obj:currency>
      <obj:action>101</obj:action>
      <obj:mode>CPT</obj:mode>
      <obj:contractNumber>0206023</obj:contractNumber>   
    </impl:payment>

    <impl:returnURL>https://monext.fr</impl:returnURL>
    <impl:cancelURL>https://google.com</impl:cancelURL>

    <impl:order>
      <obj:ref>demo123</obj:ref>
      <obj:origin>10</obj:origin>
      <obj:country>FR</obj:country>
      <obj:taxes>1901</obj:taxes>
      <obj:amount>18500</obj:amount>
      <obj:currency>978</obj:currency>
      <obj:discountAmount>3000</obj:discountAmount>
      <obj:deliveryCharge>1500</obj:deliveryCharge>
      <obj:date>28/08/2024 17:27</obj:date>

      <obj:details>   

        <obj:details>
          <obj:ref>1</obj:ref>
          <obj:price>10000</obj:price>
          <obj:quantity>1</obj:quantity>
          <obj:comment>comment</obj:comment>
          <obj:additionalData>total_discount_amount=2000;imageURL=https://monImage.fr;KlarnaMerchantData1=Data1;KlarnaMerchantData2=Data2;GTIN=4912345678904;MPN=AD6654412-334.22;productUrl=https://monImage.fr</obj:additionalData>
          <obj:quantity_unit>pcs</obj:quantity_unit>
          <obj:brand>shoe-brand</obj:brand>
          <obj:category>Shoes > Running</obj:category>
          <obj:taxRate>1000</obj:taxRate>        
          <obj:physical>123</obj:physical>
        </obj:details>     

        <obj:details>
          <obj:ref>2</obj:ref>
          <obj:price>5000</obj:price>
          <obj:quantity>2</obj:quantity>
          <obj:comment>comment</obj:comment>
          <obj:brand>shoe-brand</obj:brand>
          <obj:category>Shoes > Running</obj:category>
          <obj:quantity_unit>pcs</obj:quantity_unit>
          <obj:additionalData>total_discount_amount=1000;imageURL=https://monImage.fr;KlarnaMerchantData1=Data1;KlarnaMerchantData2=Data2;GTIN=4912345678904;MPN=AD6654412-334.22;productUrl=https://monImage.fr</obj:additionalData>
          <obj:taxRate>1500</obj:taxRate>
          <obj:physical>123</obj:physical>
        </obj:details>          

      </obj:details>   
  </impl:order>

  <impl:notificationURL>http://www.concupourvendre.com/notif/notif.php</impl:notificationURL>
  <impl:selectedContractList>
      <obj:selectedContract>0206023</obj:selectedContract>
      <obj:selectedContract>CB_1205</obj:selectedContract>
  </impl:selectedContractList>
  <impl:secondSelectedContractList>
      <obj:selectedContract>0206023</obj:selectedContract>
      <obj:selectedContract>CB_1205</obj:selectedContract>
  </impl:secondSelectedContractList>
  <impl:privateDataList>
      <obj:privateData>
        <obj:key/>
        <obj:value/>
      </obj:privateData>
  </impl:privateDataList>
  <impl:languageCode>fr</impl:languageCode>
  <impl:buyer>
   
      <obj:birthDate>1978-12-31</obj:birthDate>
      <obj:title>3</obj:title>
      <obj:legalDocument>26083006995</obj:legalDocument>
      <obj:lastName>B</obj:lastName>
      <obj:firstName>Charles</obj:firstName>
      <obj:email>john.doe@fake.id</obj:email>
      <obj:phone>0987654321</obj:phone>
         
      <obj:shippingAdress>
         <obj:firstName>John</obj:firstName>
         <obj:lastName>L</obj:lastName>
         <obj:name>L</obj:name>
         <obj:street1>Rue principale</obj:street1>
         <obj:street2>Grand batiment</obj:street2>
         <obj:cityName>Phoceenne</obj:cityName>
         <obj:zipCode>13450</obj:zipCode>
         <obj:country>FR</obj:country>
         <obj:state>BDuR</obj:state>
         <obj:county>IO</obj:county>
         <obj:title>3</obj:title>
       </obj:shippingAdress>
         
       <obj:billingAddress>
         <obj:title>5</obj:title>
         <obj:firstName>Jeremy</obj:firstName>
         <obj:lastName>M</obj:lastName>
         <obj:name>M</obj:name>
         <obj:street1>Rue truc</obj:street1>
         <obj:street2>Bat B</obj:street2>
         <obj:cityName>Trucville</obj:cityName>
         <obj:zipCode>12345</obj:zipCode>
         <obj:country>FR</obj:country>
         <obj:county>PACA</obj:county>
       </obj:billingAddress>

       <obj:ip>10.10.10.123</obj:ip>
       <obj:customerId>987654321</obj:customerId>
       <obj:fingerprintID>123</obj:fingerprintID>    
  </impl:buyer>
  <impl:securityMode>SSL</impl:securityMode> 
</impl:doWebPaymentRequest>

API REST

{
  "paymentMethod": {
    "paymentMethodIDs": [
      "Klarna"
    ]
  },
  "order": {
    "currency": "EUR",
    "origin"  : "E_COM",
    "country" : "FR",
    "reference": "Demo",
    "amount"  : 20000,
    "taxes"   :2117,

   "items": [
      {
        "miscellaneous": {
        "total_discount_amount": "1500",
        "imageURL":"https://monImage.fr",
        "KlarnaMerchantData1": "Data11",
        "GTIN":"4912345678904",
        "MPN" :"AD6654412-334.22",
        "productUrl":"https://monImage.fr"        
       },    
        "reference": "ref-1",
        "price": 9000,
        "quantity": 1,
        "comment": "bouteille d'eau",
        "brand": "badoit",
        "taxRate": 1000,
        "category": "17"
      },
      {
        "miscellaneous": {
        "total_discount_amount": "1000",
        "imageURL":"https://monImage.fr",
        "KlarnaMerchantData1": "Data21",
        "GTIN":"4912345678904",
        "MPN" :"AD6654412-334.22",
        "productUrl":"https://monImage.fr"        
      },   
        "reference": "ref-2",
        "price"   : 6000,
        "quantity": 2,
        "comment" : "bassin",
        "brand"   : "Bassin Pro",
        "taxRate" : 1500,
        "category": "11"
      }
    ]
  },
   
  "payment": {
    "paymentType": "ONE_OFF",
    "capture"    : "AUTOMATIC",
    "recurring"  : {
      "frequency": "DAILY"
    }
  },
  "buyer": {
    "legalDocument": {
      "number": "26083006995"
    },
    "legalStatus": "PRIVATE",
    "billingAddress": {
      "country": "FR",
      "title": "MR",
      "firstName": "Bill",
      "lastName": "Matt",
      "street": "Rue A",
      "complement": "Bat B",
      "city": "Aix",
      "zip": "12345",
      "county": "PACA"
    },
    "title": "MRS",
    "firstName": "Buy",
    "lastName": "Matt",
    "email": "john.doe@fake.id",
    "mobile": "0987654321",
    "birthDate": "1978-12-31"
  },
  "delivery": {
    "address": {
      "country": "FR",
      "title": "MRS",
      "firstName": "Steph",
      "lastName": "L",
      "street": "Rue B",
      "complement": "",
      "city": "Aix",
      "zip": "13450",
      "county": "PACA",
      "state": ""
    },
    "charge": 1500
  },
  "threeDS": {
    "challengeInd": "NO_PREFERENCE"
  },
         
  "oneClickOption": "WITHOUT_CVV",
  "pointOfSaleReference": "12344443546554754",
  "returnURL": "https://monext.fr"
}

Réaliser des tests

Sur l'environnement d'homologation (Test), vous êtes connecté à un simulateur vous proposant directement sur l'interface avec deux options :

Paiement accepté avec un code retour = ACCEPTED - 0000
- toutes les cartes sont acceptées.
Paiement abandonné avec un code retour = CANCELLED - 02008

Lors du paiement une page du simulateur vous propose deux boutons sur l'environnement d'homologation (TEST) : un succès (MAKE A PAYMENT) et un abandon (ABORT).

Les codes de retour

Monext Online vous informe du résultat d’un paiement via le ShortMessage, selon le mode d'intégration proposé par le moyen de paiement.

pour l'API WebPayment avec le service getWebPaymentDetails,
pour l'API DirectPayment en réponse du service doAuthorization de manière synchrone ou getTransactionDetails en réponse asynchrone.

Les états retournés :

Le paiement est accepté avec l'état ACCEPTED et le code retour 00000.
Le paiement est refusé avec l'état REFUSED. Le code varie en fonction du motif de refus (Par exemple : 01xxx pour une raison bancaire ou 04xxx pour une suspicion de fraude).

La gestion des états et des codes retour sont listés ici.

Pages associées

Page:

Intégration 3D Secure 2 en mode API WebPayment
Page:

Intégration API WebPayment
Page:

PW - Intégration Widget
Page:

PW - L'API JavaScript
Page:

PW - Personnalisation du widget : Balises CSS
Page:

PW - Personnalisation du widget : Feuille de style
Page:

PW - Personnalisation du widget : Fonction CallBack

Arborescence des pages

klarna - Intégration