VibeFox MercadoPago for OpenCart — Aide

Prérequis

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

PHP : 8.0 ou ultérieur.

Devise de la boutique : la devise du pays de votre compte MercadoPago doit être activée dans la boutique : ARS (Argentine), BRL (Brésil), CLP (Chili), COP (Colombie), MXN (Mexique), PEN (Pérou) ou UYU (Uruguay). MercadoPago débite dans la devise du compte et ne convertit pas, donc le mode de paiement n'est affiché qu'aux clients qui paient dans cette devise.

Compte MercadoPago : vous avez besoin d'une application dans le panneau développeur de MercadoPago (Your integrations > your application > Credentials) avec ses identifiants de test (commençant par TEST-) et de production (commençant par APP_USR-) : une Public Key et un Access Token pour chacun. Pour la vérification facultative de la signature des notifications, vous avez aussi besoin de la signature secrète de your application > Webhooks.

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 des deux versions d'OpenCart. Décompressez-le sur votre ordinateur. Il contient README.txt, le paquet OpenCart 3 wcp_mercadopago_gateway-oc3-(version).ocmod.zip et le paquet OpenCart 4 wcp_mercadopago_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_mercadopago_gateway-oc3-(version).ocmod.zip. L'extension ne contient aucune modification OCMOD, il n'est donc pas nécessaire d'actualiser Extensions > Modifications. Au lieu de l'installateur, vous pouvez 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 MercadoPago 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 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 le Account country, saisissez les identifiants de test et de production et, si vous le souhaitez, configurez les notifications dans votre application MercadoPago (voir Configuration). Vérifiez que la devise du compte est activée dans System > Localisation > Currencies.

5. Activez Enable / Disable et cliquez sur Save. Testez un paiement en mode test avec les cartes de test MercadoPago, puis désactivez Test mode.

OpenCart 4

1. Dans l'administration, allez dans Extensions > Installer, cliquez sur Upload et choisissez le fichier wcp_mercadopago_gateway.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 MercadoPago Gateway, cliquez sur Install (le bouton vert +), puis sur Edit (le bouton en forme de crayon).

