VibeFox MercadoPago for OpenCart

Présentation

VibeFox MercadoPago Gateway ajoute à OpenCart 3 et OpenCart 4 les paiements par carte de crédit et de débit avec l'API Checkout de MercadoPago, pour les comptes MercadoPago en Argentine, au Brésil, au Chili, en Colombie, au Mexique, au Pérou et en Uruguay. À l'étape Confirm Order, le client saisit les données de sa carte dans les champs sécurisés MercadoPago.js fournis par MercadoPago, de sorte que les données de carte n'atteignent jamais votre site. MercadoPago transforme la carte en jeton à usage unique, et votre boutique crée le paiement côté serveur. OpenCart crée la commande avant le paiement, mais la commande n'obtient un statut qu'après la réponse de MercadoPago ; les cartes refusées laissent donc des commandes sans statut.

Elle convient aux boutiques qui vendent dans la devise de leur compte MercadoPago et souhaitent afficher le formulaire de carte sur leur propre page de paiement, avec paiement en plusieurs fois. L'extension n'accepte que les cartes. Elle ne propose ni redirection vers Checkout Pro, ni portefeuille MercadoPago, ni paiement en espèces, Pix, PSE ou Yape, ni cartes enregistrées ou abonnements, ni autorisation et capture séparées, ni conversion de devise.

Fonctionnalités principales

Formulaire de carte sur votre paiement : numéro de carte, date d'expiration et code de sécurité dans les champs MercadoPago, nom du titulaire, document du titulaire lorsque le pays l'exige, émetteur de la carte si nécessaire, et paiement en plusieurs fois (cuotas, parcelas) proposé par MercadoPago pour le total de la commande, limité par votre Maximum installments.

Payée uniquement après confirmation de MercadoPago : les paiements approuvés, avec le montant et la devise correspondants, passent à votre statut de commande payée ; les paiements en cours d'examen restent dans leur propre statut jusqu'à ce que la notification de MercadoPago les finalise. Un écart place la commande dans un statut de vérification avec une note. OpenCart envoie ensuite ses e-mails habituels de commande.

Notifications sécurisées : chaque notification est relue auprès de l'API MercadoPago avant toute modification de commande, avec une vérification optionnelle de la signature x-signature.

Aucun double débit : un verrou par panier, une clé d'idempotence par jeton de carte et la recherche des réponses perdues empêchent les doubles débits en cas de double clic, d'un second onglet ou de délai dépassé. Un panier déjà payé n'est jamais débité à nouveau.

Modes test et production : identifiants TEST- et APP_USR- distincts, vérifiés par préfixe et par rapport au pays du compte lors de l'enregistrement. Les remboursements et les notifications utilisent les identifiants du mode dans lequel le paiement a été effectué.

Remboursements depuis la page de commande : remboursements totaux et partiels dans l'onglet VibeFox MercadoPago Gateway de la commande, dans la limite du montant réellement débité, avec les détails du paiement, l'historique des remboursements et les notes MercadoPago. Un remboursement total définit le statut Refunded.

Vos propres statuts de commande et conditions OpenCart : choisissez le statut OpenCart d'une commande payée, d'un paiement en cours d'examen chez MercadoPago, d'un paiement en attente, d'un paiement échoué, d'une commande annulée et d'une commande remboursée. Zone géographique, montant minimum de la commande et ordre de tri. Journal sans jetons ni données de carte ou de payeur.

Prérequis

OpenCart 3.0.x (testé sur 3.0.5.0) ou OpenCart 4.0.2 et supérieur (testé sur 4.1.0.3), PHP 8.0 ou supérieur. Un seul téléchargement contient les paquets des deux versions. Une devise activée dans la boutique, identique à la devise de votre compte MercadoPago (ARS, BRL, CLP, COP, MXN, PEN ou UYU). Une application MercadoPago avec des clés publiques (Public Keys) et des jetons d'accès (Access Tokens) de test et de production. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).