Retour

VibeFox ECPay for OpenCart — Aide

Prérequis

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

PHP : 8.0 ou ultérieur.

Devise : nouveau dollar de Taïwan (TWD). ECPay n'encaisse qu'en TWD, donc le mode de paiement n'est affiché que lorsque le client passe commande en TWD. Ajoutez TWD avec le code TWD dans System > Localisation > Currencies si votre boutique ne l'a pas. Les montants sont envoyés en TWD entiers, car ECPay n'accepte pas les décimales : les totaux des commandes sont arrondis au dollar le plus proche. Utilisez 0 décimale pour TWD afin d'éviter les arrondis.

Compte ECPay : pour les paiements réels, vous avez besoin du MerchantID, du HashKey et du HashIV de votre compte marchand ECPay, depuis le back-office marchand d'ECPay (vendor.ecpay.com.tw). Pour les tests, aucun compte ECPay n'est nécessaire.

Accès au site : votre boutique doit être joignable depuis Internet en HTTP/HTTPS sur les ports 80/443, afin qu'ECPay puisse envoyer les notifications de paiement. Un pare-feu ou une authentification de base placé devant le site les bloque.

Clé de licence VibeFox : achetée sur vibefox.net. Une clé fonctionne pour 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_ecpay_payment_gateway-oc3-(version).ocmod.zip et le paquet OpenCart 4 wcp_ecpay_payment_gateway.ocmod.zip. N'installez que 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_ecpay_payment_gateway-oc3-(version).ocmod.zip. L'extension ne comporte aucune modification OCMOD, donc Extensions > Modifications n'a pas besoin d'être actualisé. Au lieu de l'installateur, vous pouvez 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 ECPay Payment 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 crayon) pour ouvrir la page des réglages. 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. Activez Enable/Disable, choisissez les modes de paiement et laissez Test Mode activé pour vos premiers tests. Cliquez sur Save.

5. Pour les paiements réels, saisissez le Merchant ID, le Hash Key et le Hash IV (voir Configuration), désactivez Test Mode et cliquez sur Save.

OpenCart 4

1. Dans l'administration, allez dans Extensions > Installer, cliquez sur Upload et choisissez le fichier wcp_ecpay_payment_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é.

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

4. Saisissez la clé de licence et les réglages comme aux étapes 3 à 5 pour OpenCart 3. La page de configuration et ses champs sont identiques dans les deux versions. Seule l'URL de notification diffère (voir Notifications de paiement).

Une nouvelle installation démarre avec le mode de paiement désactivé et le mode test activé. L'URL de notification est envoyée à chaque paiement, il n'y a donc rien à configurer dans ECPay.

Configuration