4. Saisissez la clé de licence, les identifiants et les notifications comme aux étapes 3 à 5 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 de paiement (webhooks)).

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 MercadoPago Gateway > Edit. Les sections sont listées à gauche ; le bouton Save sous la liste enregistre la page entière. Au-dessus des réglages, la page affiche Test mode is on: the TEST- credentials are used and no real money is charged. tant que le mode test est activé. Elle vous avertit lorsque la Public Key ou l'Access Token du mode actuel est absent (le mode de paiement est alors masqué au moment du paiement), lorsque la devise par défaut de la boutique n'est pas celle de votre compte MercadoPago (le mode de paiement n'est alors affiché qu'aux clients qui paient dans la devise du compte, ou masqué si la boutique n'a pas cette devise activée), et lorsque les identifiants appartiennent à un compte d'un autre pays que Account country. Sans le droit de modifier l'extension, la page affiche les réglages mais ne peut pas les enregistrer.

Si vous enregistrez avec un Title vide (ou de plus de 128 caractères), rien n'est enregistré et la page affiche Enter a title for the payment method (1 to 128 characters). Toute autre valeur incorrecte n'est pas enregistrée et conserve sa valeur précédente, avec une erreur qui nomme le champ et se termine par — the previous value was kept. Cela concerne un identifiant qui ne commence pas par le préfixe attendu (TEST- pour les champs de test, APP_USR- pour les champs de production), un Maximum installments en dehors de 1–24, un Sort Order qui n'est pas un nombre entier (Sort Order must be a whole number), un Total qui n'est pas un nombre supérieur ou égal à 0, ainsi qu'une zone géographique ou un statut de commande qui n'existe pas. Après l'enregistrement, l'extension demande à MercadoPago le pays auquel appartient chaque access token. Si le token du mode actuel ne peut pas être vérifié, si le compte n'est pas dans un pays pris en charge ou si le pays diffère de Account country, un avertissement s'affiche. L'extension utilise alors le pays du compte.

MercadoPago

Enable / Disable : Enable MercadoPago card payments active ou désactive le mode de paiement. Le mode de paiement n'est affiché au moment du paiement que lorsque les identifiants du mode actif sont renseignés et que le client paie dans la devise du compte MercadoPago. Par défaut : désactivé.

Title : le nom du mode de paiement affiché au client lors du paiement. C'est aussi le nom du mode de paiement enregistré dans la commande. Par défaut : Credit or debit card (MercadoPago). Obligatoire, jusqu'à 128 caractères.

Description : le texte affiché au-dessus des champs de carte à l'étape Confirm Order. Par défaut : Pay securely with your credit or debit card. Card data is sent directly to MercadoPago.

Sort Order : la position de MercadoPago parmi les modes de paiement au moment du paiement. Laissez vide ou saisissez un nombre entier.

Geo Zone : proposer MercadoPago uniquement pour les adresses de paiement de 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 doit atteindre une commande pour que MercadoPago soit proposé. Laissez vide pour proposer MercadoPago quel que soit le montant.

Compte MercadoPago

Récupérez les identifiants de votre application dans le panneau développeur de MercadoPago : Your integrations > your application > Credentials (la page propose un lien vers cet endroit). Les identifiants de test commencent par TEST-, ceux de production par APP_USR-.

Account country : le pays de votre compte MercadoPago. Il détermine la devise facturée, la langue des champs de carte et si le document du titulaire est demandé. Le client doit payer dans la même devise, par exemple ARS pour l'Argentine. Lors de l'enregistrement des identifiants, le pays est vérifié avec le compte. Par défaut : Argentina (ARS).

Test mode : en mode test, les identifiants TEST- sont utilisés et vous payez avec les cartes de test MercadoPago ; une pastille TEST MODE avec Use MercadoPago test cards. No real charges. est affichée au moment du paiement. Désactivez-le pour débiter de vraies cartes avec les identifiants de production. Les remboursements et les notifications utilisent toujours les identifiants du mode dans lequel le paiement a été effectué. Par défaut : activé.

Test Public Key : commence par TEST-. Utilisée dans le navigateur pour tokéniser la carte.

Test Access Token : commence par TEST-. Utilisé uniquement sur le serveur. Gardez-le secret.

Production Public Key : commence par APP_USR-.

Production Access Token : commence par APP_USR-. Utilisé uniquement sur le serveur. Gardez-le secret.

Les access tokens enregistrés et le secret du webhook ne sont plus jamais affichés. Le champ reste vide et affiche Saved — leave empty to keep it. Saisissez une nouvelle valeur uniquement pour la modifier. Pour supprimer une valeur enregistrée, cochez Clear the saved value on save sous le champ et cliquez sur Save.

Options de paiement

Maximum installments : le nombre maximal de versements (cuotas ou parcelas) que le client peut choisir, de 1 à 24. 1 = paiement unique uniquement. La limite est aussi appliquée sur le serveur. Par défaut : 1.

Notifications de paiement (webhooks)

Les paiements par carte reçoivent généralement une réponse définitive immédiatement. Les paiements que MercadoPago met en examen (en cours de traitement ou en attente) sont finalisés par les notifications de MercadoPago. L'extension envoie l'URL de notification avec chaque paiement lorsque votre boutique a une adresse publique (pas localhost ni un domaine .local ou .test). Vous pouvez aussi l'ajouter dans your application > Webhooks, événement Payments. L'URL est affichée dans Notification URL dans cette section. Sous OpenCart 3, elle ressemble à https://your-store/index.php?route=extension/payment/wcp_mercadopago_gateway/webhook&source_news=webhooks, et sous OpenCart 4 à https://your-store/index.php?route=extension/wcp_mercadopago_gateway/payment/wcp_mercadopago_gateway.webhook&source_news=webhooks. Elle est construite à partir de l'adresse de la vitrine de votre installation OpenCart. Copiez l'URL exactement telle qu'elle est affichée dans les réglages.

Une notification n'est jamais considérée comme fiable en soi. L'extension relit le paiement depuis l'API MercadoPago avec l'access token de l'environnement dans lequel le paiement a été effectué, et le rattache à une tentative de paiement de votre boutique. Sans notifications, les commandes en examen restent en Awaiting MercadoPago Status jusqu'à ce que vous les mettiez à jour manuellement.

L'extension gère ces statuts de paiement MercadoPago :

Webhook secret signature : facultatif. La signature secrète affichée dans your application > Webhooks. Si elle est renseignée, les notifications sans x-signature valide sont rejetées (HTTP 401).

Commandes

OpenCart crée la commande à l'étape Confirm Order sans statut (une commande incomplète). Elle ne reçoit un statut qu'après la réponse de MercadoPago. Une carte refusée laisse la commande sans statut (une note explique pourquoi) et le client reste à l'étape Confirm Order. Chacun des champs ci-dessous présente vos statuts de commande OpenCart.

Order Status After Payment : MercadoPago a approuvé le paiement et son montant et sa devise correspondent à la commande. Par défaut : En cours.

Awaiting MercadoPago Status : le paiement est en cours d'examen chez MercadoPago (en cours de traitement ou en attente) ; la notification finalise la commande. Par défaut : En attente.

On Hold (Review) Status : MercadoPago a approuvé un montant ou une devise différent de la commande, ou a renvoyé un statut inattendu. Une note explique ce qu'il faut vérifier dans le panneau MercadoPago. Par défaut : En attente, car OpenCart n'a pas de statut On hold. Vous pouvez créer vos propres statuts dans System > Localisation > Order Statuses pour distinguer les commandes en attente des commandes en examen.

Payment Failed Status : un paiement en examen a été refusé ou annulé par MercadoPago. Par défaut : Échoué.

Cancelled Status : une commande dans ce statut (ou dans le statut remboursé) est clôturée : une approbation tardive de MercadoPago ajoute seulement une note. Par défaut : Annulée.

Refunded Status : le paiement est intégralement remboursé depuis la page de la commande. Les remboursements partiels ajoutent seulement une note. Par défaut : Remboursée.

Avancé

Debug log : écrit les requêtes et notifications MercadoPago dans wc_mpg_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 journalisées, même lorsque ce réglage est désactivé. Les access tokens, les tokens de carte et les données du payeur ne sont pas journalisés. 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 : lorsqu'il est activé, la désinstallation de l'extension supprime les réglages de la passerelle et le journal. Les enregistrements de paiement MercadoPago et les remboursements sont toujours conservés, de sorte que les commandes payées auparavant peuvent encore ê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. Les access tokens et le secret du webhook ne sont pas exportés.

Import : collez le JSON exporté précédemment et cliquez sur Import pour restaurer les réglages. Les secrets enregistrés sont conservés.

Paiement

À l'étape Payment Method, le client choisit le mode de paiement (par défaut Credit or debit card (MercadoPago)). OpenCart crée la commande à l'étape Confirm Order, toujours sans statut. Le client y voit votre description et remplit les champs de carte : Card number, Expiry (MM/YY), Security code et Cardholder name. Selon le pays et la carte, le client choisit aussi le Document type et saisit le Document number, sélectionne le Card issuer et le nombre de Installments. Les options de versements et les intérêts proviennent de MercadoPago pour le montant de la commande.

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. Les champs de carte apparaissent alors dans le bloc de confirmation de la commande en bas de la page de paiement, au-dessus du bouton Confirm Order.

Lorsque le client clique sur Confirm Order, MercadoPago transforme la carte en jeton à usage unique, et votre boutique crée le paiement sur le serveur pour le montant de la commande dans la devise de la commande. L'adresse e-mail et le nom du client ainsi que le document sont transmis à MercadoPago ; le paiement apparaît avec Order #, le numéro de commande et le nom de votre boutique. Les montants en CLP et COP sont débités sans décimales.

Un paiement approuvé définit le statut de la commande de la manière habituelle d'OpenCart, avec les e-mails de commande habituels et la mise à jour du stock ; le panier est vidé et le client voit la page de succès de commande d'OpenCart. Un paiement en examen définit Awaiting MercadoPago Status, et la page affiche aussi MercadoPago is reviewing your payment. Your order will be updated automatically as soon as MercadoPago confirms it. Une commande en statut d'examen affiche Your payment is being reviewed. We will update your order as soon as the review is complete.

Une carte refusée laisse la commande sans statut. Le client reste à l'étape Confirm Order avec une raison courte, par exemple Your card has insufficient funds. Please use another card or payment method. ou Please check the security code of your card. Le client peut corriger les données ou utiliser une autre carte ; un nouveau jeton de carte est créé à chaque tentative. Si des données de carte manquent, le message Please fill in all card fields. s'affiche.

Si MercadoPago ne répond pas, le client voit We could not confirm your payment with MercadoPago. Please wait a minute before trying again — if the payment went through, your order will be updated automatically. La tentative suivante recherche d'abord le paiement, afin que la carte ne soit pas débitée deux fois. Un deuxième clic pendant que le panier est en cours de paiement affiche This order is already being paid. Please wait a moment and check your e-mail before trying again. OpenCart 3 crée une nouvelle commande chaque fois que l'étape Confirm Order est affichée, OpenCart 4 garde une commande pour la caisse et, après une carte refusée, le client règle la même commande. Dans les deux cas, un panier dont la commande est payée ou en attente n'est jamais débité à nouveau ; le client est envoyé sur la page de succès.

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), elle n'est pas débitée, et le client voit Your previous order was cancelled without a payment. Please reload the checkout page and confirm the order again — the payment will be made with a new order. Si la commande est déjà enregistrée et que le panier a changé depuis, le message est Your previous order has already been placed. Your cart has changed since — please reload the checkout page and confirm the order again to pay for the current cart with a new order. Une modification du panier, y compris une nouvelle quantité, compte comme un nouveau panier qui nécessite son propre paiement.

