VibeFox Pagar.me for PrestaShop

Présentation

VibeFox Pagar.me Gateway relie PrestaShop à l'API Core v5 de Pagar.me (Stone) pour les boutiques au Brésil. À l'étape de paiement, le client choisit Pagar.me, est redirigé vers la page de paiement de Pagar.me et paie par carte de crédit, PIX, boleto ou carte de débit. Les données de carte ne transitent jamais par votre boutique. Les paiements s'effectuent uniquement en réal brésilien (BRL). La commande n'est créée qu'après confirmation du paiement par Pagar.me ou émission d'un PIX ou d'un boleto, de sorte que les paiements abandonnés ne laissent aucune commande impayée.

Il convient aux boutiques brésiliennes qui souhaitent proposer les principaux moyens de paiement locaux sur une seule page hébergée, avec des remboursements depuis la page des commandes de PrestaShop. Le module n'inclut ni formulaire de carte dans votre tunnel de commande, ni cartes enregistrées, ni abonnements ou paiements récurrents, ni règles de versements, ni paiements fractionnés, ni paiements par carte en autorisation seule, ni intégration à Pagar.me Hub.

Principales fonctionnalités

Page de paiement Pagar.me : carte de crédit, PIX, boleto et carte de débit. Vous choisissez les moyens proposés et la durée de validité d'un boleto (de 1 à 30 jours).

Payée uniquement après confirmation de Pagar.me : le webhook et le retour du client indiquent seulement à la boutique quelle commande Pagar.me vérifier. La commande est ensuite lue depuis l'API de Pagar.me avec votre clé secrète.

Contrôle du montant et de la devise : le montant des débits payés est comparé au total du panier. Un écart, un boleto partiellement payé ou un paiement reçu après annulation place la commande en Pagar.me payment on hold, avec une note.

PIX et boleto : un PIX ou un boleto émis crée la commande en Awaiting Pagar.me payment jusqu'à ce que Pagar.me confirme le paiement. Un PIX ou un boleto expiré fait passer la commande en Payment error.

Nouvelles tentatives sûres : lorsque le client paie à nouveau, la page de paiement ouverte est réutilisée ou fermée auprès de Pagar.me au préalable. Un paiement effectué sur une page plus ancienne reste rattaché au panier, et un second paiement est signalé pour remboursement.

Remboursements depuis la page de la commande : remboursements totaux et partiels des paiements par carte et PIX dans le bloc Pagar.me payment, dans la limite du montant effectivement encaissé par Pagar.me. Les remboursements et contestations effectués chez Pagar.me apparaissent sur la commande.

Test et production : clés secrètes distinctes pour le test et la production. Les vérifications de statut et les remboursements utilisent toujours la clé du mode dans lequel le paiement a été créé.

Bloc Pagar.me sur la page de la commande : la commande Pagar.me, le moyen de paiement, le statut, les montants payés et remboursés, l'historique des remboursements et les notes Pagar.me de la commande. Journal facultatif sans clés ni données clients.

Prérequis

PrestaShop 8.0 à 9.x, PHP 8.0 ou ultérieur. Devise de la boutique : réal brésilien (BRL). Un compte Pagar.me avec les clés secrètes de test et de production, et un webhook. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).