VibeFox Conekta 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érieur.

Devise : la devise du paiement doit être MXN ou USD. Pour les autres devises, la méthode de paiement est masquée.

Compte Conekta : vous avez besoin des clés API privées de votre compte Conekta (test et production) et d'un webhook dans le panneau Conekta (voir Configuration). Seules les clés privées sont utilisées. La clé publique n'est pas nécessaire, car le paiement a lieu sur la page de paiement hébergée par Conekta.

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

Installation

Le téléchargement est un fichier ZIP unique contenant les paquets pour les deux versions d'OpenCart. Décompressez-le sur votre ordinateur. Il contient README.txt, le paquet OpenCart 3 wcp_conekta_gateway-oc3-(version).ocmod.zip et le paquet OpenCart 4 wcp_conekta_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_conekta_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 Conekta 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 de configuration. 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. Saisissez vos clés privées de test et de production, choisissez le mode et ajoutez le webhook dans le panneau Conekta (voir Configuration).

5. Activez Enable / Disable et cliquez sur Save. Effectuez un paiement test en mode test, puis désactivez Test mode.

OpenCart 4

1. Dans l'administration, allez dans Extensions > Installer, cliquez sur Upload et choisissez le fichier wcp_conekta_gateway.ocmod.zip. Ne renommez pas le fichier : OpenCart 4 tire le code de l'extension du 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 Conekta Gateway, cliquez sur Install (le bouton vert +), puis sur Edit (le bouton crayon).

4. Saisissez la clé de licence, les clés Conekta et le webhook comme aux étapes 3 à 5 pour OpenCart 3. La page de configuration et ses champs sont identiques dans les deux versions. Seule l'URL du webhook diffère (voir Webhook).

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

Configuration

Tous les réglages se trouvent sur la page de l'extension : Extensions > Extensions > Payments > VibeFox Conekta 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 vous avertit lorsque Conekta est activé mais que la clé privée du mode actuel est vide (la méthode de paiement est alors masquée au moment du paiement) et lorsque la devise par défaut de la boutique n'est ni MXN ni USD. Lorsque le mode test est activé, la page affiche Test mode is on: payments are simulated with the test private key. Sans le droit de modifier l'extension, la page affiche les réglages mais ne peut pas les enregistrer.

Lors de l'enregistrement, Title ne doit pas être vide, Sort Order doit être un nombre entier, Total doit être un nombre non négatif, et la zone géographique et les statuts de commande sélectionnés doivent exister. Si une vérification échoue, rien n'est enregistré et la page affiche les erreurs. Deux avertissements n'empêchent pas l'enregistrement : lorsqu'aucune méthode de paiement n'est sélectionnée (les paiements par carte sont alors proposés) et lorsque la passerelle est activée sans la clé privée du mode actuel.

Conekta

Enable / Disable : Enable Conekta payments active ou désactive la méthode de paiement. Default : off.

Title : le nom de la méthode de paiement que le client voit au moment du paiement. C'est aussi le nom de la méthode de paiement enregistré dans la commande. Default : Conekta. Obligatoire, jusqu'à 128 caractères.

Description : le texte affiché au client à l'étape Confirm Order, au-dessus du bouton de confirmation. Default : Pay securely with card, OXXO cash or SPEI transfer. Vous serez redirigé vers Conekta pour finaliser votre paiement.