L'URL de notification fonctionne aussi lorsque 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 pour elle.

L'extension n'accepte que les cartes de crédit et de débit. Elle ne propose ni redirection Checkout Pro, ni portefeuille MercadoPago ou solde du compte, ni paiement en espèces (Rapipago, OXXO, boleto et autres), ni Pix, PSE ou Yape, ni cartes enregistrées ou abonnements, ni autorisation et capture séparées, ni challenge 3-D Secure, ni conversion de devise.

Commandes et remboursements

Statuts de commande

No status (missing order) : la carte a été refusée, ou MercadoPago n'a pas encore répondu. Dans Sales > Orders, ces commandes ne s'affichent qu'avec le filtre Order Status défini sur Missing Orders.

Order Status After Payment (par défaut En cours) : MercadoPago a approuvé le paiement et le montant et la devise correspondent à la commande. Une note affiche l'ID du paiement, l'environnement et le nombre de versements.

Awaiting MercadoPago Status (par défaut En attente) : le paiement est en cours d'examen (en cours de traitement ou en attente) et attend la notification MercadoPago. La commande passe à Order Status After Payment lorsque MercadoPago l'approuve.

On Hold (Review) Status (par défaut En attente) : le montant ou la devise approuvé diffère de la commande, ou MercadoPago a renvoyé un statut inattendu. La note l'explique. Vérifiez la commande, puis exécutez-la ou remboursez le paiement.

