VibeFox Cardcom for OpenCart — Aide

Prérequis

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

PHP : 8.0 ou ultérieur.

HTTPS : votre boutique doit être accessible depuis Internet en HTTPS, afin que Cardcom puisse envoyer la notification de paiement.

Devise : la devise de la commande (celle dans laquelle le client achète) doit être ILS, USD, EUR ou GBP. Pour toute autre devise, le mode de paiement est masqué lors du paiement.

Compte Cardcom : pour les paiements réels, vous avez besoin d'un compte marchand Cardcom avec un numéro de terminal, un nom d'utilisateur API et un mot de passe API. Les paiements n'ont besoin que du numéro de terminal et du nom d'utilisateur API. Le mot de passe API sert uniquement aux remboursements depuis OpenCart. Le mode test fonctionne sans compte Cardcom.

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

Installation

Le téléchargement est un seul fichier zip contenant les paquets pour les deux versions d'OpenCart. Décompressez-le sur votre ordinateur. Il contient README.txt, le paquet OpenCart 3 wcp_cardcom_payment_gateway-oc3-(version).ocmod.zip et le paquet OpenCart 4 wcp_cardcom_payment_gateway.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_cardcom_payment_gateway-oc3-(version).ocmod.zip. L'extension ne comporte aucune modification OCMOD, donc Extensions > Modifications n'a pas besoin d'être actualisé. 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 et choisissez le type Payments. Repérez VibeFox Cardcom Payment Gateway 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. Activez Enable/Disable, laissez Test Mode activé et cliquez sur Save. Passez une commande de test avec la carte 4580 0000 0000 0000, une date d'expiration future quelconque et le CVV 123.

5. Pour les paiements réels, désactivez Test Mode, saisissez le Terminal Number, le API Username et l'API Password que vous a remis Cardcom, puis cliquez sur Save. Rien n'est à configurer dans le tableau de bord Cardcom : les adresses de notification et de retour sont envoyées avec chaque paiement.

OpenCart 4

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

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

3. Allez dans Extensions > Extensions et choisissez le type Payments. Repérez VibeFox Cardcom Payment Gateway, cliquez sur Install (le bouton vert +), puis sur Edit (le bouton crayon).

4. Saisissez la clé de licence, testez le paiement et saisissez les identifiants réels comme aux étapes 3 à 5 pour OpenCart 3. La page des réglages et ses champs sont identiques dans les deux versions. Seule l'URL de notification diffère (voir Notification URL).

Une nouvelle installation démarre avec le mode de paiement désactivé et le mode test activé.

Configuration

Tous les réglages se trouvent sur la page de l'extension : Extensions > Extensions > Payments > VibeFox Cardcom Payment Gateway > Edit. Les sections sont listées à gauche ; le bouton Save situé sous la liste enregistre la page entière. Au-dessus des réglages, la page affiche un avertissement tant que le mode test est activé. En mode réel, elle vous avertit lorsque le numéro de terminal ou le nom d'utilisateur API est absent (Cardcom est alors masqué lors du paiement), lorsque les champs réels contiennent le terminal de test public 1000 / CardTest1994 (Cardcom est alors aussi masqué, car aucun argent réel ne serait débité), et rappelle que sans mot de passe API les remboursements depuis OpenCart sont impossibles. Elle vous avertit également lorsque la devise par défaut de votre boutique n'est pas prise en charge. 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, Total doit être un nombre égal ou supérieur à 0, et la zone géographique ainsi que les statuts de commande doivent exister ; sinon, rien n'est enregistré. Lorsque vous enregistrez le mode réel avec des identifiants absents ou de test, les réglages sont enregistrés avec un avertissement indiquant que la passerelle reste masquée lors du paiement tant que votre propre numéro de terminal et votre nom d'utilisateur API ne sont pas saisis.

Cardcom

Enable/Disable : Enable Cardcom Payment Gateway active ou désactive le mode de paiement. Par défaut : désactivé.

Title : le nom du mode de paiement que les clients voient lors du paiement. C'est aussi le nom du mode de paiement enregistré dans la commande. Par défaut : Credit Card (Cardcom). Obligatoire.

