VibeFox Klarna for OpenCart — Aide

Prérequis

OpenCart : 3.0.x (testé avec la version 3.0.5.0) ou 4.0.2 et ultérieur (testé avec la version 4.1.0.3).

PHP : 8.0 ou ultérieure.

Compte marchand Klarna : vous avez besoin des identifiants API Klarna (nom d'utilisateur et mot de passe) de votre compte marchand pour une région API, ainsi que des identifiants de test du portail Klarna Playground (voir Configuration). Chaque région API dispose de ses propres identifiants. Un seul compte marchand (une région API) peut être utilisé par boutique.

Devise : une devise Klarna de votre région : EUR, SEK, NOK, DKK, GBP, CHF, PLN, CZK, HUF ou RON en Europe ; USD, CAD ou MXN en Amérique du Nord ; AUD ou NZD en Océanie. La devise doit exister dans System > Localisation > Currencies.

Clé de licence VibeFox : à acheter sur vibefox.net. Une clé fonctionne sur un seul domaine.

Installation

Le téléchargement est un fichier zip unique contenant les paquets des deux versions d'OpenCart. Décompressez-le sur votre ordinateur. Il contient README.txt, le paquet OpenCart 3 wcp_klarna_payment-oc3-(version).ocmod.zip et le paquet OpenCart 4 wcp_klarna_payment.ocmod.zip. N'installez que le paquet correspondant à votre version d'OpenCart. La clé de licence est la même pour les deux versions.

OpenCart 3

1. Dans l'administration, allez dans Extensions > Installer, cliquez sur Upload et choisissez le fichier wcp_klarna_payment-oc3-(version).ocmod.zip. L'extension ne comporte aucune modification OCMOD, il n'est donc pas nécessaire d'actualiser Extensions > Modifications. Au lieu de l'installateur, vous pouvez aussi copier le contenu du dossier upload de ce paquet dans le dossier racine de votre boutique.

2. Allez dans Extensions > Extensions, choisissez le type Payments, repérez VibeFox Klarna Payments et cliquez sur Install (le bouton vert +). Votre utilisateur administrateur doit avoir le droit de modifier la liste des extensions de paiement.

3. Cliquez sur Edit (le bouton crayon) pour ouvrir la page des réglages. Collez votre clé de licence VibeFox dans License key, dans le bloc de licence en haut de la page, puis cliquez sur Activate (voir Clé de licence).

4. Choisissez la API region de votre compte marchand Klarna.

5. Saisissez le nom d'utilisateur et le mot de passe de test du portail Klarna Playground, laissez Test mode activé, activez Enable/Disable, cliquez sur Save et passez une commande test.

6. Saisissez le nom d'utilisateur et le mot de passe de production du Klarna Merchant Portal, désactivez Test mode et choisissez le moment où les commandes sont capturées (par défaut : lorsque la commande est expédiée ou terminée).

OpenCart 4

1. Dans l'administration, allez dans Extensions > Installer, cliquez sur Upload et choisissez le fichier wcp_klarna_payment.ocmod.zip. Ne renommez pas le fichier : OpenCart 4 prend le code de l'extension dans le nom du fichier, et un paquet renommé ne fonctionne pas.

2. Le paquet apparaît dans la liste des extensions installées sur la même page. Cliquez sur Install (le bouton vert +) à côté.

3. Allez dans Extensions > Extensions et choisissez le type Payments. Repérez VibeFox Klarna Payments, cliquez sur Install (le bouton vert +), puis sur Edit (le bouton en forme de crayon).

4. Saisissez la clé de licence, la région d'API, les identifiants et le mode de capture comme aux étapes 3 à 6 pour OpenCart 3. La page de configuration et ses champs sont identiques dans les deux versions. Seule l'URL de notification est différente (voir Notifications).

Une nouvelle installation démarre avec le mode de paiement désactivé et le mode test activé. L'URL de notification est envoyée avec chaque commande Klarna : rien n'est à configurer chez Klarna.

Configuration

Tous les réglages se trouvent sur la page de l'extension : Extensions > Extensions > Payments > VibeFox Klarna Payments > Edit. Les sections sont listées à gauche ; le bouton Save situé sous la liste enregistre toute la page. Au-dessus des réglages, la page affiche TEST MODE: Klarna playground, no real payments. ou LIVE: real Klarna payments. Elle vous avertit si le nom d'utilisateur ou le mot de passe du mode actif est manquant (Klarna est alors masqué à la commande) et si la devise par défaut de la boutique n'est pas vendue par Klarna dans la région API sélectionnée. Sans le droit de modifier l'extension, la page affiche les réglages mais ne peut pas les enregistrer.

À l'enregistrement, Title ne doit pas être vide (128 caractères au maximum), Sort Order doit être un nombre entier (les nombres négatifs sont acceptés), Total doit être un nombre supérieur ou égal à 0, et la région API, le mode de capture, la zone géographique et les statuts de commande doivent être valides. Sinon, rien n'est enregistré et la page indique le champ concerné. Des identifiants manquants n'empêchent pas l'enregistrement.

Klarna Payments

Enable/Disable : active ou désactive le mode de paiement. Par défaut : désactivé. Klarna n'est affiché à la commande que si le nom d'utilisateur et le mot de passe du mode actif sont renseignés et que le pays de facturation du client fait partie d'un marché Klarna de la région API, avec un paiement dans la devise de ce pays.

Title : le nom du mode de paiement que voient les clients à la commande. C'est aussi le nom du mode de paiement enregistré dans la commande. Par défaut : Klarna. Obligatoire.

Description : le texte affiché au client à l'étape Confirm Order, au-dessus du widget Klarna. Par défaut : Pay now, later or in instalments with Klarna.

Sort Order : la position de Klarna parmi les modes de paiement à la commande. Laissez le champ vide ou saisissez un nombre entier.

Geo Zone : ne proposer Klarna que pour les adresses de paiement situées dans la zone géographique sélectionnée. Par défaut : All zones. Les zones géographiques se configurent dans System > Localisation > Geo Zones.

Total : le montant total du panier, dans la devise par défaut de la boutique, que la commande doit atteindre avant que Klarna soit proposé. Laissez le champ vide pour proposer Klarna quel que soit le montant.

Identifiants API

Les identifiants API Klarna (nom d'utilisateur et mot de passe) se créent dans le Klarna Merchant Portal, sous Settings > Klarna API credentials (la section contient les liens correspondants). Les identifiants de test proviennent du portail Playground : un pour l'Europe, un pour l'Amérique du Nord et l'Océanie. Chaque région API dispose de ses propres identifiants.

Test mode : utilise l'environnement Klarna Playground (identifiants de test, aucun paiement réel). Par défaut : activé. Tant que le mode test est activé, les clients voient TEST MODE: Klarna playground, no real payment is made. à l'étape Confirm Order. Les commandes conservent l'environnement dans lequel elles ont été passées : les captures et les remboursements des commandes Playground utilisent toujours les identifiants de test.

API region : la région de votre compte marchand Klarna. Les clients ne peuvent payer avec Klarna que depuis les pays de cette région, dans la devise de leur pays. Le pays est repris de l'adresse de paiement de la commande.

Live username (UID) : le nom d'utilisateur de l'API de production, par exemple PK12345_abcdef012345.

Live password : le mot de passe de l'API de production (secret partagé).

Test username (UID) : le nom d'utilisateur de l'API du Playground.

Test password : le mot de passe de l'API du Playground (secret partagé).

Les mots de passe enregistrés ne sont plus jamais affichés. Le champ reste vide et affiche Saved — leave empty to keep it. Ne saisissez une nouvelle valeur que pour la modifier. Pour supprimer un mot de passe enregistré, cochez Clear the saved password on save sous le champ et cliquez sur Save.

Gestion des commandes

Une commande Klarna passée est une autorisation : le client n'est débité qu'au moment de la capture de la commande. Les autorisations non capturées expirent, en général au bout de 28 jours ; expédiez donc les commandes à temps ou utilisez la capture automatique.

Capture : le moment où le client est débité. Les remboursements ne sont possibles que pour les montants capturés.

Cancellation : annule la commande Klarna (libère l'autorisation) lorsqu'une commande non encore capturée passe au statut Canceled Status ci-dessous. Par défaut : activé.

Statuts de commande

OpenCart crée la commande à l'étape Confirm Order sans statut (commande manquante). Elle ne reçoit un statut qu'après que Klarna a enregistré la commande Klarna pour l'achat approuvé dans le widget. Un achat que Klarna n'approuve pas laisse la commande sans statut, et le client reste à l'étape Confirm Order. Chaque champ ci-dessous liste vos statuts de commande OpenCart.

Order Status After Payment : Klarna a accepté l'achat (statut de fraude ACCEPTED). Le montant est autorisé puis capturé selon Capture. Par défaut : En cours.

Awaiting Fraud Review Status : Klarna a enregistré la commande comme PENDING (contrôle antifraude). Ne l'expédiez pas tant que la notification de Klarna ne l'a pas acceptée ; la commande est mise à jour automatiquement. Par défaut : En attente de paiement.

On Hold Status : Klarna a renvoyé un statut de fraude inattendu, ou le montant ou la devise communiqués par Klarna ne correspondent pas à la commande. Une note explique quoi vérifier. Par défaut : En attente de paiement.

Payment Error Status : Klarna a refusé ou arrêté l'achat après le contrôle antifraude. N'expédiez pas la commande. Par défaut : Échec.

Canceled Status : passer une commande non encore capturée à ce statut annule la commande Klarna (voir Cancellation). Klarna le définit lorsqu'il signale la commande Klarna comme annulée, expirée ou clôturée. Par défaut : Annulée.

Refunded Status : le montant capturé a été entièrement remboursé dans l'onglet Klarna de la page de la commande. Les remboursements partiels ajoutent seulement une note. Par défaut : Remboursée.

OpenCart ne propose pas de statuts propres pour un contrôle antifraude ou un paiement en attente. Vous pouvez les créer dans System > Localisation > Order Statuses et les sélectionner ici.

Notifications

Klarna communique le résultat d'un contrôle antifraude (commandes enregistrées en attente) à l'adresse indiquée dans Notification URL. Sous OpenCart 3, elle ressemble à https://your-store/index.php?route=extension/payment/wcp_klarna_payment/notification, et sous OpenCart 4 à https://your-store/index.php?route=extension/wcp_klarna_payment/payment/wcp_klarna_payment.notification. L'URL est envoyée automatiquement avec chaque commande, il n'y a donc rien à configurer chez Klarna. Le contenu de la notification n'est jamais considéré comme fiable : chaque notification est vérifiée auprès de la Klarna Order Management API, avec les identifiants de l'environnement et de la région dans lesquels la commande a été passée, et la commande Klarna doit renvoyer à ce numéro de commande. L'extension agit selon ce que Klarna signale :

Si Klarna accepte un achat après que vous avez annulé ou remboursé la commande, la commande n'est pas rouverte et l'autorisation Klarna est libérée. La notification fonctionne pendant que la boutique est en mode maintenance : OpenCart 3 laisse passer les requêtes des extensions de paiement, et sous OpenCart 4 l'extension ajoute une action de démarrage qui laisse passer la notification et le retour du client depuis Klarna.

Avancé

Debug log : enregistre les appels API et les événements de paiement dans wc_kl_debug.log.php, dans le dossier des journaux d'OpenCart (storage/logs). Le fichier ne peut pas être ouvert depuis le web. Les erreurs sont toujours enregistrées. Le journal ne contient jamais d'identifiants, de jetons d'autorisation ni de données clients. Par défaut : désactivé.

Log : affiche la taille et les dernières entrées du journal. Cliquez sur Clear log pour le vider.

Delete data on uninstall : si activé, la désinstallation de l'extension supprime les réglages de la passerelle, le journal et les sessions temporaires du widget. Les données de commande (identifiants de commande Klarna, remboursements) sont toujours conservées. Par défaut : désactivé.

Import / Export

Export : Download JSON enregistre les réglages dans un fichier JSON. Les mots de passe ne sont pas exportés.

Import : collez un JSON exporté précédemment et cliquez sur Import pour restaurer les réglages. Les mots de passe enregistrés sont conservés.

Paiement

À l'étape Payment Method, le client choisit le mode de paiement (par défaut Klarna). OpenCart crée la commande à l'étape Confirm Order, toujours sans statut. À cette étape, le client voit le logo Klarna, votre description et le widget Klarna. L'extension crée la session Klarna sur le serveur à partir de cette commande : produits avec leurs options, cartes cadeaux, livraison, réductions par coupon, bon d'achat et points de fidélité, taxes et adresses. Dans le widget, le client choisit de payer maintenant, de payer plus tard ou en plusieurs fois, selon les options proposées par Klarna. Lorsque le client clique sur Confirm Order, Klarna autorise l'achat dans le widget, et l'extension enregistre la commande Klarna côté serveur avec les données de la commande OpenCart. La commande Klarna contient le numéro de commande OpenCart comme référence marchand.

Sous OpenCart 4, le client choisit le mode de paiement avec le bouton Choose du bloc du mode de paiement, dans la fenêtre Payment method options. Le widget Klarna apparaît alors dans le bloc de confirmation de la commande en bas de la page de paiement, au-dessus du bouton Confirm Order. OpenCart 4 ne gère pas les cartes cadeaux, donc aucune n'est transmise à Klarna. Par défaut, OpenCart 4 ne demande pas d'adresse de facturation ; l'extension utilise alors l'adresse de livraison comme adresse de facturation et son pays comme pays d'achat.

Le résultat dépend du statut de fraude Klarna :

Si Klarna ne peut pas accepter la commande, le client reste à l'étape Confirm Order avec un bref message, par exemple Klarna could not accept this order. Please check your billing details or choose another payment method., Klarna did not respond. Please try again in a moment. ou, lorsque l'autorisation a expiré, une invitation à cliquer de nouveau sur « Confirm Order ». Les détails sont écrits dans le journal et la commande reçoit une note. Si le pays et la devise du client ne correspondent à aucun marché Klarna de votre région, le client voit Klarna is not available for your billing country and currency. Please choose another payment method.

Cliquer deux fois, recharger la page ou payer le même panier dans un second onglet du navigateur ne crée jamais une seconde commande Klarna (OpenCart 3 crée une nouvelle commande à chaque affichage de l'étape Confirm Order ; OpenCart 4 met à jour la commande du paiement, si bien que, après un achat refusé, le client règle la même commande). Si Klarna a approuvé l'achat mais que le statut de la commande n'a pas pu être défini, le client voit Your Klarna purchase was approved, but the order could not be completed automatically. Please contact us — do not pay again. La tentative suivante ou la notification de Klarna définit le statut à partir de la commande Klarna enregistrée, sans nouvelle autorisation. Une modification du panier, y compris une nouvelle quantité, compte comme un nouveau panier qui nécessite son propre paiement.

OpenCart 4 conserve la commande dans le paiement jusqu'à l'affichage de la page de succès. Si cette commande a été fermée sans paiement entre-temps (par exemple vous l'avez annulée), le client est renvoyé au paiement avec Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. Si la commande est déjà enregistrée et que le panier a changé, le message est Your previous order #(number) has already been placed. Your cart has changed: please confirm the new order to pay for it. Dans les deux cas, le prochain Confirm Order règle une nouvelle commande du panier. Ces messages s'affichent au-dessus de la page de paiement.

L'extension ne propose pas Klarna Checkout (KCO, remplacement complet du paiement), les boutons Klarna Express Checkout, On-site messaging ni Sign in with Klarna, ni les abonnements ou modes de paiement enregistrés, ni les captures partielles par ligne de commande. Les lignes de commande ne sont pas renvoyées à Klarna lorsque vous modifiez une commande après son passage.

Commandes et remboursements

Statuts de commande

No status (missing order) : le client n'a pas terminé l'autorisation Klarna, ou Klarna a refusé l'achat. Dans Sales > Orders, ces commandes ne s'affichent qu'avec le filtre Order Status réglé sur Missing Orders.

Order Status After Payment (default Processing) : Klarna a accepté l'achat. Une note indique l'identifiant de la commande Klarna et le moment où elle sera capturée.

Awaiting Fraud Review Status (default Pending) : l'achat est en attente du contrôle antifraude de Klarna. La notification de Klarna fait passer la commande à Order Status After Payment, Payment Error Status ou Canceled Status.

On Hold Status (default Pending) : Klarna a renvoyé un statut de fraude inattendu, ou le montant ou la devise communiqués par Klarna ne correspondent pas à la commande. La note l'explique. Vérifiez la commande dans le Klarna Merchant Portal.

Payment Error Status (default Failed) : Klarna a refusé ou arrêté l'achat après le contrôle antifraude. N'expédiez pas la commande.

Canceled Status (default Canceled) : vous avez annulé la commande, ou Klarna signale la commande Klarna comme annulée, expirée ou clôturée. Avec Cancellation activé, l'annulation d'une commande non encore capturée annule la commande Klarna et libère l'autorisation, de sorte que le client n'est pas débité. Une commande déjà capturée n'est pas annulée chez Klarna : remboursez-la pour restituer l'argent.

Refunded Status (default Refunded) : le montant capturé a été entièrement remboursé par l'intermédiaire de l'extension.

Les notes sont des entrées de l'History de la commande que le client ne voit pas. Elles commencent par le mot Klarna.

Capture

Avec When the order is shipped / completed, changer le statut d'une commande dans Sales > Orders (Add History) pour un statut terminé capture le total de la commande avant l'enregistrement du nouveau statut. Si Klarna refuse la capture, par exemple parce que le total de la commande dépasse le montant encore autorisé après une modification de la commande, le statut ne change pas, aucun e-mail n'est envoyé, et la page de la commande affiche la raison au lieu du message de réussite. Une note indique que le client n'a PAS été débité. Corrigez le problème et changez de nouveau le statut pour relancer la capture, ou capturez dans le Klarna Merchant Portal et passez Capture en manuel. Une capture réussie ajoute une note avec le montant capturé et l'identifiant de capture. Le premier statut d'une nouvelle commande et un passage d'un statut terminé à un autre statut terminé ne déclenchent aucune capture. Les captures et les annulations continuent de fonctionner tant que l'extension est installée, même désactivée. Sous OpenCart 4.1, le changement de statut refusé affiche aussi la raison sur la page de la commande ; sous OpenCart 4.0.x, le statut est également refusé, mais la raison n'apparaît que dans la note de l'historique de la commande.

Onglet VibeFox Klarna Payments

Dans Sales > Orders, ouvrez une commande payée avec Klarna. En bas de la page de la commande, à côté de History et Additional, l'onglet VibeFox Klarna Payments affiche l'identifiant de la commande Klarna avec son environnement et sa région, une étiquette Playground pour les commandes de test, le statut de fraude et le statut Klarna, le montant Authorized, les montants Captured / refunded, le formulaire de remboursement, l'historique des remboursements et les Klarna notes de la commande. L'onglet est affiché aux utilisateurs qui ont accès à l'extension.

Remboursements

Dans l'onglet VibeFox Klarna Payments, saisissez le Amount (le montant non encore remboursé est prérempli), éventuellement une Reason (optional), puis cliquez sur Refund via Klarna. Confirmez la question Refund this amount through Klarna? This cannot be undone. Les remboursements totaux et partiels sont pris en charge pour les montants capturés, dans la limite de ce que Klarna indique comme capturé moins ce qui a déjà été remboursé. Vous devez avoir le droit de modifier l'extension (défini dans System > Users > User Groups). Le remboursement est envoyé à l'environnement et à la région dans lesquels la commande a été passée, les identifiants de cet environnement doivent donc être renseignés. Si Klarna n'accepte pas le remboursement, l'onglet affiche l'erreur et aucun remboursement n'est enregistré. Un remboursement réussi est ajouté à l'historique des remboursements et aux notes, avec l'identifiant du remboursement Klarna. Un remboursement total fait passer la commande à Refunded Status sans prévenir le client et sans remettre les produits en stock, comme un changement manuel de statut. Un remboursement partiel ne modifie pas le statut. Un remboursement relancé n'est jamais effectué deux fois.

Une commande non encore capturée ne peut pas être remboursée : annulez-la à la place pour libérer l'autorisation. Avec Capture en manuel, la boutique ne sait pas ce que vous avez capturé dans le Klarna Merchant Portal. Le formulaire de remboursement s'affiche alors avec un montant vide, et Klarna vérifie le montant lors de l'envoi.

Les retours produits dans Sales > Returns ne renvoient pas d'argent via Klarna. Les remboursements effectués dans le Klarna Merchant Portal ne sont pas ajoutés à l'onglet, mais ils sont comptés dans le montant que Klarna autorise encore à rembourser.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox Klarna Payments est le premier bloc de Extensions > Extensions > Payments > VibeFox Klarna Payments > Edit, au-dessus des réglages. Collez la clé dans License key et cliquez sur Activate. Ensuite, le bloc affiche la clé masquée, le statut (par exemple la date de fin de validité de la licence et votre domaine), ainsi que les boutons Check now pour vérifier à nouveau le statut, Change key pour saisir une autre clé et Remove key pour retirer la clé de cette boutique. En dessous figurent la ligne Product: opencart-payment-klarna et le lien Manage licenses and domains in your account, qui ouvre votre compte vibefox.net. Seuls les utilisateurs administrateurs disposant du droit Modify sur l'extension peuvent modifier la clé. Les textes du bloc suivent la langue de l'administration (l'anglais et le russe sont inclus).

Si la clé n'est pas acceptée, le bloc indique la raison, par exemple Key not found, This key belongs to another product, Domain limit reached ou License expired on suivi d'une date. Après un changement d'adresse de la boutique, ou après avoir libéré un emplacement de domaine dans votre compte, cliquez sur Check now. Si le serveur de licences est injoignable, l'extension continue de fonctionner avec le dernier statut connu.

Une clé fonctionne sur un seul domaine : l'adresse de la boutique dans la configuration d'OpenCart. Retirer la clé de la boutique ne libère pas son emplacement de domaine. Libérez-le dans votre compte vibefox.net.

Sans clé active, Klarna n'est pas affiché aux clients à la commande. Si un paiement est lancé malgré tout, le client voit This payment method is not available. Please choose another one. Un utilisateur administrateur connecté à l'administration dans le même navigateur voit encore le mode de paiement dans la boutique, marqué (unlicensed — visible to admins only), afin que vous puissiez configurer et tester l'extension avant d'acheter une clé. Sous OpenCart 4, cet aperçu n'est pas disponible : la boutique ne voit pas la connexion administrateur, donc sans clé active le mode de paiement est masqué pour tout le monde. Après avoir ouvert une fois la page Edit, un rappel apparaît sur le Dashboard de l'administration. Fermez-le avec × pour le masquer pendant 7 jours. Les commandes existantes ne sont pas affectées : les notifications Klarna sont toujours traitées, et les commandes peuvent toujours être capturées, annulées et remboursées.

Lorsqu'une licence expire, l'extension continue de fonctionner, mais les mises à jour et le support nécessitent un renouvellement. Le statut est vérifié à nouveau automatiquement lorsque vous ouvrez le Dashboard ou la page Edit de l'administration : une fois par jour pendant les 14 premiers jours après la saisie de la clé, puis une fois par semaine. Aucune tâche cron n'est nécessaire. La désinstallation de l'extension supprime toujours la clé de licence et le statut de licence.

Dépannage

Klarna n'apparaît pas à la commande : vérifiez que la licence est active, que Enable/Disable est activé et que les identifiants du mode actif sont renseignés : nom d'utilisateur et mot de passe de test en mode test, identifiants de production en mode réel. La page des réglages affiche un avertissement lorsqu'ils manquent. Le pays de paiement du client doit être un pays Klarna de votre API region, et le paiement doit se faire dans la devise de ce pays (par exemple, un client suédois doit payer en SEK). Vérifiez aussi que l'adresse de paiement se situe dans la Geo Zone sélectionnée et que la commande atteint le Total défini dans les réglages.

Le paiement a abouti, mais la commande reste en Awaiting Fraud Review Status : l'achat est en attente du contrôle antifraude de Klarna, et la commande sera mise à jour lorsque la notification de Klarna arrivera. Vérifiez que votre boutique peut recevoir les requêtes de Klarna à la Notification URL indiquée dans les réglages, et que les identifiants de l'environnement dans lequel la commande a été passée sont toujours saisis. Activez Debug log et consultez le champ Log sur la page de l'extension.

La notification répond Not configured : les identifiants de l'environnement (test ou production) dans lequel la commande a été passée sont manquants, la notification ne peut donc pas être vérifiée. Saisissez-les. Klarna relancera la notification.

La notification répond Verification failed : la commande Klarna n'a pas pu être lue depuis la Order Management API. Klarna relancera la notification.

La notification répond Busy : la commande était en cours de mise à jour par une autre requête au même moment. Klarna relancera la notification.

La notification répond mismatch_ref ou Unknown order : la commande Klarna ne renvoie pas à cette commande, ou l'extension ne la connaît pas. La commande n'est pas modifiée.

Le widget ne se charge pas : le client voit Klarna could not be loaded. Please try again or choose another payment method. ou Klarna is not available for this purchase. Vérifiez les identifiants du mode actif ainsi que le pays et la devise du client.

Le changement de statut vers Complete ou Shipped est refusé : la capture Klarna a échoué. Lisez la raison sur la page de la commande ou dans la note. Le total de la commande dépasse peut-être le montant encore autorisé, la commande Klarna n'est peut-être pas encore acceptée, ou l'autorisation a pu expirer. Corrigez le problème et changez de nouveau le statut, ou capturez dans le Klarna Merchant Portal.

Le remboursement échoue : lisez le message dans l'onglet. La commande n'est peut-être pas encore capturée (annulez-la à la place), le montant peut dépasser ce qui reste remboursable, ou les identifiants de l'environnement de la commande peuvent être manquants.

Pas de formulaire de remboursement dans l'onglet : l'onglet indique la raison : rien n'est encore capturé, le montant capturé est entièrement remboursé, ou votre groupe d'utilisateurs n'a pas le droit de modifier l'extension.

Le client voit This order is already being paid : une autre requête pour le même achat est en cours, par exemple suite à un double clic. Patientez un instant et vérifiez si la commande a reçu un statut.

Désinstallation

Allez dans Extensions > Extensions, choisissez le type Payments et cliquez sur Uninstall (le bouton rouge −) à côté de VibeFox Klarna Payments. La clé de licence et le statut de licence de cette extension sont toujours supprimés. OpenCart supprime toujours ses propres réglages de l'extension : Enable/Disable, Sort Order, Geo Zone, Total et les statuts de commande de la section Order statuses, qui reviennent à leurs valeurs par défaut lors d'une réinstallation. Les événements OpenCart de l'extension sont aussi supprimés : les changements de statut ne capturent ni n'annulent donc plus les commandes Klarna (sous OpenCart 4, également leur action de démarrage, qui laisse passer la notification et le retour du client en mode maintenance). Si Delete data on uninstall est activé, les autres réglages de la passerelle (titre, description, mode test, région API, identifiants, capture, annulation, journalisation), le journal et les sessions temporaires du widget sont supprimés. S'il est désactivé, ils sont conservés pour une future réinstallation. Les commandes et remboursements Klarna sont toujours conservés, de sorte que les commandes passées auparavant peuvent encore être capturées et remboursées après une réinstallation. Les commandes existantes conservent leurs notes de paiement.

Sous OpenCart 4, pour supprimer aussi les fichiers de l'extension, allez dans Extensions > Installer après la désinstallation, cliquez sur Uninstall (le bouton orange −) à côté de VibeFox Klarna Payments dans la liste des extensions installées, puis sur Delete (le bouton rouge en forme de poubelle) pour supprimer le paquet téléversé.

Klarna est une marque commerciale de son titulaire. Cette extension n'est ni affiliée à Klarna ni approuvée par Klarna.