Payment Failed Status (par défaut Échoué) : un paiement en examen a été refusé ou annulé. La note affiche le statut et son détail.

Refunded Status (par défaut Remboursée) : le paiement a été intégralement remboursé via l'extension.

Si MercadoPago approuve un paiement pour une commande déjà annulée ou remboursée, le statut ne change pas et une note vous demande de finaliser la commande ou de rembourser le paiement. Si un autre paiement arrive pour une commande ou un panier déjà payé, une note vous demande de rembourser le paiement supplémentaire dans le panneau MercadoPago.

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

Onglet VibeFox MercadoPago Gateway

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

Remboursements

Dans l'onglet VibeFox MercadoPago Gateway, saisissez le Amount (le montant non encore remboursé est prérempli), facultativement un Reason (optional), puis cliquez sur Refund via MercadoPago. Confirmez la question Refund this amount through MercadoPago? This cannot be undone. Les remboursements totaux et partiels sont pris en charge. Vous devez avoir le droit de modifier l'extension (défini dans System > Users > User Groups). Les remboursements sont limités au montant débité par MercadoPago ; après un écart de montant, vous pouvez donc rembourser jusqu'à ce que le client a réellement payé, et non le total de la commande. Le remboursement est envoyé avec les identifiants de l'environnement dans lequel le paiement a été effectué (test ou production), donc l'access token de cet environnement doit être renseigné. Si MercadoPago refuse le remboursement, l'onglet affiche MercadoPago refused the refund avec la raison et aucun remboursement n'est enregistré. Un remboursement approuvé ou en cours de traitement est ajouté à l'historique des remboursements et aux notes, avec l'ID du remboursement. Un remboursement total place la commande en Refunded Status sans prévenir le client et sans remettre les produits en stock, comme un changement de statut manuel. Un remboursement partiel ne change pas le statut.

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

Les remboursements, contestations et médiations effectués dans le panneau MercadoPago arrivent par notification et sont ajoutés aux notes. Le statut de la commande n'est pas modifié automatiquement. Mettez-le à jour manuellement si nécessaire.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox MercadoPago Gateway est le premier bloc de Extensions > Extensions > Payments > VibeFox MercadoPago 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 de fin de validité de la licence et votre domaine) et 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-mercadopago 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 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 issue de 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, MercadoPago 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 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 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 la licence.

