VibeFox Conekta for PrestaShop

Présentation

VibeFox Conekta Gateway ajoute à PrestaShop les paiements via Conekta (Mexique). À l'étape de paiement, le client choisit Conekta, est redirigé vers la page de paiement sécurisée hébergée par Conekta et paie par carte de crédit ou de débit, en espèces chez OXXO et dans d'autres magasins, par virement bancaire SPEI ou via BNPL, selon les options que vous autorisez. Le client revient ensuite dans votre boutique. Les données de carte n'atteignent jamais votre site. La commande n'est créée qu'après que Conekta a confirmé le paiement ou émis une référence OXXO ou SPEI, de sorte que les paiements abandonnés ne laissent aucune commande impayée.

Elle convient aux boutiques mexicaines qui vendent en MXN ou en USD et souhaitent accepter les cartes et les paiements en espèces avec une seule méthode et un compte Conekta. Le module ne prend en charge que les paiements uniques. Il n'affiche aucun formulaire de carte sur votre page de paiement et ne gère ni cartes enregistrées, ni abonnements, ni pré-autorisation et capture, ni paiements échelonnés mensuels (MSI). Les remboursements ou rétrofacturations effectués dans le tableau de bord Conekta sont seulement notés sur la commande, sans être enregistrés automatiquement.

Principales fonctionnalités

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

Payée seulement après confirmation de Conekta : le webhook comme le retour du client déclenchent uniquement la lecture de la commande depuis l'API Conekta, avec votre clé privée. Rien dans une notification ni dans l'URL de retour n'est considéré comme fiable.

Vérification du montant et de la devise : le montant en centimes et la devise sont comparés au panier. Toute différence, ou un paiement en mode test reçu alors que la boutique est en mode production, place la commande en Conekta payment on hold pour examen.

OXXO et SPEI : lorsque le client reçoit une référence de paiement, la commande est créée avec le statut Awaiting Conekta payment et passe à Payment accepted lorsque Conekta signale le paiement.

Aucun traitement en double : les notifications répétées ou simultanées ne créent jamais une deuxième commande et n'enregistrent jamais deux fois le paiement. Une page de paiement Conekta encore ouverte est réutilisée ou annulée avant la création d'une nouvelle, afin qu'un ancien lien ne puisse pas être payé deux fois.

Modes test et production : clés privées distinctes pour chaque mode et mention TEST MODE au moment du paiement. Les remboursements et les notifications utilisent toujours la clé du mode dans lequel le paiement a été effectué.

Remboursements depuis la page de commande : remboursements totaux et partiels dans le bloc Conekta payment de la commande, dans la limite du montant réellement encaissé par Conekta. Un remboursement total place la commande en Refunded.

Bloc Conekta sur la page de commande : la commande Conekta, le débit, le statut, les montants, l'historique des remboursements et les notes du module. Journal facultatif sans clés API ni données de contact client.

Prérequis

PrestaShop 8.0 à 9.x, PHP 8.0 ou ultérieur. Devise du panier MXN ou USD. Un compte Conekta avec des clés privées de test et de production, et un webhook dans le tableau de bord Conekta. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).