VibeFox Flutterwave for PrestaShop

Présentation

VibeFox Flutterwave Payment ajoute les paiements Flutterwave à PrestaShop via la page de paiement hébergée de Flutterwave (Flutterwave Standard, API v3). À l'étape de paiement, le client choisit Flutterwave, est redirigé vers la page de Flutterwave, paie avec l'un des moyens activés sur votre compte Flutterwave, par exemple carte, virement bancaire, USSD ou mobile money, puis revient sur votre boutique. La commande n'est créée qu'après que Flutterwave a confirmé le paiement, de sorte que les paiements abandonnés ne laissent aucune commande impayée.

Elle convient aux boutiques du Nigeria, du Ghana, du Kenya, d'Afrique du Sud, d'Afrique de l'Est et francophone, ainsi qu'aux boutiques qui acceptent les cartes internationales. Le panier est toujours débité dans la devise du panier. Le module n'accepte que les paiements ponctuels. Il ne propose ni paiement intégré ou dans une fenêtre modale sur votre site, ni cartes enregistrées, abonnements, paiements fractionnés ou plans de paiement, et les remboursements effectués dans le tableau de bord Flutterwave ne sont pas synchronisés avec PrestaShop.

Principales fonctionnalités

Paiement hébergé : un paiement est créé pour le total du panier dans sa devise, 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 de 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 la référence appartient au panier, si le statut indique une réussite et si le montant et la devise correspondent.

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

Aucun double traitement : les webhooks et retours répétés ne créent jamais de seconde commande et n'enregistrent jamais le paiement deux fois. Un ancien lien de paiement réglé plus tard reste accepté, et un second paiement pour une commande déjà payée est signalé pour remboursement.

Gestion des moyens de paiement en attente : un virement bancaire, un paiement USSD ou mobile money encore en attente place la commande en Awaiting Flutterwave payment jusqu'à ce que Flutterwave le confirme.

Remboursements depuis la page de commande : remboursements totaux et partiels dans le bloc Flutterwave payment de la commande, au 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.

Bloc Flutterwave sur la page de commande : référence, transaction, mode, historique des remboursements et notes Flutterwave de la commande. Journal facultatif, sans clés ni données client.

Prérequis

PrestaShop 8.0 à 9.x, PHP 8.0 ou ultérieur. Un compte Flutterwave avec ses clés secrètes et un webhook avec un hachage secret. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).