Description : le texte affiché au client à l'étape Confirm Order, au-dessus du bouton de confirmation. Par défaut : Pay securely with your credit card via Cardcom.

Sort Order : la position de Cardcom parmi les modes de paiement lors du paiement. Laissez le champ vide ou saisissez un nombre entier.

Geo Zone : proposer Cardcom uniquement 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 du panier, dans la devise par défaut de la boutique, qu'une commande doit atteindre pour que Cardcom soit proposé. Laissez le champ vide pour proposer Cardcom quel que soit le montant.

Mode test

Le mode test utilise le terminal de test public de Cardcom 1000 (utilisateur API CardTest1994). Aucun argent réel n'est débité et aucun compte Cardcom n'est nécessaire. Carte de test : 4580 0000 0000 0000, une date d'expiration future quelconque et le CVV 123. En mode test, l'étape Confirm Order affiche aussi une ligne avec cette carte de test.

Test Mode : active le mode test (terminal 1000, aucun argent réel). Par défaut : activé. Désactivez-le pour accepter des paiements réels avec les identifiants réels ci-dessous. Les remboursements sont toujours envoyés avec les identifiants du mode dans lequel la commande a été payée.

Identifiants réels

Le numéro de terminal, le nom d'utilisateur API et le mot de passe API vous sont fournis par Cardcom avec votre compte marchand : dans le tableau de bord Cardcom, sous les réglages API, ou auprès du support Cardcom. Ces champs ne sont utilisés qu'en mode réel.

Terminal Number : votre numéro de terminal Cardcom. Il ne doit contenir que des chiffres. Si vous saisissez autre chose, les autres réglages sont enregistrés avec un avertissement et l'ancien numéro de terminal est conservé.

API Username : votre nom d'utilisateur API Cardcom (ApiName) pour ce terminal. Les espaces sont supprimés à l'enregistrement.

API Password : votre mot de passe API Cardcom. Il n'est nécessaire que pour les remboursements depuis OpenCart. Le mot de passe enregistré n'est plus jamais affiché : le champ reste vide et indique Enregistré — laisser vide pour le conserver. Ne saisissez une nouvelle valeur que pour le modifier. Pour le supprimer, cochez Clear the saved API password sous le champ et cliquez sur Save.

Page de paiement

Notification URL : Cardcom envoie les notifications de paiement (IndicatorUrl) à cette adresse. Sur OpenCart 3, elle ressemble à https://your-store/index.php?route=extension/payment/wcp_cardcom_payment_gateway/webhook, et sur OpenCart 4 à https://your-store/index.php?route=extension/wcp_cardcom_payment_gateway/payment/wcp_cardcom_payment_gateway.webhook. Elle est construite à partir de l'adresse de la vitrine de votre installation OpenCart. Cette adresse est transmise automatiquement à Cardcom avec chaque paiement, avec le numéro de commande ; il n'y a donc rien à configurer chez Cardcom. Elle doit être accessible depuis Internet en HTTPS.

Operation : ce que fait Cardcom sur la page de paiement.

Max Installments : le nombre maximum de paiements échelonnés que le client peut choisir sur la page Cardcom, de 1 à 36. 1 signifie aucun paiement échelonné. Par défaut : 1.

Commandes

OpenCart crée la commande à l'étape Confirm Order sans statut (une commande manquante). La commande ne reçoit un statut qu'une fois Cardcom ayant confirmé le paiement. Chaque champ ci-dessous liste vos statuts de commande OpenCart.

Success Order Status : le statut attribué après un paiement confirmé. Par défaut : En traitement.

On Hold (Review) Status : les paiements qui ne correspondent pas à la commande (montant, devise, absence de numéro de transaction) reçoivent ce statut et une note expliquant pourquoi. Par défaut : En attente, car OpenCart n'a pas de statut En suspens. Vous pouvez créer votre propre statut dans System > Localisation > Order Statuses et le sélectionner ici.

Refunded Status : attribué une fois le paiement entièrement remboursé depuis la page de la commande. Par défaut : Remboursé.

Avancé

