VibeFox PagSeguro for OpenCart — Aide

Prérequis

OpenCart: 3.0.x (testé avec 3.0.5.0) ou 4.0.2 et ultérieur (testé avec 4.1.0.3).

PHP: 8.0 ou ultérieur.

Currency: réal brésilien (BRL). La boutique doit disposer de la devise BRL (System > Localisation > Currencies), et le mode de paiement n'est affiché que lorsque le client passe commande en BRL.

Reachable site: votre boutique doit être accessible depuis Internet pour que PagBank puisse envoyer les notifications de paiement.

PagBank account: un jeton de production pour les paiements réels et un jeton sandbox pour les tests. Production : connectez-vous à votre compte PagBank, ouvrez Venda online > Integrações et cliquez sur Gerar token ; PagBank envoie le jeton par e-mail. Sandbox : copiez le jeton de votre compte sandbox dans le portail développeurs de PagBank. Les jetons sandbox et de production ne fonctionnent que dans leur propre environnement.

VibeFox license key: achetée sur vibefox.net. Une clé fonctionne sur un seul domaine.

Installation

Le téléchargement est un fichier ZIP unique contenant les paquets pour les deux versions d'OpenCart. Décompressez-le sur votre ordinateur. Il contient README.txt, le paquet OpenCart 3 wcp_pagseguro_gateway-oc3-(version).ocmod.zip et le paquet OpenCart 4 wcp_pagseguro_gateway.ocmod.zip. Installez uniquement le paquet correspondant à votre version d'OpenCart. La clé de licence est la même pour les deux versions.

OpenCart 3

1. Dans l'administration, allez dans Extensions > Installer, cliquez sur Upload et choisissez le fichier wcp_pagseguro_gateway-oc3-(version).ocmod.zip. L'extension ne contient aucune modification OCMOD, il n'est donc pas nécessaire d'actualiser Extensions > Modifications. Au lieu de l'installateur, vous pouvez aussi copier le contenu du dossier upload de ce paquet dans le dossier racine de votre boutique.

2. Allez dans Extensions > Extensions et choisissez le type Payments. Repérez VibeFox PagSeguro Gateway et cliquez sur Install (le bouton vert +). Votre utilisateur administrateur doit avoir le droit de modifier la liste des extensions de paiement.

3. Cliquez sur Edit (le bouton en forme de crayon) pour ouvrir la page des paramètres. Collez votre clé de licence VibeFox dans License key, dans le bloc de licence en haut de la page, puis cliquez sur Activate (voir Clé de licence).

4. Saisissez le jeton sandbox et, pour encaisser de vrais paiements, le jeton de production. Vous n'avez rien à configurer dans PagBank : l'URL de notification est envoyée avec chaque paiement.

5. Activez Enable / Disable et cliquez sur Save. Effectuez des paiements de test avec Sandbox Mode activé, puis désactivez-le pour encaisser de vrais paiements.

OpenCart 4

1. Dans l'administration, allez dans Extensions > Installer, cliquez sur Upload et choisissez le fichier wcp_pagseguro_gateway.ocmod.zip. Ne renommez pas le fichier : OpenCart 4 tire le code de l'extension du nom du fichier, et un paquet renommé ne fonctionne pas.

2. Le paquet apparaît dans la liste des extensions installées, sur la même page. Cliquez sur Install (le bouton vert +) à côté de lui.

3. Allez dans Extensions > Extensions et choisissez le type Payments. Repérez VibeFox PagSeguro Gateway, cliquez sur Install (le bouton vert +), puis sur Edit (le bouton en forme de crayon).

4. Saisissez la clé de licence et les jetons, puis testez les paiements comme aux étapes 3 à 5 pour OpenCart 3. La page des paramètres et ses champs sont identiques dans les deux versions. Seule l'URL de notification diffère (voir Notification URL) ; elle est également envoyée à PagBank avec chaque paiement.

Une nouvelle installation démarre avec le mode de paiement désactivé et le mode sandbox activé.

Configuration

