VibeFox Vindi for OpenCart

Présentation

VibeFox Vindi Gateway relie OpenCart 3 et OpenCart 4 à l'API de Vindi pour les boutiques du Brésil qui vendent en réal brésilien (BRL). Les clients paient par carte de crédit sur la page de facture de 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 reçoit immédiatement votre statut en attente, et le client obtient le lien du boleto et les codes PIX sur la page de succès, dans son compte et dans l'e-mail de commande.

Elle convient aux boutiques brésiliennes qui ont déjà un compte Vindi et veulent des paiements ponctuels sans créer de formulaire de carte. Pour les paiements par carte, OpenCart crée la commande avant le paiement, mais la commande n'obtient un statut qu'après la confirmation du paiement par Vindi ; les tentatives non payées restent donc des commandes manquantes. L'extension n'accepte que les paiements uniques en une seule échéance. Elle ne prend en charge ni abonnements ni facturation récurrente, ni cartes enregistrées, ni paiements en plusieurs fois (parcelamento), ni formulaire de carte sur votre site, et elle 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 qui sont proposés à la commande.

Champ CPF / CNPJ : demandé à la commande pour le boleto et le PIX, et vérifié au moyen de ses chiffres de contrôle. Il est prérempli à partir d'un champ personnalisé CPF ou CNPJ du client lorsque c'est possible.

Payée uniquement après confirmation de Vindi : le paiement n'est accepté qu'après que l'extension a relu la facture depuis l'API de Vindi et vérifié la devise, le code de commande, le client Vindi et le montant exact. En cas d'écart, la commande passe en suspens 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 de Vindi.

Aucun double paiement : un panier n'est payé qu'une fois. Une nouvelle tentative réutilise la facture Vindi en attente ou l'annule au préalable. Lorsque vous annulez une commande non payée dans OpenCart, sa facture Vindi est également annulée.

Production et sandbox : clés d'API distinctes. 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 l'onglet de l'extension sur la page de commande, jusqu'au montant effectivement débité par Vindi. Un remboursement total place la commande dans votre statut remboursé.

Conditions OpenCart : zone géographique, total minimum de commande, ordre de tri et vos propres statuts de commande. Le journal ne contient ni clés 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é sur 4.1.0.3), PHP 8.0 ou ultérieur. Un seul téléchargement contient les paquets pour les deux versions. La devise réal brésilien (BRL) dans la boutique. Un compte Vindi avec une clé d'API (et un compte sandbox Vindi pour les tests). Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).