VibeFox ECPay for OpenCart

Présentation

VibeFox ECPay Payment Gateway ajoute à OpenCart 3 et OpenCart 4 ECPay (綠界), le service de paiement taïwanais. À la dernière étape de commande, le client clique sur Confirm Order, est redirigé vers la page de paiement hébergée d'ECPay et paie par carte de crédit, par compte virtuel ATM, par code de paiement en supérette ou par code-barres en supérette. Les données de carte ne transitent jamais par votre site. OpenCart crée la commande avant le paiement, mais la commande ne reçoit un statut qu'après qu'ECPay a confirmé le paiement par une notification signée. Les tentatives non payées restent donc des commandes manquantes.

Elle convient aux boutiques de Taïwan qui vendent en nouveaux dollars taïwanais (TWD). L'extension ne gère que les paiements uniques. Elle ne permet pas de rembourser depuis OpenCart (les remboursements se font dans le back-office d'ECPay), ni les cartes enregistrées, les abonnements ou paiements récurrents, les paiements en plusieurs fois, Apple Pay, la facturation électronique ou la logistique.

Principales fonctionnalités

Quatre moyens de paiement ECPay : carte de crédit, compte virtuel ATM, code CVS (supérette) et code-barres. Si plusieurs moyens sont activés, le client en choisit un à l'étape Confirm Order.

Payée uniquement après confirmation d'ECPay : une commande ne reçoit son statut que de la notification serveur d'ECPay portant une signature CheckMacValue valide, pour un numéro de transaction émis par cette boutique et avec un montant payé correspondant à la commande. Le simple retour du client ne modifie jamais une commande. OpenCart envoie ensuite ses e-mails habituels de commande.

Instructions de paiement pour les moyens hors ligne : pour ATM, CVS et code-barres, la commande attend dans un statut d'attente, et le compte, le code ou les codes-barres avec la date limite de paiement s'affichent sur la page de confirmation de commande et dans les informations de commande du client.

Nouvelles tentatives sans risque : chaque tentative de paiement reçoit un nouveau numéro de transaction ECPay, donc les nouvelles tentatives après un échec fonctionnent. Un second paiement pour une commande déjà payée est signalé pour remboursement.

Sans surprise : les notifications répétées sont ignorées, les paiements simulés depuis le back-office d'ECPay ne marquent jamais une commande comme payée, et les écarts de montant, les paiements sandbox après la mise en production ou les paiements de commandes annulées passent dans un statut de vérification.

Test sans compte : le mode test utilise le marchand sandbox public d'ECPay, vous pouvez donc tester avant d'avoir des clés ECPay.

Onglet ECPay sur la page de commande : les tentatives de paiement avec leurs numéros de transaction ECPay, leur statut et les notes ECPay de la commande.

Vos propres statuts de commande et conditions OpenCart : choisissez le statut d'un paiement réussi, en attente, en suspens et échoué, la zone géographique, le montant minimum de commande et l'ordre de tri. Journal facultatif sans clés ni données client ; les erreurs sont toujours journalisées.

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 supérieur. Un même téléchargement contient les paquets pour les deux versions. La devise TWD dans votre boutique. Un compte marchand ECPay (MerchantID, HashKey, HashIV) pour les paiements réels. Une boutique accessible depuis Internet sur le port 80/443. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).