Payment methods : les méthodes proposées sur la page de paiement Conekta. Default : card, cash and bank transfer. Les espèces, SPEI et BNPL ne sont disponibles que pour les commandes en MXN (les commandes en USD n'acceptent que les cartes) et doivent être activés dans votre compte Conekta. Si rien n'est sélectionné, la carte est utilisée.

Sort Order : la position de Conekta parmi les méthodes de paiement au moment du paiement. Laissez le champ vide ou saisissez un nombre entier.

Geo Zone : proposer Conekta uniquement pour les adresses de facturation situées dans la zone géographique sélectionnée. Default : All zones. Les zones géographiques se configurent dans System > Localisation > Geo Zones.

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

Clés API

Copiez vos clés privées depuis le panneau Conekta, dans Developers > API keys (la page contient un lien vers le panneau). Les clés de test et de production sont différentes.

Test mode : utilise la clé privée de test. Aucun argent réel n'est débité, et le client voit TEST MODE — No real charges will be made. à l'étape Confirm Order. Les remboursements utilisent toujours la clé du mode dans lequel le paiement a été effectué. Default : on.

Test private key : la clé API privée du mode test de votre compte Conekta.

Live private key : la clé API privée du mode production de votre compte Conekta. Gardez-la secrète.

Les clés enregistrées ne sont jamais réaffichées. Le champ reste vide et affiche Saved — leave empty to keep it. Saisissez une nouvelle valeur uniquement pour la modifier. Pour supprimer une clé enregistrée, cochez Clear the saved key on save sous le champ puis cliquez sur Save.

Chaque commande Conekta conserve son mode : les notifications et les remboursements utilisent la clé correspondante. Gardez les deux clés renseignées tant que d'anciennes commandes test sont encore ouvertes.

Webhook

Le webhook informe votre boutique des paiements, par exemple les paiements OXXO ou SPEI effectués après que le client a quitté la page Conekta. Dans le panneau Conekta, allez dans Developers > Webhooks et ajoutez l'URL affichée dans Webhook URL dans cette section, pour le mode test comme pour le mode production. Sur OpenCart 3, elle ressemble à https://your-store/index.php?route=extension/payment/wcp_conekta_gateway/webhook, et sur OpenCart 4 à https://your-store/index.php?route=extension/wcp_conekta_gateway/payment/wcp_conekta_gateway.webhook. Elle est construite à partir de l'adresse de la vitrine de votre installation OpenCart. Copiez l'URL exactement telle que les réglages l'affichent. Elle doit être accessible depuis Internet.

Sélectionnez ces événements (ils sont aussi listés dans cette section) :

Le corps du webhook indique seulement à l'extension quelle commande Conekta a changé. Chaque notification est vérifiée en relisant la commande depuis l'API Conekta avec la clé privée de son mode ; l'en-tête de signature Digest du webhook n'est pas utilisé. Les notifications concernant des commandes Conekta qui n'ont pas été créées par cette boutique pour cette commande sont acquittées et ignorées. Sans le webhook, une commande n'est confirmée que lorsque le client revient dans la boutique après avoir payé, ou lors de la prochaine tentative de paiement pour le même panier.

Commandes

OpenCart crée la commande à l'étape Confirm Order sans statut (une commande manquante). La commande ne reçoit un statut qu'après que Conekta a signalé le paiement, par le webhook ou au retour du client ; la commande est toujours relue depuis Conekta. Chaque champ ci-dessous liste vos statuts de commande OpenCart.

Order Status After Payment : le statut attribué après un paiement Conekta vérifié. Default : Processing.

Awaiting Conekta Payment Status : une référence OXXO ou SPEI a été remise au client, et Conekta n'a pas encore reçu l'argent. Default : Pending.

Conekta Payment On Hold Status : payé, mais le montant ou la devise diffère de la commande, un paiement TEST est arrivé en mode production, la commande a déjà été annulée, ou le paiement n'est que pré-autorisé. Une note explique la raison. Default : Pending, car OpenCart n'a pas de statut On hold. Vous pouvez créer vos propres statuts dans System > Localisation > Order Statuses et les sélectionner ici.

Payment Expired / Canceled Status : une commande en attente de paiement dont la référence Conekta a expiré ou dont la commande Conekta a été annulée. Default : Canceled.

Refunded Status : attribué une fois le paiement entièrement remboursé depuis la page de la commande. Default : Refunded.

Avancé

Debug log : enregistre les appels API et les notifications dans wc_ckt_debug.log.php, dans le dossier des journaux d'OpenCart (storage/logs). Le fichier ne peut pas être ouvert depuis le web. Les erreurs et les avertissements sont toujours journalisés, même lorsque ce commutateur est désactivé. Les journaux ne contiennent jamais de clés API ni de coordonnées de clients. Default : off.

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

Delete data on uninstall : lorsqu'il est activé, la désinstallation de l'extension supprime les réglages et le journal. Les transactions et remboursements Conekta ainsi que les commandes sont toujours conservés, afin que les anciennes commandes puissent encore être confirmées et remboursées après une réinstallation. Default : off.

Importer / Exporter

Export : Download JSON enregistre les réglages dans un fichier JSON. Les clés privées ne sont pas exportées.

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

Paiement

À l'étape Payment Method, le client choisit la méthode de paiement (par défaut Conekta). À l'étape Confirm Order, le client voit votre description et la note You will be redirected to Conekta to complete your payment. OpenCart crée la commande à cette étape, toujours sans statut. Lorsque le client clique sur Confirm Order, l'extension crée une commande Conekta pour le total de la commande dans la devise de la commande, avec les produits, les suppléments, les remises, les taxes et la livraison, et envoie le client sur la page de paiement hébergée par Conekta. Le nom, l'adresse e-mail, le téléphone et l'adresse de livraison du client sont transmis à Conekta, et le paiement apparaît sur la page Conekta sous la forme Order # suivi du numéro de commande. Le client y paie avec l'une des méthodes autorisées. Sur OpenCart 4, le client choisit la méthode de paiement avec le bouton Choose du bloc de méthode de paiement, dans la fenêtre Payment method options, puis clique sur Confirm Order en bas de la page de paiement. Si la boutique ne demande pas d'adresse de facturation (valeur par défaut d'OpenCart 4), les coordonnées de facturation sont reprises de l'adresse de livraison et du nom du client.