Debug log : enregistre les requêtes API et les notifications dans cardcom_p_debug.log.php, dans le dossier des journaux d'OpenCart (storage/logs). Le fichier ne peut pas être ouvert depuis le web, et à partir de 5 Mo il est archivé et remplacé par un nouveau fichier. Les erreurs sont toujours enregistrées. Les identifiants, les jetons de carte et les données du titulaire de la carte ne sont jamais écrits. 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 on Uninstall : lorsqu'elle est activée, la désinstallation de l'extension supprime définitivement les réglages et les journaux. Les commandes ainsi que les transactions et remboursements Cardcom sont toujours conservés, afin que les anciennes commandes puissent être remboursées après une réinstallation. Par défaut : désactivé.

Import / Export

Export : Download JSON enregistre les réglages dans un fichier JSON. Le mot de passe API n'est pas exporté.

Import : collez un JSON exporté précédemment et cliquez sur Import pour restaurer les réglages. Le mot de passe API enregistré est conservé.

Paiement

À l'étape Payment Method, le client choisit le mode de paiement (par défaut Credit Card (Cardcom)). À l'étape Confirm Order, le client voit votre description et la mention Vous serez redirigé vers la page de paiement sécurisée de Cardcom. OpenCart crée la commande à cette étape, toujours sans statut. Lorsque le client clique sur Confirm Order, l'extension crée une page de paiement Cardcom pour le montant de la commande dans la devise de la commande et envoie le client sur cette page. La page s'ouvre en hébreu lorsque la langue de la commande est l'hébreu, sinon en anglais. Les produits de la commande sont transmis à Cardcom comme nom de produit. Le client saisit les données de sa carte et, si les paiements échelonnés sont autorisés, choisit le nombre de paiements. Sur 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, puis clique sur Confirm Order en bas de la page de paiement.

Après le paiement, le client revient dans votre boutique. La commande n'est marquée comme payée qu'une fois Cardcom ayant confirmé le paiement. Cardcom appelle l'adresse de notification, et l'extension ne retient de cet appel que le code de la page de paiement. Elle vérifie que ce code a bien été émis par votre boutique pour cette commande, puis demande à Cardcom, de serveur à serveur, le résultat réel. Si la notification arrive en retard, la même vérification est effectuée lorsque le client revient. La commande reçoit alors son statut de la façon habituelle d'OpenCart, avec les e-mails de commande habituels et la mise à jour du stock, et le client voit la page de succès de la commande OpenCart avec Votre paiement par Cardcom a bien été reçu. Si Cardcom n'a pas encore confirmé le paiement lorsque le client revient, une page Payment confirmation affiche Votre paiement est en cours de confirmation par Cardcom. Vous recevrez un e-mail dès sa confirmation. avec les boutons Check again et Back to checkout ; la notification attribue le statut de la commande dès son arrivée. Sur OpenCart 4, le navigateur n'envoie pas la session de la boutique lorsque Cardcom renvoie le client ; l'extension affiche donc d'abord une courte page qui rouvre la même adresse de retour depuis votre boutique : le client conserve son panier et sa connexion.

Si le paiement n'est pas finalisé ou si Cardcom le refuse, le client revient au paiement avec Le paiement par carte n'a pas abouti. Veuillez réessayer ou choisir un autre mode de paiement. Sur OpenCart 4, ce message s'affiche au-dessus de la page de paiement. La commande reste sans statut et le panier est conservé. Le client peut réessayer : OpenCart 3 crée une nouvelle commande à chaque affichage de l'étape Confirm Order, OpenCart 4 conserve une commande pour le paiement et la met à jour, et chaque tentative obtient une nouvelle page de paiement Cardcom. Avant la création d'une nouvelle page, les pages de paiement Cardcom ouvertes de cette commande et des autres commandes du même panier (même session client et même contenu du panier) des dernières 24 heures sont vérifiées auprès de Cardcom. Si l'une d'elles est payée, cette commande est confirmée et le client est dirigé vers la page de succès au lieu de payer deux fois. Un panier déjà payé par une autre commande n'est pas débité à nouveau : le client est dirigé vers la page de succès. Un refus sur une ancienne page n'affecte pas une tentative plus récente.

