VibeFox PagSeguro for PrestaShop

Présentation

VibeFox PagSeguro Gateway connecte PrestaShop à PagBank (anciennement PagSeguro) grâce à la PagBank Checkout API. À l'étape de paiement, le client choisit PagBank ; le module crée un paiement PagBank pour le montant exact du panier et envoie le client sur la page de paiement de PagBank. Il y paie avec les moyens de paiement activés dans votre compte PagBank, comme la carte de crédit, PIX ou boleto, puis revient sur votre boutique. Les paiements ne sont acceptés qu'en réal brésilien (BRL). La commande n'est créée qu'après que PagBank a confirmé le paiement : les paiements abandonnés ne laissent donc aucune commande impayée.

Il convient aux boutiques brésiliennes qui souhaitent utiliser la page de paiement hébergée de PagBank avec des remboursements depuis la page de commande. Le module ne propose ni formulaire de carte sur le site, ni cartes enregistrées, ni abonnements ou paiements récurrents, ni paiements fractionnés. Les moyens de paiement et les paiements en plusieurs fois sont ceux configurés dans votre compte PagBank ; ils ne se choisissent pas dans le module.

Principales fonctionnalités

Page de paiement hébergée par PagBank : aucune donnée de carte sur votre serveur. Le nom, l'adresse e-mail, un numéro de téléphone brésilien et le CPF/CNPJ du client sont pré-remplis sur la page PagBank lorsque la boutique les possède.

Payé uniquement après confirmation de PagBank : les notifications et le retour du client sont vérifiés en lisant le paiement et la commande PagBank via l'API : statut, montant en centavos et devise. Les notifications signées dont la signature est invalide sont rejetées.

Rien à configurer dans PagBank : l'URL de notification est transmise avec chaque paiement.

Contrôle du montant : un paiement dont le montant ou la devise ne correspond pas au panier passe en PagBank payment on hold avec une note. Les intérêts des paiements en plusieurs fois versés par l'acheteur sont pris en compte.

Statuts clairs : les commandes payées passent en Payment accepted ; les PIX ou boletos générés et les paiements en cours d'analyse passent en Awaiting PagBank payment ; les paiements refusés plus tard passent en Payment error et les paiements annulés en Canceled.

Aucun double paiement : payer à nouveau réutilise le paiement PagBank ouvert ou désactive le précédent. Les notifications et les retours répétés ne créent jamais une seconde commande et n'enregistrent jamais le paiement deux fois.

Sandbox et production : jetons distincts. Les vérifications de statut et les remboursements d'une commande utilisent toujours l'environnement dans lequel son paiement a été effectué.

Remboursements depuis la page de commande : remboursements totaux et partiels dans le bloc PagBank payment, jusqu'au montant débité par PagBank, enregistrés uniquement lorsque PagBank les confirme. Un remboursement total place la commande en Refunded.

Prérequis

PrestaShop 8.0 à 9.x, PHP 8.0 ou ultérieur. Réal brésilien (BRL) comme devise du panier. Une boutique accessible depuis Internet en HTTPS. Un compte PagBank avec un jeton de production et un jeton sandbox pour les tests. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).