Tous les paramètres se trouvent sur la page de l'extension : Extensions > Extensions > Payments > VibeFox PagSeguro Gateway > Edit. Les sections sont listées à gauche ; le bouton Save situé sous la liste enregistre la page entière. Au-dessus des paramètres, la page affiche le mode en cours : SANDBOX MODE (les paiements sont créés dans le sandbox PagBank, sans débit réel) ou LIVE (les paiements sont créés avec le jeton de production). Elle vous avertit lorsque le jeton du mode en cours est absent (le mode de paiement est alors masqué lors du passage en caisse) et lorsque la devise par défaut de la boutique n'est pas BRL. Sans le droit de modifier l'extension, la page affiche les paramètres mais ne peut pas les enregistrer.

Lors de l'enregistrement, Title ne peut pas être vide (128 caractères maximum), Sort Order doit être un nombre entier (les nombres négatifs sont acceptés), Total doit être un nombre égal ou supérieur à 0, et la zone géographique ainsi que les statuts de commande doivent exister. Si une valeur est incorrecte, un message d'erreur la signale et rien n'est enregistré.

PagSeguro / PagBank

Enable / Disable: Enable PagSeguro/PagBank payments active ou désactive le mode de paiement. Par défaut : désactivé.

Title: le nom du mode de paiement que voient les clients lors du passage en caisse. C'est aussi le nom du mode de paiement enregistré dans la commande. Par défaut : PagSeguro / PagBank. Obligatoire, 128 caractères maximum.

Description: le texte affiché au client à l'étape Confirm Order, au-dessus du bouton de confirmation. Par défaut : Pay securely via PagSeguro/PagBank. You will be redirected to complete your payment.

Sort Order: la position de PagBank parmi les modes de paiement lors du passage en caisse. Laissez le champ vide ou saisissez un nombre entier.

Geo Zone: proposer PagBank uniquement pour les adresses de facturation situées dans la zone géographique sélectionnée. Par défaut : All zones. Les zones géographiques se configurent dans System > Localisation > Geo Zones. Sur OpenCart 4, si la boutique ne demande aucune adresse de facturation, l'adresse de livraison est utilisée.

Total: le montant total du panier, dans la devise par défaut de la boutique, que doit atteindre une commande pour que PagBank soit proposé. Laissez le champ vide pour proposer PagBank quel que soit le montant.

Compte PagBank

Cette section explique où obtenir les jetons et renvoie vers votre compte PagBank ainsi que vers la page PagBank consacrée aux jetons.

Sandbox Mode: Enable sandbox/test mode (no real charges). Les nouveaux paiements sont envoyés au sandbox PagBank avec le jeton sandbox, et les clients voient SANDBOX MODE — Using test environment. No real charges. à l'étape Confirm Order. Les vérifications de statut et les remboursements d'une commande utilisent toujours l'environnement et le jeton dans lesquels son paiement a été créé. Par défaut : activé.

Sandbox token: le jeton sandbox PagBank. Il est utilisé tant que le mode sandbox est activé.

Production token: le jeton de production PagBank (Bearer). Il est utilisé lorsque le mode sandbox est désactivé. Gardez-le confidentiel.

Les jetons enregistrés ne sont jamais affichés à nouveau. Le champ reste vide et affiche Saved — leave empty to keep it. Ne saisissez une nouvelle valeur que si vous souhaitez la modifier. Pour supprimer un jeton enregistré, cochez Clear the saved token on save sous le champ et cliquez sur Save.

Notifications de paiement

Notification URL: à chaque paiement, PagBank est invité à envoyer ses notifications de commande et de paiement à cette URL ; il n'y a donc rien à configurer dans PagBank. Sur OpenCart 3, elle ressemble à https://your-store/index.php?route=extension/payment/wcp_pagseguro_gateway/webhook, et sur OpenCart 4 à https://your-store/index.php?route=extension/wcp_pagseguro_gateway/payment/wcp_pagseguro_gateway.webhook. Elle est construite à partir de l'adresse de la vitrine de votre installation OpenCart. L'URL doit être accessible depuis Internet.

