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.

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.

Balises	Obligatoire	Description
payment.amount
payment.currency		Code de la devise du paiement. Liste des paires devises/pays supportées.
buyer.title		Titre de l'acheteur
buyer.lastName		Nom de l’acheteur
buyer.firstName		Prénom de l’acheteur
buyer.birthDate
buyer.legalDocument
buyer.shippingAddress.title
buyer.shippingAdress.lastName
buyer.shippingAdress.phone
buyer.shippingAdress.email
buyer.shippingAdress.street1		Nom de la rue de la livraison
buyer.shippingAddress.street2
buyer.shippingAdress.cityName		Nom de la ville de livraison
buyer.shippingAdress.zipCode		Code postal de la livraison
buyer.shippingAdress.country		Pays de la livraison (ISO 3166-1)
buyer.shippingAdress.phone		Téléphone de l'acheteur
buyer.billingAddress.title
buyer.billingAddress.firstName
buyer.billingAddress.lastName
buyer.billingAddress.phone
buyer.billingAddress.email
buyer.billingAdress.street1		Nom de la rue de facturation
buyer.billingAddress.street2
buyer.billingAdress.cityName		Nom de la ville de facturation
buyer.billingAdress.zipCode		Code postal de la facturation
buyer.billingAdress.country		Pays de la facturation (ISO 3166-1)
languageCode		Code de la langue (ISO 639-1)
order.ref
order.taxes		Montant taxes TTC. Taux de TVA appliqué à l'article.  Pour information : une TVA > 100% est interdite.
order.country
order.details		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	Obligatoire	Description
orderDetail.comment		Description d'un article.
orderDetail.price		Prix unitaire TVA comprise de l'article.
orderDetail.quantity		Quantité de l'article.
orderDetail.additionalData avec la clé "discountRate"		Taux de réduction. par exemple : <obj:additionalData>discountRate=0.0;flags=32</obj:additionalData>
orderDetails.additionalData avec la clé "imageURL"		URL de l'image de l'article
orderDetail.additionnalData avec la clé "GTIN"		Numéro d'article : The product's Global Trade Item Number (GTIN)
orderDetail.additionnalData avec la clé "MPN"		Numéro du fabricant : The product's Manufacturer Part Number (MPN)
orderDetail.additionnalData avec la clé "productUrl"		URL du produit : URL to the product that can be later used in communications between Klarna and the customer
orderDetail.taxRate		Taux de la taxe
orderDetail.ref		Référence.
orderDetails.brand		Marque.
orderDetails.category		Catégorie.

  Les montants de commande, de la transaction et de la somme des Articles doivent être identiques. Si cette contrainte n'est pas respectée, le moyen de paiement ne sera pas affiché sur le formulaire.

1. payment.amount
2. order.amount
3. order.details.details.price

  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: https://docs.klarna.com/klarna-payments/in-depth-knowledge/customer-data-requirements/

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

Pages associées