Après le paiement, le client revient dans votre boutique. La commande n'est marquée payée qu'après confirmation par Conekta : l'extension lit la commande depuis l'API Conekta lorsque le webhook arrive et lorsque le client revient. La commande reçoit ensuite son statut de la manière standard d'OpenCart, avec les e-mails habituels de commande et la mise à jour des stocks, et le client voit la page de succès de commande d'OpenCart. Lorsque le client a choisi OXXO ou SPEI et reçu une référence de paiement, la commande reçoit le statut Awaiting Conekta Payment Status, et la page de succès affiche Your Conekta payment reference has been issued. The order will be confirmed as soon as the payment is received. Pour une commande en attente de vérification, la page affiche We are confirming your payment with Conekta. The order will be updated automatically — please do not pay again.

Si le paiement ne peut pas encore être confirmé au retour du client, une page Payment confirmation affiche le même texte ainsi qu'un bouton Check again. Le webhook 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 Conekta 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 est refusé, la commande reste sans statut et le client revient au paiement avec The Conekta payment was not completed. Please try again or choose another payment method. Si la finalisation a expiré ou a été annulée, le message est The Conekta payment has expired or was cancelled. Please try again. Sur OpenCart 4, ces messages s'affichent au-dessus de la page de paiement. Le panier est conservé. À chaque nouvelle tentative (OpenCart 3 crée une nouvelle commande chaque fois que l'étape Confirm Order est affichée, OpenCart 4 conserve une commande pour le paiement et la met à jour), les finalisations Conekta précédentes du panier sont d'abord relues. Une finalisation encore ouverte pour la même commande et le même montant est réutilisée ; sinon, la précédente est annulée dans Conekta avant qu'une nouvelle ne soit créée, afin qu'un ancien lien ne puisse pas être payé deux fois. Si une finalisation précédente a déjà été payée, sa commande est confirmée au lieu de débiter à nouveau. Un panier n'est payé qu'une seule fois : lorsqu'une autre commande du même panier détient déjà un paiement Conekta ou une référence OXXO / SPEI émise, aucun nouveau paiement n'est lancé et le client est dirigé vers la page de succès. Si un second paiement pour le même panier arrive malgré tout, sa commande reste sans statut et la commande payée reçoit une note invitant à rembourser le doublon depuis le panneau Conekta.

OpenCart 4 conserve la commande dans le paiement jusqu'à l'affichage de la page de succès. Si cette commande a été fermée entre-temps (par exemple, sa référence OXXO ou SPEI a expiré, ou vous l'avez annulée), Confirm Order renvoie le client au paiement avec The Conekta payment has expired or was cancelled. Please try again., et le Confirm Order suivant paie une nouvelle commande du panier. Si la commande a déjà un statut et que le panier a changé depuis (autres produits ou quantités), le client est renvoyé au paiement, et le panier modifié reçoit une nouvelle commande et son propre paiement.

Si Conekta ne peut pas démarrer le paiement, le client reste à l'étape Confirm Order avec un bref message au-dessus du bouton, par exemple The payment could not be started. Please try again in a moment or choose another payment method. Les messages de validation de Conekta, comme un montant minimum, sont affichés tels que Conekta les envoie. La raison technique est inscrite dans le journal.

Le webhook 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 pour le webhook.

L'extension n'accepte les paiements que sur la page Conekta. Elle n'affiche aucun formulaire de carte sur votre page de paiement et ne gère ni cartes enregistrées, ni abonnements, ni pré-autorisation et capture, ni paiements échelonnés mensuels (MSI).

Commandes et remboursements

Statuts de commande

Aucun statut (commande manquante) : le client a été envoyé vers Conekta et n'a pas payé, le paiement a été refusé, ou Conekta 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.

Order Status After Payment (default Processing) : Conekta a confirmé le paiement avec le même montant et la même devise. Une note indique la méthode de paiement (par exemple la marque de la carte et les quatre derniers chiffres, OXXO / espèces ou virement SPEI), la commande Conekta et le débit.

Awaiting Conekta Payment Status (default Pending) : le client a reçu une référence de paiement OXXO ou SPEI. La commande passe au statut Order Status After Payment lorsque Conekta signale le paiement.

Conekta Payment On Hold Status (default Pending) : le montant ou la devise reçu de Conekta ne correspond pas à la commande, un paiement en mode test est arrivé alors que la boutique est en mode production (aucun argent réel n'a été encaissé), ou le paiement est arrivé pour une commande déjà annulée. La note l'explique. Vérifiez la commande, puis traitez-la ou remboursez le paiement. Une commande uniquement pré-autorisée dans Conekta est également mise en attente, avec une note invitant à la capturer ou à l'annuler dans le panneau Conekta.

Payment Expired / Canceled Status (default Canceled) : la référence OXXO ou SPEI d'une commande en attente a expiré, ou sa commande Conekta a été annulée.

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

Une commande payée ou remboursée n'est jamais rétrogradée ni rouverte. Si un autre paiement Conekta arrive pour une commande déjà payée, une note AVERTISSEMENT (WARNING) vous demande de la rembourser depuis le panneau Conekta.

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

Onglet VibeFox Conekta Gateway

Dans Sales > Orders, ouvrez une commande payée avec Conekta. En bas de la page de la commande, à côté de History et Additional, l'onglet VibeFox Conekta Gateway affiche la Conekta order avec une étiquette Test mode pour les paiements test, le Charge, le Status du paiement, les montants Paid / refunded, le formulaire de remboursement, l'historique des remboursements et les Conekta notes de la commande. L'onglet est affiché aux utilisateurs qui ont accès à l'extension.

Remboursements

Dans l'onglet VibeFox Conekta Gateway, saisissez le Amount (le montant non encore remboursé est prérempli), éventuellement un Reason (optional), puis cliquez sur Refund via Conekta. Confirmez la question Refund this amount through Conekta? This cannot be undone. Les remboursements totaux et partiels sont pris en charge. Vous devez avoir le droit de modifier l'extension (à régler dans System > Users > User Groups). Les remboursements sont limités au montant et à la devise que Conekta a réellement débités ; ainsi, après un écart de montant, vous pouvez rembourser jusqu'au montant payé par le client, et non le total de la commande. Le remboursement est envoyé à la commande Conekta qui contient le paiement et utilise la clé du mode dans lequel le paiement a été effectué ; cette clé doit donc être renseignée. Si Conekta 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 le montant, le mode, la commande Conekta, l'identifiant du remboursement et le motif. Un remboursement total place la commande au Refunded Status sans notifier le client et sans remettre les produits en stock, comme pour un changement de statut manuel. Un remboursement partiel ne modifie pas le statut. Les remboursements sont disponibles dès que Conekta a signalé le paiement.

Les retours de produits dans Sales > Returns ne renvoient pas d'argent via Conekta.

Les remboursements effectués dans le panneau Conekta arrivent par le webhook et sont ajoutés sous forme de note, avec le montant remboursé dans Conekta et dans OpenCart. Ils ne sont pas enregistrés automatiquement. Mettez la commande à jour manuellement, sans utiliser Refund via Conekta. Une rétrofacturation signalée par Conekta est également ajoutée sous forme de note.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox Conekta Gateway est le premier bloc de Extensions > Extensions > Payments > VibeFox Conekta Gateway > Edit, au-dessus des réglages. Collez la clé dans License key puis 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-conekta 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 changer 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 pour un seul domaine : l'adresse de la boutique de la configuration 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, Conekta n'est pas affiché aux clients au moment du paiement. Si un paiement est tout de même lancé, 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 toujours la méthode de paiement dans la boutique, marquée (unlicensed — visible to admins only), afin que vous puissiez installer 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 la méthode de paiement est masquée 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 touché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é à 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

Conekta n'apparaît pas au moment du paiement : vérifiez que la licence est active, que Enable / Disable est activé, que la clé privée du mode actuel est renseignée (Test private key en mode test, Live private key en mode production) et que la devise du paiement est MXN ou USD. La page de configuration affiche un avertissement lorsque la clé est absente ou que la devise de la boutique n'est pas prise en charge. Vérifiez également 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 : le webhook ne fonctionne pas. Dans le panneau Conekta, vérifiez que le webhook existe pour le mode utilisé (test ou production), que son URL correspond exactement à celle affichée dans Webhook URL et que les événements sont sélectionnés. Vérifiez que la clé privée de ce mode est renseignée, car chaque notification est vérifiée avec elle. La commande reçoit aussi son statut lorsque le client revient dans la boutique ou lorsqu'il tente de payer à nouveau le même panier.

Le webhook répond Temporarily unavailable : l'API Conekta n'a pas pu être jointe, la clé privée du mode de la commande est absente, la commande était en cours de traitement par une autre requête, ou le statut de la commande n'a pas pu être attribué. Conekta réessaie le webhook. Consultez le champ Log pour connaître la raison.

Le webhook répond Verification failed, Invalid payload ou Invalid order id : l'API Conekta n'a pas confirmé la commande, ou la notification n'était pas un événement de commande Conekta valide.

Le webhook répond Ignored : la notification concerne une commande Conekta qui n'a pas été créée par cette boutique pour cette commande (par exemple une autre boutique ou un lien de paiement du même compte), ou un autre objet qu'une commande.

L'URL du webhook affiche Method not allowed dans le navigateur : c'est normal. L'URL n'accepte que les requêtes provenant de Conekta.

Le client voit We could not check the status of your previous payment attempt : la finalisation Conekta précédente du panier n'a pas pu être lue, donc aucune nouvelle n'est créée afin d'éviter un double paiement. Réessayez dans un instant.

Le client voit Payment gateway is not configured : la clé privée du mode actuel est absente.

Le client voit This payment method is not available. : la session de paiement ne correspond plus à la commande, ou la méthode de paiement a été désactivée entre-temps. Le client recharge la page de paiement.

Le client voit Payment verification failed : le lien de retour de Conekta ne correspondait pas à la commande. Vérifiez la commande dans le panneau Conekta ; le webhook confirme tout de même un paiement réel.

La commande est en statut d'attente ou de mise en attente : lisez les Conekta notes dans l'onglet de la commande. Le client n'a pas encore payé la référence OXXO ou SPEI, le montant ou la devise ne correspondait pas, un paiement en mode test est arrivé alors que la boutique est en mode production, ou le paiement n'est que pré-autorisé.

Aucun formulaire de remboursement dans l'onglet : l'onglet indique la raison : Conekta n'a pas encore signalé le paiement, il est entièrement remboursé, votre groupe d'utilisateurs n'a pas le droit de modifier l'extension, ou la clé privée du mode du paiement n'est pas renseignée.

Le remboursement échoue avec un message concernant le mode test ou production : le paiement a été effectué dans ce mode, et sa clé privée n'est pas renseignée. Saisissez-la et réessayez.

Pour les développeurs : les événements OpenCart wc_ckt_supported_currencies, wc_ckt_order_request, wc_ckt_allowed_payment_methods et wc_ckt_refund_reason permettent à d'autres extensions de modifier les devises prises en charge, la requête de commande Conekta, les méthodes de paiement et le motif de remboursement.

Désinstallation

Allez dans Extensions > Extensions, choisissez le type Payments et cliquez sur Uninstall (le bouton rouge −) à côté de VibeFox Conekta 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 également supprimé (sur OpenCart 4, ses événements et son action de démarrage, qui laisse passer le webhook en mode maintenance). Si Delete data on uninstall est activé, les autres réglages de la passerelle (titre, description, méthodes de paiement, mode test, clés privées, journalisation) ainsi que le journal sont supprimés. S'il est désactivé, ils sont conservés pour une réinstallation ultérieure. Les transactions et remboursements Conekta sont toujours conservés, afin que les commandes payées auparavant puissent 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 Conekta Gateway dans la liste des extensions installées, puis sur Delete (le bouton rouge corbeille) pour supprimer le paquet téléchargé.

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