Les notifications qui contiennent un en-tête x-authenticity-token sont vérifiées avec le jeton de l'environnement dans lequel le paiement a été créé ; une signature non valide est rejetée. Le contenu de la notification n'est jamais considéré comme fiable : l'extension lit toujours la commande et la commande PagBank (statut, montant, devise) auprès de l'API PagBank avant de modifier la commande. Sans notifications, la commande reçoit son statut lorsque le client revient dans la boutique après avoir payé.

Commandes

OpenCart crée la commande à l'étape Confirm Order sans statut (commande manquante). La commande ne reçoit un statut qu'après que PagBank a signalé le paiement, par une notification ou lors du retour du client ; le paiement est toujours relu depuis PagBank. Chaque champ ci-dessous indique vos statuts de commande OpenCart.

Order Status After Payment: le statut attribué après un paiement PagBank vérifié. Par défaut : Processing.

Awaiting PagBank Payment Status: un boleto ou un PIX a été émis, ou le paiement est en cours d'analyse (WAITING / IN_ANALYSIS) ; PagBank confirme l'argent plus tard. Par défaut : Pending.

PagBank Payment On Hold Status: le paiement nécessite votre vérification (voir Statuts de commande). Par défaut : Pending, car OpenCart n'a pas de statut On hold. Vous pouvez créer votre propre statut dans System > Localisation > Order Statuses et le sélectionner ici.

Payment Declined Status: le paiement d'une commande en attente a été refusé. Si PagBank signale ensuite qu'il a été payé, la commande reçoit le statut prévu après paiement. Par défaut : Failed.

Payment Cancelled Status: le paiement d'une commande en attente a été annulé dans PagBank. Un paiement qui arrive pour une commande dans ce statut la place dans le statut de vérification. Par défaut : Canceled.

Refunded Status: défini une fois le paiement entièrement remboursé depuis la page de la commande ou dans le tableau de bord PagBank. Par défaut : Refunded.

Avancé

Debug log: écrit les requêtes API et les notifications dans wc_psg_debug.log.php, dans le dossier des journaux d'OpenCart (storage/logs). Le fichier ne peut pas être ouvert depuis le web. Les journaux ne contiennent ni jetons ni données clients. Les erreurs et les avertissements sont toujours journalisés. Par défaut : désactivé.

Log: affiche la taille et les dernières entrées du journal. Cliquez sur Clear log pour le vider.

Delete Data on Uninstall: lorsque l'option est activée, la désinstallation de l'extension supprime les paramètres de la passerelle et le journal. Les commandes et leurs références PagBank (nécessaires aux remboursements) sont toujours conservées. Par défaut : désactivé.

Importation / exportation

Export: Download JSON enregistre les paramètres dans un fichier JSON. Les jetons ne sont pas exportés.

Import: collez le JSON précédemment exporté et cliquez sur Import pour restaurer les paramètres. Les jetons enregistrés sont conservés.

Paiement

À l'étape Payment Method, le client choisit le mode de paiement (par défaut PagSeguro / PagBank). À l'étape Confirm Order, le client voit votre description et la mention You will be redirected to the PagBank payment page (credit card, PIX, boleto) and returned to the store. OpenCart crée la commande à cette étape, toujours sans statut. Sur OpenCart 4, le client choisit le mode de paiement avec le bouton Choose du bloc du mode de paiement, dans la fenêtre Payment method options, puis clique sur Confirm Order en bas de la page de passage en caisse. Lorsque le client clique sur Confirm Order, l'extension crée un paiement PagBank pour le total de la commande en BRL, comme un seul article, Order # avec le numéro de commande et le nom de votre boutique (les coupons, la livraison et les taxes sont inclus dans le total), puis envoie le client sur la page de paiement PagBank. Le nom et l'adresse e-mail du client sont transmis, ainsi que le CPF ou le CNPJ (11 ou 14 chiffres) provenant d'un champ personnalisé du client ou de l'adresse de facturation dont le nom contient CPF ou CNPJ, et un numéro de téléphone brésilien. OpenCart n'a pas de champ CPF par défaut ; vous pouvez en ajouter un dans Customers > Custom Fields. Sur OpenCart 4, si la boutique ne demande aucune adresse de facturation, l'adresse de livraison et ses champs personnalisés sont utilisés. Le client peut compléter ou corriger ces informations sur la page PagBank et paie avec les moyens activés dans votre compte PagBank. La page de paiement expire au bout de 120 minutes.