Si la commande du paiement a été fermée entre-temps sans paiement (par exemple si vous l'avez annulée), Confirm Order ou le retour depuis Cardcom renvoie le client au paiement avec This order can no longer be paid. Please confirm your order again., et le prochain Confirm Order règle une nouvelle commande du panier. OpenCart 4 conserve la commande dans le paiement jusqu'à l'affichage de la page de succès : si cette commande a déjà un statut et que le panier a changé depuis (autres produits ou quantités), le client reçoit le même message, et le panier modifié reçoit une nouvelle commande avec son propre paiement, tandis que le même panier passe à la page de succès sans nouveau paiement.

Si Cardcom ne parvient pas à ouvrir la page de paiement, le client reste à l'étape Confirm Order avec un bref message au-dessus du bouton, par exemple Impossible de se connecter à Cardcom. Veuillez réessayer dans un instant. ou le message indiquant que Cardcom n'a pas pu ouvrir la page de paiement, accompagné du code Cardcom, et peut choisir un autre mode de paiement.

La notification fonctionne aussi lorsque la boutique est en mode maintenance : OpenCart 3 laisse passer les requêtes des extensions de paiement, et sur OpenCart 4 l'extension ajoute une action de démarrage qui laisse passer la notification et le retour du client.

L'extension n'accepte les paiements par carte que sur la page Cardcom. Elle ne propose ni cartes enregistrées ni paiement en un clic, ni abonnements, ne débite pas les jetons enregistrés, n'a pas de réglages de factures ou de reçus Cardcom, pas de Bit, d'Apple Pay, de Google Pay ni de PayPal via Cardcom, pas de mode iframe et pas d'accords de capture différée.

Commandes et remboursements

Statuts de commande

Aucun statut (commande manquante) : le client a été envoyé vers Cardcom et n'a pas payé, le paiement a été refusé, ou Cardcom n'a pas encore confirmé le paiement. Dans Sales > Orders, ces commandes ne sont affichées qu'avec le filtre Order Status réglé sur Missing Orders.

Success Order Status (par défaut En traitement) : le paiement a été confirmé. Une note indique la transaction Cardcom et, lorsque Cardcom les transmet, les quatre derniers chiffres de la carte, le numéro de facture et le nombre de paiements échelonnés, ainsi que la manière dont le paiement a été confirmé (notification, retour ou nouvelle tentative). Les paiements de test sont marqués Mode test : aucun argent réel n'a été débité.

On Hold (Review) Status (par défaut En attente) : Cardcom a confirmé un paiement qui ne correspond pas à la commande, par exemple un montant ou une devise différents ont été débités, ou Cardcom n'a renvoyé aucun numéro de transaction. La note l'explique, et l'onglet de la commande l'affiche sous Needs review:. Comparez le paiement dans le tableau de bord Cardcom avec la commande, puis honorez la commande ou remboursez le paiement.

Refunded Status (par défaut Remboursé) : le paiement a été entièrement remboursé via l'extension.

Si un second paiement réussi arrive pour une commande qui a déjà un statut (par exemple si le client a payé dans deux onglets du navigateur), la commande n'est pas modifiée. Une note avertit que le client a peut-être été débité deux fois et vous demande de le rembourser dans le tableau de bord Cardcom. La même note est ajoutée à la commande payée lorsque le même panier a été payé une nouvelle fois avec une autre commande (par exemple dans un second onglet) ; cette autre commande ne reçoit aucun statut.

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

Onglet VibeFox Cardcom Payment Gateway

Dans Sales > Orders, ouvrez une commande payée avec Cardcom. En bas de la page de la commande, à côté de History et Additional, l'onglet VibeFox Cardcom Payment Gateway affiche la Transaction avec une étiquette Test mode pour les paiements de test, la Payment page (LowProfileCode), le Status, la Card, les Installments, la Invoice, le Card token (avec Charge + Save token), le montant Charged, le Order total / refunded, le formulaire de remboursement, l'historique des remboursements et les Cardcom notes de la commande. L'onglet est affiché aux utilisateurs qui ont accès à l'extension.

Remboursements

Dans l'onglet, saisissez le Amount (le montant non encore remboursé est prérempli), éventuellement un Reason (optional), puis cliquez sur Refund via Cardcom. Confirmez la question Refund this amount through Cardcom? This cannot be undone. Les remboursements totaux et partiels sont pris en charge, et plusieurs remboursements partiels peuvent être effectués pour une même commande. Vous devez avoir le droit de modifier l'extension (réglé dans System > Users > User Groups). Les remboursements sont effectués dans le montant et la devise débités par Cardcom : après un écart de montant ou de devise, vous pouvez donc rembourser jusqu'au montant réellement payé par le client, et non jusqu'au total de la commande. Le remboursement est envoyé avec les identifiants du mode dans lequel la commande a été payée : les commandes de test sont remboursées sur le terminal de test Cardcom, même après être passé en mode réel, et les commandes réelles utilisent toujours vos identifiants réels. Les remboursements réels nécessitent l'API Username et l'API Password. Si Cardcom 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 la transaction de remboursement Cardcom et le motif. Un remboursement total place la commande au Refunded Status sans prévenir le client et sans remettre les produits en stock, comme un changement de statut manuel. Un remboursement partiel ne modifie pas le statut.

Les retours de produits dans Sales > Returns ne renvoient pas d'argent via Cardcom. Les remboursements effectués dans le tableau de bord Cardcom ne sont pas signalés à la boutique.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox Cardcom Payment Gateway est le premier bloc de Extensions > Extensions > Payments > VibeFox Cardcom Payment Gateway > 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 jusqu'à laquelle la licence est active 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-cardcom et le lien Manage licenses and domains in your account, qui ouvre votre compte vibefox.net. Seuls les utilisateurs administrateurs disposant du droit Modify pour 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 Clé introuvable, Cette clé appartient à un autre produit, Limite de domaines atteinte ou Licence expirée le 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 issue de la configuration d'OpenCart. Retirer la clé de la boutique ne libère pas son emplacement de domaine. Libérez l'emplacement dans votre compte vibefox.net.

Sans clé active, Cardcom n'est pas affiché aux clients lors du paiement. Si un paiement est tout de même lancé, le client voit Ce mode de paiement n'est pas disponible. Veuillez en choisir un autre. Un utilisateur administrateur connecté à l'administration dans le même navigateur voit encore le mode de paiement dans la boutique, marqué (non licencié — visible uniquement pour les administrateurs), afin que vous puissiez configurer et tester l'extension avant d'acheter une clé. Sur OpenCart 4, cet aperçu n'est pas disponible : la boutique ne voit pas la connexion à l'administration, 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 paiements déjà lancés sont toujours confirmés, et les remboursements fonctionnent.

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é automatiquement lorsque vous ouvrez le Dashboard de l'administration ou la page Edit : 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

Cardcom n'apparaît pas lors du paiement : vérifiez que la licence est active, que Enable/Disable est activé et que la devise du client est ILS, USD, EUR ou GBP. En mode réel, vérifiez que Terminal Number et API Username sont renseignés avec vos propres identifiants, et non avec le terminal de test 1000 / CardTest1994. La page des réglages affiche un avertissement lorsqu'un élément manque. Vérifiez aussi que l'adresse de paiement se trouve 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 sans statut : Cardcom n'a pas pu atteindre votre boutique, par exemple à cause d'un pare-feu, d'une protection par mot de passe ou d'un site de développement local. L'adresse de notification doit être accessible depuis Internet en HTTPS. La commande reçoit aussi son statut lorsque le client revient dans la boutique après le paiement. Activez le Debug log et consultez le champ Log sur la page de l'extension.

La notification répond Missing or invalid lowprofilecode ou Unknown lowprofilecode for this order : l'appel ne contenait pas de code de page de paiement émis par votre boutique pour cette commande. Rien n'est modifié.

La notification répond Gateway not configured ou Indicator check failed : les identifiants du mode dans lequel la page de paiement a été créée sont absents, ou Cardcom n'a pas pu être contacté pour la vérification. Rien n'est modifié ; le paiement est vérifié à nouveau lorsque le client revient dans la boutique.

La notification répond Busy, retry : la commande était en cours de confirmation par une autre requête au même moment, ou le statut de la commande n'a pas pu être attribué. Activez le Debug log pour voir la raison.

La notification répond ReturnValue mismatch ou Terminal mismatch : Cardcom a signalé un paiement pour une autre commande ou un autre terminal. Rien n'est modifié. Vérifiez que le Terminal Number est celui de votre compte.

L'URL de notification affiche Missing or invalid lowprofilecode dans le navigateur : c'est normal. L'URL n'accepte que les appels de Cardcom.

Le client voit « Erreur de paiement : cette devise n'est pas prise en charge par Cardcom. » : la devise de la commande n'est pas ILS, USD, EUR ni GBP.

Le client voit « Le paiement par carte est temporairement indisponible. Veuillez choisir un autre mode de paiement. » : le mode réel est activé, mais le numéro de terminal ou le nom d'utilisateur API est absent, ou les champs réels contiennent le terminal de test public.

Le client voit « Ce mode de paiement n'est pas disponible. » après Confirm Order : la session de paiement ne correspond plus à la commande, ou le mode de paiement a été désactivé entre-temps. Le client recharge la page de paiement.

Le client voit une autre erreur après Confirm Order : activez le Debug log et consultez le champ Log. Les problèmes de connexion et les codes d'erreur Cardcom y sont enregistrés.

La commande est en statut de vérification après le paiement : lisez les notes ou Needs review: dans l'onglet VibeFox Cardcom Payment Gateway. Le montant ou la devise payés ne correspondaient pas à la commande. Honorez la commande ou remboursez le paiement.

Aucun formulaire de remboursement dans l'onglet : l'onglet indique la raison : la transaction n'est pas encore confirmée, le paiement est entièrement remboursé, votre groupe d'utilisateurs n'a pas le droit de modifier l'extension, ou l'identifiant API ou le mot de passe API du mode du paiement sont absents.

Le remboursement échoue avec « API username and API password are required for refunds » : saisissez l'API Password (et l'API Username) dans les réglages, puis réessayez.

