VibeFox Paytrail for OpenCart — Aide

Prérequis

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

PHP : 8.0 ou ultérieur.

Devise : EUR. Paytrail n'accepte que l'euro. Pour une commande dans une autre devise, le mode de paiement est masqué à la commande. Les montants sont transmis en centimes.

Accès Internet à votre boutique : Paytrail confirme chaque paiement par un callback serveur à serveur ; la boutique doit donc être accessible depuis Internet. Sans les callbacks, les commandes sont tout de même confirmées lorsque le client revient de Paytrail.

Compte Paytrail : vous avez besoin de votre identifiant marchand (merchant ID) et de votre clé secrète, affichés dans le Merchant Panel de Paytrail (détails du compte ou de l'intégration). Pour les tests, aucun compte n'est nécessaire : le mode test utilise le compte de test public de Paytrail. Les modes de paiement eux-mêmes sont activés dans votre compte Paytrail.

Clé de licence VibeFox : 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_paytrail_gateway-oc3-(version).ocmod.zip et le paquet OpenCart 4 wcp_paytrail_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_paytrail_gateway-oc3-(version).ocmod.zip. L'extension ne comporte aucune modification OCMOD : Extensions > Modifications n'a donc pas besoin d'être actualisé. 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 Paytrail 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. Pour essayer d'abord l'extension, activez Test mode. Pour les paiements réels, désactivez-le et saisissez votre Merchant ID et votre Secret key. Aucune URL de callback n'est à configurer dans Paytrail.

5. Activez Enable/Disable et cliquez sur Save.

OpenCart 4

1. Dans l'administration, allez dans Extensions > Installer, cliquez sur Upload et choisissez le fichier wcp_paytrail_gateway.ocmod.zip. Ne renommez pas le fichier : OpenCart 4 prend le code de l'extension à partir 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é.

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

4. Saisissez la clé de licence et les paramètres Paytrail comme aux étapes 3 à 5 pour OpenCart 3. La page des paramètres et ses champs sont les mêmes dans les deux versions. Seule l'URL de callback diffère (voir Commandes).

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

Configuration

Tous les paramètres se trouvent sur la page de l'extension : Extensions > Extensions > Payments > VibeFox Paytrail 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 test est actif. Les paiements utilisent le compte de test public de Paytrail : aucun argent réel n'est débité. lorsque le mode test est activé. En mode réel, elle vous avertit si le merchant ID ou la clé secrète manque, ou si le merchant ID est le compte de test public 375917 ; dans ces cas, Paytrail n'est pas affiché à la commande. Elle vous avertit également si la devise par défaut de la boutique n'est pas l'EUR : Paytrail n'est alors affiché que lorsque le client paie en EUR. 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 doit pas être vide ni dépasser 128 caractères, 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 ; sinon, rien n'est enregistré. Un merchant ID contenant autre chose que des chiffres n'est pas enregistré : l'erreur Le merchant ID Paytrail ne doit contenir que des chiffres. La valeur précédente a été conservée. s'affiche, et les autres paramètres sont enregistrés.

Paytrail

La section commence par une brève note sur la page de paiement Paytrail et sur la règle selon laquelle la commande ne reçoit son statut qu'après la confirmation du paiement par Paytrail.

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

Title: le titre affiché aux clients à la commande. C'est aussi le nom du mode de paiement enregistré dans la commande. Par défaut : Paytrail. Obligatoire, 128 caractères maximum.

Description: le texte affiché au client à l'étape Confirm Order, au-dessus du bouton de confirmation, à côté de l'icône Paytrail. Par défaut : Pay securely with Finnish online banking, card, mobile payment or invoice on the Paytrail payment page.

Sort Order: la position de Paytrail parmi les modes de paiement à la commande. Laissez le champ vide ou saisissez un nombre entier.

Geo Zone: proposer Paytrail uniquement pour les adresses de paiement de la zone géographique sélectionnée. Par défaut : All zones. Les zones géographiques se configurent dans System > Localisation > Geo Zones.

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

Identifiants API

Votre merchant ID et votre clé secrète sont affichés dans le Merchant Panel de Paytrail (détails du compte ou de l'intégration). La section renvoie vers Paytrail par un lien. Seuls les paiements en EUR sont pris en charge.

Test mode : utilise le compte de test public de Paytrail (merchant ID 375917) pour les nouveaux paiements, à la place de vos propres identifiants. Aucun argent réel n'est débité et aucune clé n'est nécessaire. Les clients voient Mode test : aucun paiement réel ne sera effectué. à l'étape Confirm Order. La clé secrète du compte de test est publique : n'importe qui pourrait donc simuler un paiement effectué en mode test. Ne laissez jamais le mode test activé dans une boutique en production. Par défaut : désactivé.

Merchant ID : votre merchant ID Paytrail (chiffres uniquement). Il est utilisé lorsque le mode test est désactivé. Contrairement à la clé secrète, il est affiché sur la page après l'enregistrement.

Secret key : votre clé secrète Paytrail. Elle est utilisée lorsque le mode test est désactivé. La clé enregistrée n'est jamais réaffichée. Le champ reste vide et affiche Enregistrée — laissez vide pour la conserver. Ne saisissez une nouvelle valeur que pour la modifier. Pour supprimer la clé enregistrée, cochez Clear saved secret key sous le champ et cliquez sur Save.

Les callbacks et les remboursements utilisent toujours les identifiants du mode dans lequel le paiement a été effectué ; passer du mode test au mode réel ne perturbe donc pas les anciennes commandes.

Commandes

OpenCart crée la commande à l'étape Confirm Order sans statut (une commande manquante, missing order). La commande ne reçoit un statut qu'après la confirmation du paiement par Paytrail. Chaque champ de statut ci-dessous répertorie vos statuts de commande OpenCart.

Callback URL : affiche l'URL à laquelle Paytrail confirme chaque paiement de serveur à serveur. Sur OpenCart 3, elle a la forme https://your-store/index.php?route=extension/payment/wcp_paytrail_gateway/callback, sur OpenCart 4 https://your-store/index.php?route=extension/wcp_paytrail_gateway/payment/wcp_paytrail_gateway.callback. Elle est transmise avec chaque paiement : rien n'est donc à configurer dans le panneau Paytrail, mais la boutique doit être accessible depuis Internet.

Order status after payment : le statut d'une commande payée. Par défaut : Processing. Sélectionnez Complete si chaque commande payée doit être finalisée immédiatement.

Awaiting payment status : Paytrail signale le paiement comme en attente ou différé (une facture ou un paiement échelonné en attente de l'approbation du prestataire). La commande est mise à jour automatiquement lorsque Paytrail confirme ou rejette le paiement. Par défaut : Pending.

Payment on hold status : le paiement nécessite votre attention (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 failed status : défini lorsqu'un paiement Paytrail en attente échoue. Par défaut : Failed.

Refunded status : défini après le remboursement complet du paiement depuis la page de la commande. Par défaut : Refunded.

Avancé

Debug log : consigne les requêtes API et les callbacks dans ptg_debug.log.php, dans le dossier des journaux d'OpenCart (storage/logs). Le fichier ne peut pas être ouvert depuis le web et, à 5 Mo, il est déplacé vers ptg_debug.old.log.php. Les données personnelles et les clés ne sont pas journalisées. 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 : lorsqu'il est activé, la désinstallation de l'extension supprime les paramètres de la passerelle et le journal. La désactivation de l'extension ne supprime jamais rien. Les données de transaction Paytrail des commandes sont toujours conservées, car les remboursements des anciennes commandes en ont besoin. Par défaut : désactivé.

Import / Export

Export : Download JSON enregistre les paramètres dans un fichier JSON. Le merchant ID et la clé secrète ne sont pas exportés.

Import : collez le JSON exporté précédemment et cliquez sur Import pour restaurer les paramètres. Le merchant ID et la clé secrète enregistrés sont conservés.

Paiement

À l'étape Payment Method, le client choisit le mode de paiement (par défaut Paytrail). À l'étape Confirm Order, le client voit l'icône Paytrail et votre description. 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 commande. Lorsque le client clique sur Confirm Order, l'extension crée un paiement Paytrail pour le total de la commande en euros, avec le numéro de commande comme référence, et y joint les lignes de commande : produits avec leurs options et leurs taxes, cartes cadeaux achetées, frais de livraison et autres frais. Les coupons, le crédit de la boutique, les points de fidélité et les cartes cadeaux utilisées sont répartis sur les lignes. Les lignes correspondent toujours au montant du paiement ; un écart d'arrondi est intégré à une ligne ou envoyé comme ligne Rounding. Les coordonnées du client sont transmises, ainsi que les adresses de facturation et de livraison, mais uniquement lorsqu'elles sont complètes. La langue de la page de paiement est le finnois, le suédois ou l'anglais, selon la langue du client.

Le client est envoyé sur la page de paiement Paytrail, choisit un mode de paiement activé sur votre compte Paytrail et paie. Paytrail confirme ensuite le paiement deux fois : il renvoie le client vers votre boutique et appelle l'URL de callback de serveur à serveur. Les deux confirmations ne sont acceptées qu'avec une signature valide réalisée avec les identifiants de cette tentative de paiement, et uniquement pour une tentative créée pour cette commande. Le montant payé est comparé au total de la commande. La commande n'est marquée comme payée qu'après la confirmation de Paytrail de cette manière, et reçoit alors son statut de la manière standard d'OpenCart, avec les e-mails habituels de commande et la mise à jour du stock. L'extension gère les statuts Paytrail suivants :

Après un paiement réussi, le client voit la page de confirmation de commande d'OpenCart avec Votre paiement Paytrail a bien été reçu. Pour un paiement en attente, la page affiche Votre paiement Paytrail est en attente de confirmation par le prestataire de paiement. La commande sera mise à jour automatiquement — merci de ne pas payer à nouveau. Si le callback enregistre le paiement au même moment, une page Payment confirmation demande au client de ne pas payer à nouveau et propose Check again.

Après un paiement annulé ou échoué, le client revient à la commande avec le message Le paiement Paytrail a été annulé ou a échoué. Vous pouvez réessayer ou choisir un autre mode de paiement. Si le paiement n'est pas encore terminé, le message est Le paiement Paytrail n'a pas encore été finalisé. Vous pouvez réessayer ou choisir un autre mode de paiement. Le panier est conservé. Sur OpenCart 4, ces messages s'affichent au-dessus de la page de commande. Un retour qui ne peut pas être vérifié affiche une page Payment Error avec Payment verification failed. et ne modifie rien.

Si Paytrail ne peut pas lancer le paiement, le client reste à l'étape Confirm Order avec un bref message au-dessus du bouton, par exemple Impossible de se connecter à Paytrail. Veuillez réessayer dans un instant., Paytrail est temporairement indisponible. Veuillez choisir un autre mode de paiement. (identifiants incorrects) ou Paytrail n'a pas pu lancer le paiement. Veuillez vérifier vos informations de facturation et réessayer, ou choisir un autre mode de paiement. La raison technique est écrite dans le journal. Un total hors des limites de Paytrail affiche Ce montant de commande ne peut pas être réglé avec Paytrail. Veuillez choisir un autre mode de paiement.

OpenCart 3 crée une nouvelle commande à chaque affichage de l'étape Confirm Order, OpenCart 4 met à jour la commande en cours de passage à la commande (un nouvel essai paie la même commande). Si le panier a déjà été payé avec une autre commande, le client est directement redirigé vers la page de succès et aucun nouveau paiement n'est lancé. Un paiement Paytrail ne peut pas être annulé via l'API : une ancienne page de paiement reste donc payable. Si le client la paie aussi, le second paiement est signalé sur la commande payée comme un doublon à rembourser, et l'autre commande reste sans statut. Une modification du panier, y compris une nouvelle quantité, est considérée comme un nouveau panier qui nécessite son propre paiement.

Sur OpenCart 4, la commande est conservée jusqu'à l'affichage de la page de succès. Si cette commande a été fermée entre-temps sans paiement (par exemple si vous l'avez annulée), le client est renvoyé à la commande avec le message Votre commande précédente a été annulée ou remboursée. Veuillez confirmer à nouveau la commande pour payer avec une nouvelle commande. Si son paiement en attente a échoué, le message est Le paiement Paytrail a été annulé ou a échoué. Vous pouvez réessayer ou choisir un autre mode de paiement. Le prochain Confirm Order paie une nouvelle commande. Si cette commande avait déjà été payée pour un panier antérieur et que le panier a changé depuis, le client est ramené à la commande, et le prochain Confirm Order paie une nouvelle commande du panier actuel. Une commande fermée n'est jamais affichée comme payée.

Le callback fonctionne aussi lorsque la boutique est en mode maintenance, car OpenCart laisse passer les requêtes des extensions de paiement (sur OpenCart 4, l'extension ajoute pour cela sa propre action de démarrage, qui permet aussi au client de revenir depuis Paytrail).

Le client choisit le mode de paiement sur la page Paytrail, et non dans votre commande. L'extension ne prend pas en charge la tokenisation des cartes ni les cartes enregistrées, ni les abonnements, ni le shop-in-shop, ni l'activation manuelle des factures, ni les rapports de règlement.

Commandes et remboursements

Statuts de commande

Aucun statut (commande manquante) : le client a été envoyé sur Paytrail et n'a pas payé, le paiement a échoué, ou Paytrail n'a pas encore confirmé le paiement. Dans Sales > Orders, ces commandes ne s'affichent qu'avec le filtre Order Status réglé sur Missing Orders.

Order status after payment (par défaut Processing) : le paiement a été confirmé. Une note indique la transaction Paytrail, le mode de paiement utilisé chez Paytrail et le montant, avec TEST mode — no real money. pour les paiements test.

Awaiting payment status (par défaut Pending) : le paiement est en attente chez le prestataire (facture ou paiement différé). La commande passe au statut payé lorsque Paytrail confirme le paiement, ou au statut échoué si le paiement échoue.

Payment on hold status (par défaut Pending) : le montant payé diffère du total de la commande (le montant réellement payé est enregistré), le paiement est arrivé après que la commande a été passée dans un autre statut, par exemple annulée, ou un paiement test a été reçu alors que l'extension était en mode réel (aucun argent réel, rien à rembourser). La note explique la raison. Vérifiez la commande, puis traitez-la ou remboursez le paiement.

Payment failed status (par défaut Failed) : un paiement Paytrail en attente a échoué ou a été annulé.

Refunded status (par défaut Refunded) : le paiement a été entièrement remboursé via l'extension.

Les callbacks répétés ou simultanés ne sont appliqués qu'une seule fois, sans notes en double. Une commande payée, remboursée ou finalisée n'est jamais rouverte par un callback ultérieur. Si une deuxième tentative d'une commande ou d'un panier déjà payé est réglée, la commande n'est pas modifiée ; une note Duplicate payment vous demande de la rembourser dans le Merchant Panel de Paytrail.

Les notes sont des entrées de l'History de la commande que le client ne voit pas.

Onglet VibeFox Paytrail Gateway

Dans Sales > Orders, ouvrez une commande payée avec Paytrail. En bas de la page de la commande, à côté de History et Additional, l'onglet VibeFox Paytrail Gateway liste les tentatives de paiement de la commande (date, transaction Paytrail et estampille avec le libellé Test pour les paiements test, montant, mode de paiement, statut et résultat Paytrail), les montants Paid / refunded, le formulaire de remboursement, l'historique des remboursements et les Paytrail notes de la commande. L'onglet est affiché aux utilisateurs qui ont accès à l'extension.

Remboursements

Dans l'onglet VibeFox Paytrail Gateway, saisissez le Amount (le montant non encore remboursé est prérempli), éventuellement un motif pour la note de commande, puis cliquez sur Refund via Paytrail. Confirmez la question Rembourser ce montant via Paytrail ? Cette action est irréversible. Les remboursements totaux et partiels sont pris en charge, uniquement en montant. Vous devez avoir le droit de modifier l'extension (défini dans System > Users > User Groups). Vous pouvez rembourser jusqu'au montant effectivement prélevé par Paytrail : après un écart de montant, la limite correspond donc à ce que le client a payé, et non au total de la commande. Le remboursement utilise les identifiants du mode dans lequel le paiement a été effectué ; pour un paiement réel, les identifiants réels doivent donc être renseignés. Les remboursements sont disponibles dès que Paytrail a confirmé le paiement.

Si le mode de paiement ne prend pas en charge les remboursements directs, l'extension lance automatiquement un remboursement par e-mail : Paytrail envoie un e-mail au client pour qu'il saisisse un compte bancaire. Cela nécessite l'e-mail du client sur la commande. La note indique le type de remboursement lancé.

Un remboursement peut être finalisé immédiatement ou traité plus tard. La confirmation ultérieure de Paytrail est ajoutée sous forme de note. Si Paytrail n'a pas pu finaliser le remboursement, une note indique que l'argent n'a pas été restitué au client, et le remboursement ne compte plus comme effectué ; remboursez le client par un autre moyen. Si Paytrail refuse immédiatement le remboursement, l'onglet affiche l'erreur et aucun remboursement n'est enregistré. Un remboursement total place la commande en Refunded status sans notifier le client et sans remettre les produits en stock, comme un changement de statut manuel. Un remboursement partiel ne modifie pas le statut.

Les retours de produits dans Sales > Returns ne renvoient pas d'argent via Paytrail. Les remboursements effectués dans le Merchant Panel de Paytrail ne sont pas synchronisés avec OpenCart.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox Paytrail Gateway est le premier bloc de Extensions > Extensions > Payments > VibeFox Paytrail 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 active et votre domaine) et 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-paytrail et le lien Manage licenses and domains in your account, qui ouvre votre compte vibefox.net. Seuls les utilisateurs administrateurs disposant du droit Modify pour l'extension peuvent modifier 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 seul domaine : l'adresse de la boutique configurée dans 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, Paytrail n'est pas affiché aux clients à la commande. Si un paiement est tout de même lancé, le client voit This payment method is not available. Please choose another one. Un 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, donc 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 par les callbacks et le retour du client, 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 ou la page Edit de l'administration : une fois par jour pendant les 14 premiers jours suivant 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 le statut de licence.

Dépannage

Paytrail n'apparaît pas à la commande : vérifiez que la licence est active, que Enable/Disable est activé, et que soit Test mode est activé, soit Merchant ID et Secret key sont renseignés (et non le compte de test public 375917). Vérifiez que le client paie en EUR, que l'adresse de paiement se trouve dans la Geo Zone sélectionnée et que la commande atteint le Total défini dans les paramètres. La page des paramètres affiche un avertissement en cas d'identifiants manquants ou de devise de boutique autre que l'EUR.

Le paiement a été effectué, mais la commande reste sans statut : le callback ne peut pas atteindre votre boutique, et le client n'est pas revenu sur la boutique. L'Callback URL affichée dans la section Orders doit être accessible depuis Internet (aucune authentification de base ni pare-feu ne doit faire obstacle).

Le callback ou le retour répond Payment verification failed. : la signature est invalide, ou le paiement n'appartient à aucune tentative de paiement de la commande. Rien n'est modifié. Vérifiez que la Secret key est correcte et qu'elle appartient au Merchant ID.

Le callback répond Temporarily unavailable : la commande était en cours de confirmation par une autre requête au même moment, ou le statut de la commande n'a pas pu être défini. Paytrail rappelle. Consultez le champ Log pour la raison.

Le client voit une erreur après Confirm Order : consultez le champ Log sur la page de l'extension. Par exemple, Paytrail API error (401) signale des identifiants incorrects. Activez Debug log pour plus de détails. This payment method is not available. Please reload the checkout page. signifie que le mode de paiement a été désactivé entre-temps ou que la commande ne correspond plus au panier.

Le merchant ID n'est pas enregistré : il ne doit contenir que des chiffres. Recopiez-le depuis le Merchant Panel de Paytrail.

La commande est en statut de mise en attente (on hold) : lisez les notes dans l'onglet VibeFox Paytrail Gateway. La raison peut être un montant payé différent, un paiement reçu après un changement de statut ou un paiement test en mode réel.

Le remboursement échoue : lisez le message. This order has no confirmed Paytrail payment. Refund it manually. signifie qu'il n'existe aucun paiement Paytrail confirmé à rembourser. The live Paytrail credentials used for this payment are missing. Enter them in the Paytrail settings. signifie que le paiement a été effectué en mode réel et que les identifiants réels ne sont pas renseignés. Invalid refund amount: at most … signifie que le montant est supérieur à ce qui reste à rembourser. This payment method supports only e-mail refunds, but the order has no billing e-mail. signifie que la commande nécessite l'e-mail du client.

Pour les développeurs : avant que la requête de paiement ne soit signée et envoyée, l'extension déclenche l'événement OpenCart ptg_payment_request avec la requête et la commande.

Désinstallation

Allez dans Extensions > Extensions, choisissez le type Payments et cliquez sur Uninstall (le bouton rouge −) à côté de VibeFox Paytrail 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 reviennent à leurs valeurs par défaut lors d'une réinstallation. L'événement OpenCart de l'extension est également supprimé (sur OpenCart 4, ses événements et son action de démarrage sont supprimés, ce qui permet de laisser passer le callback et le retour du client en mode maintenance). Si Delete data on uninstall est activé, les autres paramètres de la passerelle (titre, description, mode test, merchant ID, clé secrète, journalisation) et le journal sont supprimés. S'il est désactivé, ils sont conservés pour une future réinstallation. Les transactions et remboursements Paytrail 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 Paytrail Gateway dans la liste des extensions installées, puis sur Delete (le bouton rouge en forme de corbeille) pour supprimer le paquet envoyé.

Paytrail est une marque déposée de son propriétaire respectif. Cette extension n'est ni affiliée à Paytrail ni approuvée par Paytrail.