Après le paiement, le client revient dans votre boutique. La commande n'est marquée comme payée qu'une fois PagBank l'a confirmé : l'extension relit le paiement depuis l'API PagBank lorsque la notification arrive ou lorsque le client revient, et le montant débité (hors intérêts de paiement en plusieurs fois de PagBank) ainsi que la devise doivent correspondre à la commande. La commande reçoit ensuite son statut de la manière habituelle d'OpenCart, avec les e-mails de commande habituels et la mise à jour des stocks, et le client voit la page de confirmation de commande d'OpenCart. Pour un boleto ou un PIX généré, ou un paiement en cours d'analyse, la page affiche aussi Your PagBank payment is awaiting confirmation (boleto / PIX / analysis). The order will be confirmed as soon as PagBank reports the payment. Pour une commande dans le statut de vérification, elle affiche We are confirming your payment with PagBank. The order will be updated automatically — please do not pay again. Si PagBank n'a pas encore confirmé le paiement lorsque le client revient, une page Payment confirmation affiche le même texte, avec les boutons Check again et Back to checkout.

Si le paiement n'a pas été finalisé, le client revient à la caisse avec The PagBank payment was not completed. You can try again or choose another payment method., The PagBank payment page has expired. You can try again or choose another payment method. ou The payment was declined by PagBank. Please try again with another card or payment method. Le panier est conservé. Sur OpenCart 4, ces messages s'affichent au-dessus de la page de passage en caisse. Si une commande qui attendait un boleto ou un PIX a été annulée, le client voit The PagBank payment was cancelled, so the order was cancelled. Si le panier est déjà vide (par exemple parce que la commande avait atteint la page de confirmation avant l'expiration du boleto ou du PIX), il n'y a rien à payer à la caisse : une page Payment confirmation affiche le message à la place ; pour une commande non payée, il s'agit de The PagBank payment of order #N was not completed (declined, canceled or expired), so the order will not be shipped. To buy these items, please place a new order., avec un bouton Continue.

OpenCart 3 crée une nouvelle commande à chaque affichage de l'étape Confirm Order. OpenCart 4 conserve une seule commande pour le passage en caisse et la met à jour ; ainsi, après une carte refusée, un paiement inachevé ou une page expirée, le client règle la même commande avec un nouveau paiement PagBank. Avant un nouveau paiement, l'extension vérifie les précédents paiements PagBank de la même commande et du même panier : un paiement effectué sur une page antérieure est pris en compte au lieu d'en créer un nouveau, et si une autre commande du panier est payée ou en attente, le client est dirigé vers la page de confirmation. Le paiement ouvert de la commande est réutilisé si le montant et l'environnement sont identiques et s'il n'expire pas dans les 10 minutes ; sinon, il est désactivé et ne peut plus être payé. Si un second paiement arrive malgré tout, une note vous invite à le rembourser.

Si la commande a été payée puis fermée par vous (par exemple annulée ou remboursée), le client qui revient de PagBank ne voit pas la page de confirmation de commande : il revient au passage en caisse avec Your previous order #(number) was closed by the store. Please confirm the order again to pay with a new order., ou voit ce message sur une page Payment confirmation lorsque le panier est déjà vide.

OpenCart 4 conserve la commande dans le passage en caisse jusqu'à l'affichage de la page de confirmation de commande. Si cette commande a été fermée entre-temps, Confirm Order renvoie le client au passage en caisse avec le message correspondant : les messages sur un boleto ou un PIX annulé et sur un paiement refusé ci-dessus, Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. ou, pour une commande payée puis fermée par vous, le message sur la commande fermée par la boutique. Le Confirm Order suivant règle une nouvelle commande. Si cette commande est déjà payée ou en attente et que le panier contient désormais d'autres produits ou quantités, le message est Your previous order #(number) has already been placed. Your cart has changed: please confirm the new order to pay for it.

Si PagBank ne peut pas démarrer le paiement, le client reste à l'étape Confirm Order avec un bref message, par exemple PagBank did not accept your billing details (CPF/CNPJ). Please check them and try again. ou Could not connect to PagBank. Please try again in a moment. La raison technique est inscrite dans le journal.

Les notifications fonctionnent aussi lorsque la boutique est en mode maintenance : OpenCart 3 laisse passer les requêtes des extensions de paiement, et sur OpenCart 4 l'extension ajoute une action startup qui laisse passer les notifications et le retour du client depuis PagBank.

L'extension ne comporte pas de formulaire de carte sur le site, ni de cartes enregistrées, ni d'abonnements ou de paiements récurrents, ni de paiements fractionnés ou de places de marché. Les modes de paiement et les paiements en plusieurs fois sont ceux configurés dans votre compte PagBank.

Commandes et remboursements

Statuts de commande

No status (missing order): le client a été envoyé vers PagBank et n'a pas payé, la carte a été refusée ou la page de paiement a expiré ; le client peut payer à nouveau. Dans Sales > Orders, ces commandes ne s'affichent qu'avec le filtre Order Status réglé sur Missing Orders.

Sur OpenCart 4, une commande non payée du passage en caisse peut recevoir le statut Voided, que OpenCart 4 attribue lorsque le client revient à l'étape Confirm Order. L'extension traite cette commande comme une commande sans statut, et un paiement ultérieur la confirme toujours.

Order Status After Payment (default Processing): le paiement a été confirmé avec le montant et la devise attendus. Une note indique le montant, le mode de paiement et l'identifiant de transaction PagBank.

Awaiting PagBank Payment Status (default Pending): un boleto ou un PIX a été généré et attend d'être payé, ou le paiement est en cours d'analyse. La commande passe au statut Order Status After Payment lorsque PagBank signale le paiement comme effectué.

PagBank Payment On Hold Status (default Pending): PagBank a signalé un montant ou une devise différent de celui de la commande, un paiement est arrivé après l'annulation de la commande (vérifiez le stock, puis finalisez la commande ou remboursez le paiement dans PagBank), ou un paiement par carte a été autorisé mais pas capturé (capturez-le dans PagBank). La note l'explique. L'argent effectivement reçu est enregistré pour les remboursements.

Payment Declined Status (default Failed): un paiement en attente ou en cours d'analyse a été refusé.

Payment Cancelled Status (default Canceled): un paiement en attente, par exemple un boleto ou un PIX expiré, a été annulé.

Refunded Status (default Refunded): le paiement a été intégralement remboursé, par l'extension ou dans le tableau de bord PagBank.

Chaque statut PagBank n'est appliqué qu'une seule fois : les notifications ou les retours répétés n'ajoutent donc ni notes ni changements de statut. Une commande payée n'est jamais remise en arrière. Si un second paiement arrive pour une commande déjà payée, la commande n'est pas modifiée et une note vous invite à rembourser le doublon dans PagBank. Les notes sont des entrées de l'History de la commande, que le client ne voit pas.

Onglet VibeFox PagSeguro Gateway

Dans Sales > Orders, ouvrez une commande payée avec PagBank. En bas de la page de la commande, à côté de History et de Additional, l'onglet VibeFox PagSeguro Gateway affiche le PagBank checkout avec une étiquette Sandbox pour les paiements sandbox, les identifiants PagBank order et Charge, le Payment method, le Status, les montants Paid / refunded, le formulaire de remboursement, l'historique des remboursements et les PagBank notes de la commande. L'onglet est affiché aux utilisateurs qui ont accès à l'extension.

Remboursements

Dans l'onglet VibeFox PagSeguro Gateway, saisissez le Amount (le montant non encore remboursé est prérempli), facultativement un Reason (optional), puis cliquez sur Refund via PagBank. Confirmez la question Refund this amount through PagBank? This cannot be undone. Les remboursements totaux et partiels sont pris en charge. Vous devez disposer du droit de modifier l'extension (défini dans System > Users > User Groups). La limite correspond au montant débité par PagBank ; ainsi, après un écart de montant, vous pouvez rembourser jusqu'au montant effectivement payé par le client, et non jusqu'au total de la commande. Le remboursement est envoyé dans l'environnement et avec le jeton utilisés pour le paiement. Un remboursement n'est enregistré que lorsque PagBank le confirme ; sinon, l'onglet affiche l'erreur, par exemple PagBank refund failed: ... ou PagBank did not confirm the refund, et rien n'est enregistré. Les remboursements des paiements boleto et les remboursements partiels de PIX suivent les règles de PagBank. Un remboursement réussi est ajouté à l'historique des remboursements et aux notes, avec l'identifiant de transaction. Un remboursement total place la commande dans le Refunded Status sans notifier le client et sans remettre les produits en stock, comme pour un changement de statut manuel. Un remboursement partiel ne modifie pas le statut. Les remboursements sont disponibles dès que PagBank a signalé le paiement comme effectué.

Les retours de produits dans Sales > Returns ne renvoient pas d'argent via PagBank.

Les remboursements effectués dans le tableau de bord PagBank sont pris en compte lors de la prochaine notification ou vérification : un remboursement total place la commande dans le Refunded Status, un remboursement partiel ajoute une note avec le montant remboursé.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox PagSeguro Gateway est le premier bloc de Extensions > Extensions > Payments > VibeFox PagSeguro Gateway > Edit, au-dessus des paramètres. Collez la clé dans License key et cliquez sur Activate. Ensuite, le bloc affiche la clé masquée, le statut (par exemple la date jusqu'à laquelle la licence est valide et votre domaine) ainsi que les boutons Check now pour vérifier à nouveau le statut, Change key pour saisir une autre clé et Remove key pour retirer la clé de cette boutique. En dessous figurent la ligne Product: opencart-payment-pagseguro et le lien Manage licenses and domains in your account, qui ouvre votre compte vibefox.net. Seuls les utilisateurs administrateurs disposant du droit de modification de l'extension peuvent changer la clé. Les textes du bloc suivent la langue de l'administration (l'anglais et le russe sont inclus).

Si la clé n'est pas acceptée, le bloc indique la raison, par exemple Key not found, This key belongs to another product, Domain limit reached ou License expired on suivi d'une date. Après un changement d'adresse de la boutique, ou après avoir libéré un emplacement de domaine dans votre compte, cliquez sur Check now. Si le serveur de licences est injoignable, l'extension continue de fonctionner avec le dernier statut connu.

Une clé fonctionne sur un domaine : l'adresse de la boutique issue de la configuration d'OpenCart. Retirer la clé de la boutique ne libère pas son emplacement de domaine. Libérez l'emplacement dans votre compte vibefox.net.

Sans clé active, PagBank n'est pas proposé aux clients lors du passage en caisse. Si un paiement est tout de même lancé, le client voit This payment method is not available. Please choose another one. Un utilisateur administrateur connecté à l'administration dans le même navigateur voit toujours le mode de paiement dans la boutique, marqué (unlicensed — visible to admins only), afin que vous puissiez configurer et tester l'extension avant d'acheter une clé. Sur OpenCart 4, cet aperçu n'est pas disponible : la boutique ne voit pas la connexion à l'administration, si bien que sans clé active le mode de paiement est masqué pour tout le monde. Après avoir ouvert une fois la page Edit, un rappel apparaît sur le Dashboard de l'administration. Fermez-le avec × pour le masquer pendant 7 jours. Les commandes existantes ne sont pas affectées : les paiements déjà lancés sont toujours confirmés et les remboursements fonctionnent.

Lorsqu'une licence expire, l'extension continue de fonctionner, mais les mises à jour et le support nécessitent un renouvellement. Le statut est vérifié à nouveau automatiquement lorsque vous ouvrez le Dashboard de l'administration ou la page Edit : une fois par jour pendant les 14 premiers jours après la saisie de la clé, puis une fois par semaine. Aucune tâche cron n'est nécessaire. La désinstallation de l'extension supprime toujours la clé de licence et son statut.

Dépannage

PagBank does not appear at checkout: vérifiez que la licence est active, que Enable / Disable est activé, que le jeton du mode en cours est défini (Sandbox token en mode sandbox et Production token en mode live) et que le client passe commande en BRL. La page des paramètres affiche un avertissement lorsque le jeton est absent ou lorsque la devise de la boutique n'est pas BRL. Vérifiez également que l'adresse de facturation se trouve dans la Geo Zone sélectionnée et que la commande atteint le Total défini dans les paramètres.

The payment went through, but the order stays without a status: PagBank n'a pas encore signalé le paiement et le client n'est pas revenu dans la boutique. La commande recevra son statut dès que la notification arrivera. Vérifiez que votre boutique est accessible depuis Internet à la Notification URL, et activez le Debug log pour voir les notifications.

The notification answers Invalid signature: le x-authenticity-token ne correspond pas au jeton de l'environnement dans lequel le paiement a été effectué, ou ce jeton n'est pas enregistré. Vérifiez que le bon jeton figure dans les paramètres.

The notification answers Verification failed, retry later: l'API PagBank était injoignable, le jeton de l'environnement du paiement est absent, ou le panier était traité par une autre requête au même moment. PagBank renouvelle la notification.

The notification answers Order not found: la notification concerne une commande qui n'a pas été payée avec cette extension dans cette boutique. Rien n'est modifié.

The customer sees PagBank payments are temporarily unavailable. Please choose another payment method.: le jeton du mode en cours est absent ou PagBank l'a rejeté.

The customer sees PagSeguro/PagBank only accepts payments in Brazilian Real (BRL).: le passage en caisse se fait dans une autre devise.

The customer sees This order has no amount to pay.: le total de la commande est nul.

Order is in the review status after payment: lisez les notes de l'onglet VibeFox PagSeguro Gateway (voir Statuts de commande), comparez les montants dans PagBank, puis traitez la commande ou remboursez le paiement.

No refund form in the tab: l'onglet indique la raison : le paiement n'est pas encore signalé comme effectué, il est entièrement remboursé, votre groupe d'utilisateurs n'a pas le droit de modifier l'extension, ou le jeton de l'environnement du paiement n'est pas défini.

Refund fails with a message about the token: le paiement a été effectué dans le sandbox ou en production, et le jeton de cet environnement est absent ou rejeté. Saisissez le bon jeton et réessayez.

Pour les développeurs : avant la création du paiement PagBank, l'extension déclenche l'événement OpenCart wc_psg_checkout_data avec le corps de la requête, la commande et l'environnement. L'article doit rester égal au total de la commande.

Désinstallation

Allez dans Extensions > Extensions, choisissez le type Payments et cliquez sur Uninstall (le bouton rouge −) à côté de VibeFox PagSeguro Gateway. La clé de licence et le statut de licence de cette extension sont toujours supprimés. OpenCart supprime toujours ses propres paramètres de l'extension : Enable / Disable, Sort Order, Geo Zone, Total et les statuts de commande de la section Orders, qui reprennent leurs valeurs par défaut lors d'une réinstallation. L'événement OpenCart de l'extension est également supprimé (sur OpenCart 4, également ses événements et son action startup, qui laisse passer en mode maintenance les notifications et le retour du client). Si Delete Data on Uninstall est activé, les autres paramètres de la passerelle (titre, description, mode sandbox, jetons, journalisation) et le journal sont supprimés. S'il est désactivé, ils sont conservés pour une réinstallation ultérieure. Les enregistrements des paiements et remboursements PagBank sont toujours conservés, de sorte que les commandes payées auparavant peuvent encore être remboursées après une réinstallation. Les commandes existantes conservent leurs notes de paiement.

Sur OpenCart 4, pour supprimer aussi les fichiers de l'extension, allez dans Extensions > Installer après la désinstallation et cliquez sur Uninstall (le bouton orange −) à côté de VibeFox PagSeguro Gateway dans la liste des extensions installées, puis sur Delete (le bouton rouge en forme de corbeille) pour supprimer le paquet téléversé.

PagSeguro et PagBank sont des marques déposées de leurs propriétaires respectifs. Cette extension n'est ni affiliée à PagSeguro ou PagBank, ni approuvée par ces derniers.