Dépannage

MercadoPago n'apparaît pas au moment du paiement : vérifiez que la licence est active, que Enable / Disable est activé et que le mode actuel dispose des deux identifiants avec le bon préfixe : les clés TEST- en mode test, les clés APP_USR- en production. Vérifiez que le client paie dans la devise de votre compte MercadoPago (la devise doit être activée dans la boutique), 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. La page de réglages indique celui qui manque.

Le paiement a été effectué, mais la commande reste dans Awaiting MercadoPago Status : la notification n'est pas arrivée. L'extension n'envoie l'URL de notification que lorsque votre boutique a une adresse publique (pas localhost ni un domaine .local ou .test). Ajoutez l'URL de Notification URL dans your application > Webhooks avec l'événement Payments. Si Webhook secret signature est renseigné, vérifiez qu'il s'agit du secret de la même application. Le panneau MercadoPago affiche la réponse de votre boutique pour chaque notification.

La notification répond invalid signature : la signature secrète appartient à une autre application, ou la notification n'a pas de x-signature valide. Copiez à nouveau le secret ou laissez le champ vide.

La notification répond no credentials for test ou no credentials for live : l'access token de l'environnement dans lequel le paiement a été effectué n'est pas renseigné. Saisissez-le ; MercadoPago renouvelle la notification.

La notification répond not for this store : le paiement n'appartient pas à une tentative de paiement de cette boutique. Aucune commande n'est modifiée.

La notification répond order busy ou payment could not be read : la commande était en cours de mise à jour par une autre requête au même moment, ou MercadoPago était injoignable. MercadoPago renouvelle automatiquement la notification.

Un identifiant n'est pas enregistré : l'erreur must start with indique que la valeur a un mauvais préfixe pour ce champ. Les champs de test acceptent les identifiants TEST-, les champs de production les identifiants APP_USR-.

Le client voit « This payment method is not configured correctly. Please choose another payment method or contact the store. » : les identifiants du mode actuel sont absents, ont un mauvais préfixe ou ont été rejetés par MercadoPago. Vérifiez-les sur la page de réglages.

Le client voit « MercadoPago cannot process payments in » : la devise de la commande n'est pas celle de votre compte MercadoPago. MercadoPago ne convertit pas les devises.

Le formulaire de carte sécurisé ne se charge pas : le client voit The secure card form could not be loaded. Please reload the page or choose another payment method. Vérifiez la Public Key du mode actuel.

Le client voit « Your session has expired. Please reload the page and try again. » : le formulaire de carte n'appartient plus à la session de paiement du client. Le client recharge la page de paiement.

Le client voit « Your payment was received, but the order could not be completed automatically » : MercadoPago a encaissé le paiement, mais OpenCart n'a pas pu définir le statut de la commande. Consultez le champ Log de la page de l'extension : les erreurs sont toujours journalisées. Il est demandé au client de ne pas payer à nouveau ; la tentative de paiement ou la notification suivante pour le panier définit le statut sans nouveau débit.

La commande est en statut d'examen après le paiement : lisez les MercadoPago notes dans l'onglet de la commande (voir Statuts de commande), puis exécutez la commande ou remboursez le paiement.

Le remboursement échoue avec un message sur le mode : le paiement a été effectué en mode test ou en production, et l'access token de ce mode n'est pas renseigné. Saisissez-le et réessayez.

Le remboursement échoue avec MercadoPago did not answer the refund request : vérifiez le paiement dans le panneau MercadoPago avant de réessayer.

Désinstallation

Allez dans Extensions > Extensions, choisissez le type Payments et cliquez sur Uninstall (le bouton rouge −) à côté de VibeFox MercadoPago 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é (sous OpenCart 4, également son action de démarrage, qui laisse passer les notifications en mode maintenance). Si Delete data on uninstall est activé, les autres réglages de la passerelle (titre, description, pays du compte, mode test, identifiants, versements, secret du webhook, journalisation), la vérification de compte enregistrée et le journal sont supprimés. S'il est désactivé, ils sont conservés pour une réinstallation ultérieure. Les enregistrements de paiement MercadoPago et les remboursements 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.

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 MercadoPago Gateway dans la liste des extensions installées, puis sur Delete (le bouton rouge en forme de poubelle) pour supprimer le paquet téléversé.

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