Contenu
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.
Balises | Obligatoire | Description |
|---|---|---|
| payment.amount |  | |
| payment.currency | | Code de la devise du paiement. |
| 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.
payment.amountorder.amountorder.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
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. Les états retournés : La gestion des états et des codes retour sont listés ici.