VibeFox PagSeguro for OpenCart

Présentation

VibeFox PagSeguro Gateway relie OpenCart 3 et OpenCart 4 à l'API Checkout de PagBank (PagSeguro) pour les boutiques au Brésil. À la dernière étape du paiement, le client clique sur Confirm Order, est redirigé vers la page de paiement de PagBank et règle avec les moyens de paiement activés sur son compte PagBank, par exemple carte de crédit, PIX ou boleto. Les paiements ne sont acceptés qu'en réal brésilien (BRL). OpenCart crée la commande avant le paiement, mais la commande ne reçoit un statut qu'après que PagBank a signalé le paiement ; les tentatives non payées restent donc des commandes manquantes.

Elle convient aux boutiques brésiliennes qui souhaitent la page de paiement hébergée de PagBank, avec des remboursements depuis la page de commande d'OpenCart. L'extension ne comporte 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 versements en plusieurs fois sont ceux configurés dans votre compte PagBank.

Principales fonctionnalités

Page de paiement PagBank : un seul paiement pour le total de la commande en BRL. La page de paiement expire au bout de 120 minutes.

Payée seulement après confirmation de PagBank : les notifications et le retour du client déclenchent seulement une vérification. Le checkout, la commande PagBank et ses débits sont toujours lus dans l'API PagBank avec le jeton de l'environnement dans lequel le paiement a été créé.

Notifications signées : lorsque PagBank envoie l'en-tête x-authenticity-token, il est vérifié avec votre jeton ; une signature invalide est rejetée.

Contrôle du montant et de la devise : le montant débité (hors intérêts de versements PagBank) et la devise sont comparés à la commande. Un écart ou un paiement reçu après annulation place la commande dans un statut de vérification, avec une note.

Boleto, PIX et analyse : un boleto ou un PIX généré, ou un paiement en cours d'analyse, place la commande dans un statut d'attente jusqu'à ce que PagBank le signale comme payé.

Un panier, un paiement : lorsque le client paie à nouveau, le checkout PagBank encore ouvert est réutilisé ou désactivé au préalable. Un paiement effectué sur une page précédente compte toujours, et un second paiement est signalé pour remboursement.

Remboursements depuis la page de commande : remboursements totaux et partiels dans l'onglet VibeFox PagSeguro Gateway de la commande, dans la limite du montant réellement débité par PagBank. Les remboursements effectués dans le tableau de bord PagBank sont notés sur la commande.

Sandbox et production : jetons distincts. Les vérifications de statut et les remboursements utilisent toujours l'environnement du paiement. Vos propres statuts de commande OpenCart pour chaque cas.

Prérequis

OpenCart 3.0.x (testé avec 3.0.5.0) ou OpenCart 4.0.2 et ultérieur (testé avec 4.1.0.3), PHP 8.0 ou ultérieur. Un seul téléchargement contient les paquets pour les deux versions. La devise réal brésilien (BRL) dans votre boutique. 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).