Le remboursement échoue avec « Could not connect to Cardcom » : vérifiez le tableau de bord Cardcom avant de réessayer, car le remboursement a peut-être été effectué ou non.

Pour les développeurs : l'extension déclenche les événements OpenCart cardcom_p_supported_currencies, qui étend la liste des devises (n'ajoutez que les devises activées sur votre terminal Cardcom), et cardcom_p_low_profile_params, qui modifie les paramètres de la page de paiement avant sa création.

Désinstallation

Allez dans Extensions > Extensions, choisissez le type Payments et cliquez sur Uninstall (le bouton rouge −) à côté de VibeFox Cardcom Payment Gateway. 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 Orders, qui reviennent à leurs valeurs par défaut lors d'une réinstallation. L'événement OpenCart de l'extension est aussi supprimé (sur OpenCart 4, ses événements et son action de démarrage, qui laisse passer Cardcom en mode maintenance). Si Delete on Uninstall est activé, les autres réglages de la passerelle (titre, description, mode test, identifiants, options de la page de paiement, journalisation) et le journal sont supprimés. S'il est désactivé, ils sont conservés pour une réinstallation ultérieure. Les transactions et les remboursements Cardcom sont toujours conservés, de sorte que les commandes payées auparavant peuvent encore être remboursées après une réinstallation. Les commandes existantes conservent leurs notes de paiement.

Sur OpenCart 4, pour supprimer aussi les fichiers de l'extension, allez dans Extensions > Installer après la désinstallation et cliquez sur Uninstall (le bouton orange −) à côté de VibeFox Cardcom Payment Gateway dans la liste des extensions installées, puis sur Delete (le bouton corbeille rouge) pour supprimer le paquet envoyé.

Cardcom est une marque déposée de son propriétaire. Cette extension n'est ni affiliée à Cardcom, ni approuvée par Cardcom.