VibeFox Iugu for PrestaShop

Présentation

VibeFox Iugu Gateway ajoute à PrestaShop les paiements Iugu pour les boutiques au Brésil. À l'étape de paiement, le client choisit Iugu : le module crée une facture Iugu pour le total du panier et envoie le client sur la page de facture Iugu, où la facture est payée par carte de crédit, boleto bancário ou PIX. Les données de carte ne transitent jamais par votre site. La commande n'est créée que lorsqu'Iugu signale le paiement, ou lorsque le client revient après l'émission d'un boleto ou d'un code PIX.

Il convient aux boutiques brésiliennes qui vendent en réal brésilien (BRL) et disposent d'un compte Iugu. Le module ne gère que les paiements uniques. Il ne propose pas de formulaire de carte sur le site, de cartes enregistrées, d'abonnements ni de facturation récurrente, de carnês de paiement (carnê), de paiements fractionnés ni d'options de paiement en plusieurs fois dans PrestaShop.

Principales fonctionnalités

Page de facture Iugu: une facture est créée pour le total du panier en BRL. Le client paie avec n'importe quel moyen activé dans votre compte Iugu : carte de crédit, boleto ou PIX.

Payée uniquement après confirmation d'Iugu: la notification et le retour du client indiquent seulement à la boutique quelle facture vérifier. La facture est toujours relue depuis l'API Iugu, et son statut, son montant et sa devise sont comparés au panier. En cas d'écart, la commande passe en Iugu payment on hold.

Rien à configurer dans Iugu: chaque facture contient l'URL de notification de votre boutique.

Pas de double traitement: chaque statut de facture n'est appliqué qu'une fois ; les notifications et les retours répétés ne peuvent donc jamais créer une deuxième commande ni enregistrer le paiement deux fois. Une nouvelle tentative de paiement réutilise la facture ouverte ou l'annule d'abord dans Iugu, et un paiement en double est signalé pour remboursement.

Compatible boleto et PIX: un client qui revient avec un code boleto ou PIX obtient une commande en Awaiting Iugu payment, qui passe en Payment accepted lorsqu'Iugu signale l'encaissement.

Jetons de test et de production: des jetons d'API distincts pour chaque mode. Les vérifications de statut et les remboursements utilisent toujours le jeton du mode dans lequel la facture a été créée.

Remboursements depuis la page de commande: carte de crédit, total ou partiel ; PIX, total uniquement, dans le bloc Iugu payment de la commande. Les remboursements effectués dans le tableau de bord Iugu passent la commande en Refunded.

Bloc Iugu sur la page de commande: la facture avec un lien vers Iugu, le moyen de paiement, les montants encaissés et remboursés, l'historique des remboursements et les notes du module. Journal optionnel sans jetons ni données client.

Prérequis

PrestaShop 8.0 à 9.x, PHP 8.0 ou ultérieur. Réal brésilien (BRL) comme devise du panier. Un compte Iugu avec un jeton d'API de test et un jeton de production. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).