VibeFox OpenPay for PrestaShop

Présentation

VibeFox OpenPay Gateway ajoute à PrestaShop les paiements par carte de crédit et de débit avec OpenPay (BBVA), pour les comptes OpenPay du Mexique, de Colombie et du Pérou. Le client saisit sa carte à l'étape de paiement, mais la carte est tokenisée dans le navigateur par openpay.js : le numéro de carte et le CVV n'atteignent donc jamais votre boutique. Chaque paiement passe par 3D Secure, et la commande n'est créée qu'après la confirmation du paiement par OpenPay.

Le module accepte les paiements uniques par carte, avec capture immédiate. Il ne gère ni cartes enregistrées, ni abonnements, ni mensualités sans frais (MSI) ou paiements en plusieurs fois, ni paiements avec des 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 de paiement, tokenisé par openpay.js avec la vérification antifraude de l'appareil d'OpenPay ; chaque débit passe par 3D Secure.

Payée seulement après confirmation d'OpenPay : le débit est relu depuis l'API d'OpenPay au retour du client depuis 3D Secure et à l'arrivée du webhook.

Contrôle du montant et de la devise : un débit terminé doit correspondre exactement au total du panier et à sa devise. En cas d'écart, la commande passe en OpenPay payment on hold avec une note, sans être marquée comme payée.

Jamais débitée deux fois : un panier ayant déjà une commande 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 : Merchant ID, 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 lesquels le débit a été effectué.

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

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

Bloc OpenPay sur la page de commande : ID du débit, statut, historique des remboursements et notes OpenPay de la commande. Journal facultatif sans clés, données de carte ni données client.

Prérequis

PrestaShop 8.0 à 9.x, PHP 8.0 ou ultérieur, HTTPS. Un compte OpenPay du Mexique, de Colombie ou du Pérou avec son Merchant ID, sa clé privée et sa clé publique (sandbox et production). Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).