VibeFox Flutterwave for OpenCart

Présentation

VibeFox Flutterwave Payment ajoute à OpenCart 3 et OpenCart 4 les paiements Flutterwave via la page de paiement hébergée de Flutterwave (Flutterwave Standard, API v3). À la dernière étape du paiement, le client clique sur Confirm Order, est redirigé vers la page de Flutterwave, règle avec n'importe quel moyen activé sur votre compte Flutterwave, comme les cartes, le virement bancaire, l'USSD ou le mobile money, puis revient dans votre boutique. OpenCart crée la commande avant le paiement, mais la commande ne reçoit un statut qu'une fois que Flutterwave confirme le paiement ; les tentatives non payées restent donc des commandes manquantes.

Elle convient aux boutiques du Nigeria, du Ghana, du Kenya, d'Afrique du Sud, d'Afrique de l'Est et d'Afrique francophone, ainsi qu'aux boutiques qui acceptent les cartes internationales. La commande est toujours débitée dans la devise de la commande. L'extension ne gère que les paiements uniques. Elle ne propose ni paiement intégré ou modal sur votre site, ni cartes enregistrées, abonnements, paiements fractionnés ou échéanciers, et les remboursements effectués dans le tableau de bord Flutterwave ne sont pas synchronisés avec OpenCart.

Principales fonctionnalités

Paiement hébergé : un paiement est créé pour le total de la commande dans la devise de la commande, arrondi à la précision de la devise (XOF, XAF, UGX, RWF et d'autres n'ont pas de décimales). Vous pouvez limiter les options de paiement affichées sur la page Flutterwave.

Payée seulement après confirmation de Flutterwave : ni l'URL de retour ni le contenu du webhook ne sont considérés comme fiables. Chaque paiement est relu auprès de Flutterwave depuis votre serveur, et la commande n'est marquée payée que si le statut est réussi et si le montant et la devise correspondent. OpenCart envoie ensuite ses e-mails de commande habituels.

Webhooks signés : les webhooks ne sont acceptés qu'avec votre hash secret. Ils confirment le paiement même si le client ferme son navigateur.

Aucun traitement en double : les webhooks et retours répétés n'appliquent jamais un paiement deux fois. Avant une nouvelle tentative, les paiements ouverts de la commande et du panier sont vérifiés ; un ancien lien de paiement réglé plus tard reste accepté, et un second paiement pour une commande déjà réglée est signalé pour remboursement.

Moyens de paiement en attente gérés : un virement bancaire, un paiement USSD ou mobile money encore en attente au retour du client place la commande en statut d'attente jusqu'à ce que Flutterwave le confirme.

Remboursements depuis la page de commande : remboursements totaux et partiels dans l'onglet VibeFox Flutterwave Payment de la commande, pour le montant et dans la devise débités par Flutterwave, avec la clé du mode dans lequel le paiement a été effectué.

Test et production : clés secrètes distinctes. Une clé de test en mode production, ou une clé de production en mode test, masque le moyen de paiement et affiche un avertissement.

Paramètres OpenCart : vos propres statuts de commande, saisie automatique facultative, zone géographique, montant minimum de commande et ordre de tri. Journal facultatif sans 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. Un compte Flutterwave avec ses clés secrètes et un webhook avec un hash secret. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).