VibeFox ECPay for PrestaShop

Présentation

VibeFox ECPay Payment Gateway ajoute à PrestaShop ECPay (綠界), le service de paiement taïwanais. À l'étape de paiement, le client choisit ECPay, est redirigé vers la page de paiement hébergée par ECPay et paie par carte de crédit, compte virtuel ATM, code de paiement en magasin de proximité ou code-barres de magasin de proximité. Les données de carte n'atteignent jamais votre site. La commande n'est créée qu'après confirmation du paiement par ECPay au moyen d'une notification signée ; les paiements abandonnés ne laissent donc aucune commande impayée.

Elle convient aux boutiques basées à Taïwan qui vendent en nouveaux dollars taïwanais (TWD). Le module ne prend que les paiements uniques. Il ne gère pas les remboursements depuis PrestaShop (les remboursements se font dans le back-office ECPay), ni les cartes enregistrées, abonnements ou paiements périodiques, paiements échelonnés, Apple Pay, factures électroniques ou logistique.

Principales fonctionnalités

Quatre méthodes ECPay : carte de crédit, compte virtuel ATM, code CVS (magasin de proximité) et code-barres. Avec plusieurs méthodes activées, le client en choisit une lors du tunnel de commande.

Payée seulement après confirmation d'ECPay : une commande n'est créée que par la notification du serveur ECPay, avec une signature CheckMacValue valide, pour un numéro de transaction émis par cette boutique et un montant payé qui correspond au panier. Le retour du client seul ne crée jamais de commande.

Instructions de paiement pour les méthodes hors ligne : pour ATM, CVS et code-barres, la commande attend en Awaiting ECPay payment, et le compte, le code ou les codes-barres ainsi que la date limite de paiement sont affichés sur la page de confirmation de commande et dans le détail de commande du client.

Nouvelles tentatives sécurisées : chaque tentative de paiement reçoit un nouveau numéro de transaction ECPay, si bien que les nouvelles tentatives après un paiement échoué ou annulé fonctionnent. Un second paiement pour une commande déjà payée est noté pour remboursement.

Aucune surprise : les notifications répétées sont ignorées, les paiements simulés depuis le back-office ECPay ne créent jamais de commandes, et les écarts de montant, les paiements sandbox après passage en mode réel ou les paiements de commandes annulées sont placés dans ECPay payment on hold.

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

Bloc ECPay sur la page de commande : il affiche les tentatives de paiement avec leurs numéros de transaction ECPay, leur statut et les notes ECPay de la commande. Journal facultatif sans clés ni données clients ; les erreurs sont toujours journalisées.

Prérequis

PrestaShop 8.0 à 9.x, PHP 8.0 ou ultérieur. 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).