VibeFox ECPay for PrestaShop

Overview

VibeFox ECPay Payment Gateway adds ECPay (綠界), the Taiwanese payment service, to PrestaShop. At the payment step the customer chooses ECPay, is sent to the ECPay hosted payment page and pays by credit card, ATM virtual account, convenience store payment code or convenience store barcode. Card data never touches your site. The order is created only after ECPay confirms the payment with a signed notification, so abandoned payments leave no unpaid orders.

It suits shops in Taiwan that sell in New Taiwan Dollars (TWD). The module takes one-time payments only. It has no refunds from PrestaShop (refunds are made in the ECPay back-office), no saved cards, subscriptions or periodic payments, installments, Apple Pay, e-invoices or logistics.

Key features

Four ECPay methods: Credit Card, ATM virtual account, CVS code (convenience store) and Barcode. With several methods enabled, the customer chooses one at checkout.

Paid only when ECPay confirms: an order is created only by the ECPay server notification with a valid CheckMacValue signature, for a trade number this shop issued, with a paid amount that matches the cart. The customer's return alone never creates an order.

Payment instructions for offline methods: for ATM, CVS and Barcode the order waits in Awaiting ECPay payment, and the account, code or barcodes with the payment deadline are shown on the order confirmation page and in the customer's order details.

Safe retries: every payment attempt gets a new ECPay trade number, so retries after a failed or cancelled payment work. A second payment for a paid order is noted for refund.

No surprises: repeated notifications are ignored, simulated payments from the ECPay back-office never create orders, and amount mismatches, sandbox payments after going live or payments for cancelled orders go to ECPay payment on hold.

Test without an account: test mode uses the public ECPay sandbox merchant, so you can test before you have ECPay keys.

ECPay block on the order page: the payment attempts with the ECPay trade numbers, their status and the ECPay notes of the order. Optional log without keys or customer data; errors are always logged.

Requirements

PrestaShop 8.0 to 9.x, PHP 8.0 or later. The TWD currency in your shop. An ECPay merchant account (MerchantID, HashKey, HashIV) for live payments. A shop reachable from the internet on port 80/443. A VibeFox license key from vibefox.net (one key per domain).