Tous les réglages se trouvent sur la page de l'extension : Extensions > Extensions > Payments > VibeFox ECPay Payment Gateway > Edit. Les sections sont listées à gauche ; le bouton Save sous la liste enregistre toute la page. Au-dessus des réglages, la page affiche une erreur lorsque la devise par défaut de votre boutique n'est pas TWD et qu'il n'existe aucune devise TWD activée (ECPay n'est alors pas proposé au paiement), ou un avertissement lorsque TWD n'est qu'une seconde devise (ECPay n'est alors proposé qu'aux clients qui paient en TWD). Elle affiche une erreur lorsque le mode réel n'a pas de MerchantID, de HashKey et de HashIV. Tant que le mode test est activé, elle avertit que les paiements sont envoyés à l'environnement de test (sandbox) d'ECPay avec le marchand de test public 3002607, qu'aucun argent n'est encaissé, et que toute personne connaissant les clés publiques du sandbox pourrait confirmer des commandes de test ; le mode test doit donc être désactivé avant d'accepter de vraies commandes. Sans le droit de modifier l'extension, la page affiche les réglages mais ne peut pas les enregistrer.

Lors de l'enregistrement, Title ne doit pas être vide (128 caractères maximum), Sort Order doit être un nombre entier et Total un nombre égal ou supérieur à 0 ; sinon rien n'est enregistré. Les autres corrections sont enregistrées avec un message au-dessus des réglages (voir les champs ci-dessous).

ECPay (綠界)

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

Title : le nom du mode de paiement que voient les clients au moment du paiement. C'est aussi le nom du mode de paiement enregistré dans la commande. Par défaut : ECPay (綠界). Obligatoire.

Description : le texte affiché au client à l'étape Confirm Order. Par défaut : Pay securely via ECPay (Credit Card, ATM, CVS, Barcode).

Sort Order : la position d'ECPay parmi les modes de paiement proposés au moment du paiement. Laissez vide ou saisissez un nombre entier.

Geo Zone : ne proposer ECPay que 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.

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

Compte ECPay

Retrouvez votre MerchantID, votre HashKey et votre HashIV dans le back-office marchand d'ECPay (vendor.ecpay.com.tw), sous System development management > System integration settings (系統開發管理 > 系統介接設定).

Test Mode : envoie les paiements à l'environnement de test (sandbox) d'ECPay (payment-stage.ecpay.com.tw) avec le marchand de test public d'ECPay 3002607. Aucun argent réel n'est encaissé. Les identifiants ci-dessous ne sont utilisés que lorsque le mode test est désactivé. Par défaut : activé. Tant qu'il est activé, les clients voient TEST MODE — ECPay sandbox, no real money is charged. à l'étape Confirm Order.

Merchant ID : votre Merchant ID ECPay (production). Ignoré en mode test.

Hash Key : votre Hash Key ECPay (production). Ignoré en mode test.

Hash IV : votre Hash IV ECPay (production). Ignoré en mode test.

Les espaces et les sauts de ligne dans les identifiants collés cassent chaque signature ; ils sont donc supprimés à l'enregistrement, et la page vous en informe. Un Hash Key et un Hash IV enregistrés ne sont plus jamais affichés : le champ reste vide et affiche Saved — leave empty to keep it. Saisissez une nouvelle valeur uniquement pour la changer. Pour supprimer une valeur enregistrée, cochez Clear the saved value on save sous le champ, puis cliquez sur Save.

Options de paiement

Enabled Payment Methods : les modes proposés aux clients. Avec plusieurs modes, le client choisit à l'étape Confirm Order. Les commandes ATM, CVS et Barcode restent en attente de statut tant que le client n'a pas payé. Au moins un mode doit être sélectionné ; si aucun ne l'est, Credit Card est activé et la page vous en informe. Par défaut : Credit Card.

Credit Card : paiement par carte sur la page ECPay.
ATM (Virtual Account) : le client reçoit un compte bancaire virtuel et vire l'argent.
CVS (Convenience Store) : le client reçoit un code de paiement pour payer dans une supérette.
Barcode : le client reçoit des codes-barres de supérette.

Default Payment Method : le mode présélectionné. Il doit faire partie des modes activés ; sinon, le premier mode activé est utilisé. Par défaut : Credit Card.

Order Prefix : le préfixe du numéro de transaction ECPay (MerchantTradeNo), jusqu'à 5 lettres ou chiffres. Les autres caractères sont supprimés à l'enregistrement, avec un message. Utile lorsque plusieurs boutiques partagent un compte ECPay : donnez à chaque boutique son propre préfixe. Par défaut : EC.

Notifications de paiement

ECPay envoie à votre boutique les résultats des paiements ainsi que les détails ATM, CVS et code-barres. Cette section affiche la Notification URL. Sur OpenCart 3, elle ressemble à https://your-store/index.php?route=extension/payment/wcp_ecpay_payment_gateway/notify, et sur OpenCart 4 à https://your-store/index.php?route=extension/wcp_ecpay_payment_gateway/payment/wcp_ecpay_payment_gateway.notify. L'URL est envoyée à chaque paiement, il n'y a donc rien à configurer dans ECPay, mais elle doit être joignable depuis Internet sur les ports 80/443, sans pare-feu ni authentification de base devant. Le mode maintenance ne la bloque pas.

Chaque notification est vérifiée par sa signature CheckMacValue avec les clés de l'environnement (test ou réel) dans lequel le paiement a été lancé, et par le MerchantID de ce paiement. Les notifications sans signature valide sont rejetées, et ECPay les renvoie. Sans la notification, la commande ne reçoit aucun statut ; vérifiez alors le paiement dans le back-office ECPay.

Commandes

OpenCart crée la commande à l'étape Confirm Order sans statut (une commande manquante). Elle ne reçoit un statut qu'à partir de la notification ECPay signée. Un paiement par carte échoué ou abandonné laisse la commande sans statut, et le client peut payer à nouveau. Chaque champ ci-dessous liste les statuts de commande de votre OpenCart.

Payment accepted : le statut lorsque ECPay confirme le paiement avec le montant attendu. Par défaut : Processing.

Awaiting ECPay payment : le statut lorsque le client a reçu un compte virtuel ATM, un code de paiement CVS ou des codes-barres, et paie plus tard à la banque ou en magasin. Par défaut : Pending.

ECPay payment on hold : le statut lorsque ECPay signale un autre montant ou une autre devise, lorsqu'un paiement sandbox arrive en mode réel, ou lorsque le paiement arrive après que le statut de la commande a été modifié (par exemple annulée). La note de commande explique pourquoi. 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 error : le statut lorsque le dernier paiement ATM, CVS ou code-barres d'une commande en attente a échoué. Par défaut : Failed.

Avancé

Enable Logging : écrit les numéros de commande, les numéros de transaction, les montants et les codes de retour ECPay dans ecpay_p_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 ecpay_p_debug.old.log.php. Aucune clé ni donnée client n'est journalisée. Les erreurs sont toujours journalisées, même lorsque ce commutateur est désactivé. 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 ses réglages et le journal. Les enregistrements de paiement ECPay sont toujours conservés, de sorte que les commandes existantes continuent de fonctionner après une réinstallation. Par défaut : désactivé.

Import / Export

Export : Download JSON enregistre les réglages dans un fichier JSON. Hash Key et Hash IV ne sont pas exportés.

Import : collez le JSON exporté précédemment et cliquez sur Import pour restaurer les réglages. Le Hash Key et le Hash IV enregistrés sont conservés.

Paiement

À l'étape Payment Method, le client choisit le mode de paiement (par défaut ECPay (綠界)). À l'étape Confirm Order, le client voit votre description ainsi que la mention You will be redirected to the ECPay payment page to complete the payment. Lorsque plusieurs modes sont activés, le client choisit aussi Credit Card, ATM (Virtual Account), CVS (Convenience Store) ou Barcode sous Payment Method. 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 de mode de paiement, dans la fenêtre Payment method options, puis clique sur Confirm Order en bas de la page de paiement ; le choix du mode ECPay s'affiche au-dessus de ce bouton.

Lorsque le client clique sur Confirm Order, la page affiche Redirecting to ECPay for payment. Please wait... et envoie le client vers la page de paiement ECPay. Le total de la commande est envoyé en TWD entiers, avec les noms et les quantités des produits. La page ECPay s'ouvre en chinois traditionnel pour les langues taïwanaise et hongkongaise, en chinois simplifié, en coréen ou en japonais pour ces langues, et en anglais pour toutes les autres, selon la langue de la boutique du client.

La commande n'est marquée payée qu'après confirmation par ECPay au moyen d'une notification serveur signée. Elle reçoit alors son statut de la manière standard d'OpenCart, avec les e-mails habituels de commande et la mise à jour des stocks. Lorsque le client clique sur le lien de retour à la boutique sur la page ECPay et que la commande a déjà un statut, la page de succès de commande d'OpenCart s'ouvre. Elle affiche Your ECPay payment has been received. pour une commande payée, Your ECPay payment was received and is being reviewed by the store. pour une commande en attente, et les instructions de paiement pour une commande ATM, CVS ou Barcode en attente. Si la notification n'est pas encore arrivée, une page Payment confirmation affiche We have not received a payment confirmation from ECPay for this order yet. Your order will be confirmed as soon as ECPay confirms the payment. avec les boutons Check again et Back to checkout. Si ECPay signale que le paiement a échoué, le client revient au paiement avec The payment was not completed. You can try again or choose another payment method. Le panier est conservé. Sur OpenCart 4, ces messages s'affichent au-dessus de la page de paiement.

Pour ATM, CVS et Barcode, le client reçoit d'abord les détails de paiement. La commande reçoit le statut Awaiting ECPay payment, et le code banque et le compte virtuel, le code de paiement en supérette ou les codes-barres, le montant et la date limite Pay before sont affichés sous ECPay payment instructions sur la page de succès de commande et, pour un client connecté, dans les informations de commande de son compte client. Lorsque le client paie, ECPay envoie une nouvelle notification et la commande est marquée payée. Les instructions de paiement ne sont pas ajoutées aux e-mails d'OpenCart.

Chaque tentative crée un nouveau numéro de transaction ECPay, car ECPay rejette les numéros réutilisés. Les nouvelles tentatives après un paiement échoué fonctionnent donc, et si le client revient en arrière dans le navigateur et clique de nouveau sur Confirm Order, une nouvelle tentative est lancée. Un panier peut comporter jusqu'à 30 tentatives de paiement. OpenCart 3 crée une nouvelle commande chaque fois que l'étape Confirm Order est affichée ; OpenCart 4 met à jour la commande de la finalisation, si bien qu'une nouvelle tentative paie la même commande avec un nouveau numéro de transaction ; lorsqu'une autre commande du même panier est déjà payée ou attend son paiement ATM ou CVS, le client accède à la page de succès et aucun nouveau paiement n'est lancé.

OpenCart 4 conserve la commande dans le paiement jusqu'à l'affichage de la page de succès. Si cette commande a été fermée sans paiement entre-temps (par exemple son paiement ATM ou CVS a échoué, ou vous l'avez annulée), le client est renvoyé au paiement avec Your previous order was cancelled or its payment failed. Please confirm the order again., et le Confirm Order suivant paie une nouvelle commande du panier. Si la commande est déjà payée (ou attend son paiement ATM ou en supérette) mais que le panier a changé depuis, y compris une nouvelle quantité, le message est Your previous order is already paid (or awaits its ATM / convenience store payment). Please confirm the order again: the cart will be paid with a new order. Une commande payée n'est jamais présentée comme payée pour un autre panier.

Si le paiement ne peut pas être lancé, le client reste à l'étape Confirm Order avec un bref message au-dessus du bouton, par exemple The order total is too small for ECPay. lorsque le total est inférieur à 1 TWD après arrondi. Les limites de montant propres à ECPay pour chaque mode sont vérifiées sur la page ECPay, et non au moment du paiement.

Les notifications de paiements déjà lancés sont acceptées même si vous désactivez le mode de paiement, et le client voit toujours les instructions de paiement des commandes déjà passées.

L'extension ne traite que les paiements uniques sur la page ECPay. Elle ne propose pas de remboursements depuis OpenCart, ni de cartes enregistrées, ni d'abonnements ou de paiements périodiques (定期定額), ni de paiements échelonnés, ni Apple Pay, ni de factures électroniques ou de logistique, ni d'interrogation du statut côté serveur : si votre boutique ne peut pas recevoir la notification, vérifiez le paiement dans le back-office ECPay.

Commandes

Statuts de commande

No status (missing order) : le client a été envoyé vers ECPay et n'a pas payé, le paiement par carte a échoué ou la notification n'est pas encore arrivée. Dans Sales > Orders, ces commandes ne s'affichent qu'avec le filtre Order Status réglé sur Missing Orders.

Awaiting ECPay payment (default Pending) : le client a choisi ATM, CVS ou Barcode et a reçu les détails de paiement. La note indique le code banque et le compte virtuel, le code de paiement ou les codes-barres, ainsi que la date limite.

Payment accepted (default Processing) : le paiement a été confirmé. Une note indique le TradeNo ECPay, le type de paiement, le montant et le numéro de transaction (avec une mention de mode test pour les paiements sandbox).

ECPay payment on hold (default Pending) : ECPay a signalé un montant ou une devise différent de celui de la commande (par exemple, le panier a été modifié dans un autre onglet après le début du paiement), un paiement sandbox est arrivé après le passage en mode réel (aucun argent réel n'a été encaissé), ou le paiement est arrivé après que vous avez modifié le statut de la commande, par exemple en l'annulant. La note l'explique. Comparez avec le back-office ECPay, puis traitez la commande ou remboursez le paiement là-bas.

Payment error (default Failed) : ECPay a signalé que le dernier paiement ATM, CVS ou code-barres d'une commande en attente a échoué. La note indique le code de retour et le message ECPay.

Les notifications répétées sont ignorées. Une commande payée n'est jamais rouverte par un échec tardif. Un second paiement pour une commande déjà payée, par exemple depuis deux onglets du navigateur, est enregistré une seule fois sous forme de note, afin que vous puissiez le rembourser dans le back-office ECPay. Les paiements simulés lancés depuis le back-office ECPay sont seulement notés et ne marquent jamais une commande comme payée, car ECPay n'encaisse aucun argent pour eux.

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

Onglet VibeFox ECPay Payment Gateway

Dans Sales > Orders, ouvrez une commande payée avec ECPay. En bas de la page de commande, à côté de History et Additional, l'onglet VibeFox ECPay Payment Gateway liste chaque tentative de paiement de la commande : le MerchantTradeNo avec une étiquette Test mode pour les tentatives sandbox, le mode, le montant en TWD, le statut, le TradeNo ECPay, le type et la date du paiement, le code de retour ECPay et la date de début. En dessous figurent les ECPay notes de la commande. Pour une commande au statut en attente, l'onglet vous rappelle de la comparer avec le back-office ECPay. L'onglet est en lecture seule et s'affiche aux utilisateurs ayant accès à l'extension.

Remboursements

Les remboursements depuis OpenCart ne sont pas disponibles. Remboursez le paiement dans le back-office ECPay, puis mettez à jour manuellement le statut de la commande dans OpenCart. Les retours de produits dans Sales > Returns ne renvoient pas d'argent via ECPay.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox ECPay Payment Gateway est le premier bloc de Extensions > Extensions > Payments > VibeFox ECPay Payment Gateway > Edit, au-dessus des réglages. 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) 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 se trouvent la ligne Product: opencart-payment-ecpay et le lien Manage licenses and domains in your account, qui ouvre votre compte vibefox.net. Seuls les utilisateurs administrateurs disposant du droit Modify sur 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 pour un seul 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, ECPay n'est pas proposé aux clients au moment du paiement. 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 encore 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.

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 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 le statut de licence.

Dépannage

ECPay n'apparaît pas au moment du paiement : vérifiez que la licence est active, que Enable/Disable est activé, que le client paie en TWD et, en mode réel, que Merchant ID, Hash Key et Hash IV sont renseignés. La page des réglages affiche un message concernant la devise et les identifiants du mode réel. Vérifiez aussi 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 réglages.

Le paiement a été effectué, mais la commande reste sans statut : la notification ECPay n'a pas atteint votre boutique (site hors ligne, pare-feu, authentification de base). ECPay réessaie plusieurs fois. Vous pouvez aussi vérifier la transaction dans le back-office ECPay. Activez Enable Logging pour voir les notifications reçues par l'extension ; les notifications rejetées sont de toute façon journalisées comme erreurs.

La notification répond 0|CheckMacValue verification failed : le Hash Key ou le Hash IV ne correspond pas à votre compte ECPay, ou le paiement a été lancé dans l'autre environnement. Recopiez-les depuis le back-office ECPay.

La notification répond 0|MerchantID mismatch : la notification appartient à un autre marchand ECPay que celui avec lequel le paiement a été lancé.

La notification répond 0|Order not found : le numéro de transaction n'a pas été émis par cette boutique, par exemple lorsque plusieurs boutiques partagent un compte ECPay. Donnez à chaque boutique son propre Order Prefix.

La notification répond 0|Retry : la commande était en cours de traitement par une autre notification au même moment, ou le statut de la commande n'a pas pu être défini. ECPay renvoie la notification. Activez Enable Logging pour voir la raison.

La Notification URL affiche 0|Method not allowed in the browser : c'est normal. L'URL n'accepte que les requêtes provenant d'ECPay.

Le client voit This payment method is not available. Please reload the checkout page. : la session de paiement ne correspond plus à la commande, ou le mode de paiement a été désactivé entre-temps. Le client recharge la page de paiement.

Le client voit The order total is too small for ECPay. : le total de la commande est inférieur à 1 TWD après arrondi et ne peut pas être payé avec ECPay.

Le client voit Too many payment attempts for this order : le panier a atteint 30 tentatives de paiement. Demandez au client de commencer un nouveau panier.

La commande est au statut en attente : lisez les notes de l'onglet VibeFox ECPay Payment Gateway (voir Statuts de commande), comparez avec le back-office ECPay, puis traitez la commande ou remboursez le paiement là-bas.

Pour les développeurs : avant l'envoi du formulaire de paiement à ECPay, l'extension déclenche l'événement OpenCart ecpay_p_request_params avec les paramètres et la commande ; le marchand, le numéro de transaction et le montant ne peuvent pas être modifiés par son intermédiaire.

Désinstallation

Allez dans Extensions > Extensions, choisissez le type Payments et cliquez sur Uninstall (le bouton rouge −) à côté de VibeFox ECPay Payment Gateway. La clé de licence et le statut de licence de cette extension sont toujours supprimés. OpenCart supprime toujours ses propres réglages 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. Les événements OpenCart de l'extension sont également supprimés (sur OpenCart 4, également son action de démarrage, qui laisse passer la notification en mode maintenance). Si Delete Data on Uninstall est activé, les autres réglages (titre, description, mode test, identifiants, options de paiement, journalisation) et le journal sont supprimés. S'il est désactivé, ils sont conservés pour une réinstallation ultérieure. Les enregistrements de paiement ECPay sont toujours conservés, de sorte que les notifications tardives de paiements anciens sont encore vérifié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 ECPay Payment Gateway dans la liste des extensions installées, puis sur Delete (le bouton rouge corbeille) pour supprimer le paquet téléchargé.

ECPay est une marque déposée de son titulaire. Cette extension n'est ni affiliée à ECPay ni approuvée par elle.