VibeFox Vindi for PrestaShop

Présentation

VibeFox Vindi Gateway relie PrestaShop à l'API Vindi pour les boutiques du Brésil qui vendent en réal brésilien (BRL). Le client paie par carte de crédit sur la page de facturation Vindi, ou par boleto, PIX ou BolePix (boleto + PIX). Les données de carte ne transitent jamais par votre site. Pour le boleto et le PIX, la commande reste en Awaiting Vindi payment, et le client reçoit le lien du boleto et les codes PIX sur la page de confirmation de commande, dans son compte et dans l'e-mail.

Ce module convient aux boutiques brésiliennes qui disposent déjà d'un compte Vindi et souhaitent des paiements ponctuels sans créer de formulaire de carte. Pour les paiements par carte, la commande n'est créée qu'après que Vindi a confirmé le paiement : les paiements abandonnés ne laissent donc aucune commande impayée. Le module ne prend que des paiements uniques en une seule échéance. Il ne gère ni abonnements ni facturation récurrente, ni cartes enregistrées, ni parcelamento (paiement en plusieurs fois), ni formulaire de carte sur votre site, et il ne peut pas rembourser les paiements par boleto.

Principales fonctionnalités

Quatre moyens de paiement : carte de crédit, boleto, PIX et BolePix. Vous choisissez ceux proposés au paiement.

Champ CPF / CNPJ : demandé au paiement pour le boleto et le PIX, et vérifié grâce à ses chiffres de contrôle. Il est prérempli à partir de l'adresse du client lorsque c'est possible.

Payée seulement après confirmation de Vindi : le paiement n'est accepté qu'après que le module a relu la facture depuis l'API Vindi et vérifié la devise, le code du panier, le client Vindi et le montant exact. En cas de différence, la commande est suspendue avec une note.

Webhook protégé : l'URL du webhook contient un jeton secret, et chaque notification déclenche seulement une nouvelle vérification via l'API Vindi.

Aucun double paiement : une nouvelle tentative réutilise la facture Vindi en attente ou l'annule d'abord. Lorsqu'une commande non payée est annulée dans la boutique, sa facture Vindi l'est aussi.

Production et sandbox : clés API séparées. Chaque paiement mémorise l'endroit où sa facture a été créée, de sorte que les vérifications et les remboursements utilisent toujours cet environnement.

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

Bloc Vindi sur la page de commande : les factures du panier, l'historique des remboursements et les notes du module.

Prérequis

PrestaShop 8.0 à 9.x, PHP 8.0 ou ultérieur, devise de la boutique : réal brésilien (BRL). Un compte Vindi avec une clé API (et un compte de test Vindi sandbox pour les essais). Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).