VibeFox OpenPay for OpenCart

Présentation

VibeFox OpenPay Gateway ajoute à OpenCart 3 et OpenCart 4 les paiements par carte de crédit et de débit via OpenPay (BBVA), pour les comptes OpenPay du Mexique, de Colombie et du Pérou. Le formulaire de carte s'affiche à l'étape Confirm Order, mais la carte est tokenisée dans le navigateur par openpay.js : le numéro de carte et le CVV n'atteignent jamais votre boutique. Chaque paiement passe par 3D Secure. OpenCart crée la commande avant le paiement, mais la commande ne reçoit un statut qu'après la confirmation du débit par OpenPay.

L'extension accepte les paiements uniques par carte, débités immédiatement. Elle ne gère ni cartes enregistrées, ni abonnements, ni paiements en plusieurs fois sans frais (MSI) ou en plusieurs mensualités, ni points de carte, ni paiements en espèces, SPEI, PSE ou CoDi, ni autorisation et capture séparées.

Principales fonctionnalités

Formulaire de carte avec 3D Secure : formulaire de carte à l'étape Confirm Order, tokenisé par openpay.js avec la vérification antifraude de l'appareil d'OpenPay ; chaque débit passe par 3D Secure sur la page de la banque.

Payée seulement après confirmation d'OpenPay : le débit est relu depuis l'API OpenPay lorsque le client revient de 3D Secure et lorsque le webhook arrive. OpenCart envoie ensuite ses e-mails de commande habituels.

Contrôle du montant et de la devise : un débit terminé doit correspondre exactement au total et à la devise de la commande. En cas d'écart, la commande passe dans un statut de vérification avec une note, sans être marquée comme payée.

Jamais débitée deux fois : un panier déjà payé n'est jamais débité à nouveau, et avant une nouvelle tentative, le débit précédent du panier est vérifié.

Sandbox et production : identifiant marchand, clé privée et clé publique distincts pour chaque mode. Les remboursements et les webhooks utilisent toujours les clés du mode et du pays de compte dans lequel le débit a été effectué.

Remboursements depuis la page de commande : remboursements totaux et partiels dans l'onglet VibeFox OpenPay Gateway de la commande, pour le Mexique et le Pérou (Colombie : dans le tableau de bord OpenPay). Les remboursements et contestations effectués depuis le tableau de bord sont notés sur la commande.

Messages clairs pour les clients : carte expirée, fonds insuffisants, CVV incorrect, échec de 3D Secure et autres erreurs OpenPay reçoivent des messages courts ; les erreurs techniques ne sont jamais affichées aux clients.

Vos propres statuts de commande et conditions OpenCart : choisissez les statuts des commandes payées, en attente, à vérifier, échouées et remboursées ; zone géographique, montant total minimum et ordre de tri. Journal optionnel, sans clés, données de carte ni données clients.

Prérequis

OpenCart 3.0.x (testé sur 3.0.5.0) ou OpenCart 4.0.2 et ultérieur (testé avec la version 4.1.0.3), PHP 8.0 ou ultérieur, HTTPS. Un même téléchargement contient les paquets des deux versions. Un compte OpenPay du Mexique, de Colombie ou du Pérou avec son identifiant marchand, sa clé privée et sa clé publique (sandbox et production), et une devise de commande acceptée par le compte. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).