VibeFox Conekta for OpenCart

Présentation

VibeFox Conekta Gateway ajoute à OpenCart 3 et OpenCart 4 les paiements via Conekta (Mexique). À la dernière étape de la commande, le client clique sur Confirm Order, est envoyé sur la page de paiement sécurisée et hébergée de Conekta, puis paie par carte de crédit ou de débit, en espèces chez OXXO et d'autres magasins, par virement bancaire SPEI ou via BNPL, selon ce que vous autorisez. Le client revient ensuite sur votre boutique. Les données de carte ne transitent jamais par votre site. OpenCart crée la commande avant le paiement, mais la commande ne reçoit un statut qu'après que Conekta a confirmé le paiement ou émis une référence OXXO ou SPEI ; les tentatives non payées restent donc des commandes manquantes.

Elle convient aux boutiques mexicaines qui vendent en MXN ou en USD et souhaitent proposer les paiements par carte et en espèces dans une seule méthode, avec un compte Conekta. L'extension ne gère que les paiements uniques. Elle n'affiche pas de formulaire de carte sur votre page de paiement et ne prend pas en charge les cartes enregistrées, les abonnements, la pré-autorisation suivie de capture, ni les paiements en plusieurs fois (MSI). Les remboursements ou contestations effectués dans le panneau Conekta sont seulement notés sur la commande, pas enregistrés automatiquement.

Principales fonctionnalités

Page de paiement hébergée Conekta : une commande Conekta est créée pour le total de la commande, dans la devise de la commande, avec les produits, les remises, les taxes et la livraison. Espèces, SPEI et BNPL sont proposés pour les commandes en MXN ; les commandes en USD n'acceptent que les cartes.

Payée uniquement lorsque Conekta confirme : le webhook comme le retour du client déclenchent seulement une lecture de la commande via l'API Conekta avec votre clé privée. Rien dans une notification ou dans l'URL de retour n'est tenu pour fiable. OpenCart envoie ensuite ses e-mails habituels de commande.

Contrôle du montant et de la devise : le montant en centimes et la devise sont comparés à la commande. Toute différence, ou un paiement en mode test reçu alors que la boutique est en production, place la commande dans votre statut de mise en attente pour vérification.

OXXO et SPEI : lorsque le client reçoit une référence de paiement, la commande prend votre statut d'attente de paiement, puis passe au statut payé lorsque Conekta signale le paiement.

Aucun double traitement : les notifications répétées ou simultanées n'appliquent jamais un paiement deux fois. Avant une nouvelle tentative, les précédents paiements Conekta du panier sont réutilisés, confirmés s'ils sont déjà payés, ou annulés, de sorte qu'un ancien lien ne puisse pas être payé deux fois.

Modes test et production : des clés privées distinctes pour chaque mode et un avertissement MODE TEST sur la page de paiement. Les notifications et les remboursements utilisent toujours la clé du mode dans lequel le paiement a été effectué.

Remboursements depuis la page de commande : remboursements totaux et partiels dans l'onglet VibeFox Conekta Gateway de la commande, jusqu'au montant que Conekta a réellement encaissé. Un remboursement total définit le statut Refunded.

Conditions OpenCart : vos propres statuts de commande, zone géographique, montant minimum de commande et ordre d'affichage. Journal facultatif, sans clés API ni données de contact des clients.

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. Un même téléchargement contient les paquets pour les deux versions. Devise de paiement MXN ou USD. Un compte Conekta avec des clés privées de test et de production et un webhook dans le panneau Conekta. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).