CartModules: ECPay Payment Gateway

Accept Payments from Taiwan Customers

Integrate ECPay (綠界科技), Taiwan's leading payment gateway, into your CS-Cart or Multi-Vendor store. Accept payments via credit cards, Apple Pay, ATM transfers, convenience store payments (7-Eleven, FamilyMart), TWQR, and barcode payments — all through a single addon.

Supported Payment Methods

• Credit / Debit Cards — Visa, Mastercard, JCB, UnionPay
• Apple Pay — Quick checkout for Apple device users
• ATM Transfer — Virtual ATM account for bank transfers
• Convenience Store (CVS) — Pay at 7-Eleven, FamilyMart, Hi-Life, OK Mart
• TWQR — QR code payments via Taiwan Pay standard
• Barcode — Barcode-based payments at convenience stores

Key Features

• Full ECPay AioCheckOut V5 API integration
• SHA256 CheckMacValue security verification on all callbacks
• Server-to-server callback (ReturnURL) for reliable payment confirmation
• Idempotent callback processing — safe against duplicate notifications
• Live / Sandbox toggle for easy testing
• Configurable order status mapping for successful and failed payments
• TWD (New Taiwan Dollar) currency support
• Compatible with CS-Cart and Multi-Vendor (all editions)
• PCI SAQ A compliant — no card data touches your server
• Clean, well-documented code following CS-Cart addon conventions

Requirements

• CS-Cart or Multi-Vendor 4.x
• PHP 7.1 or higher
• Active ECPay merchant account (https://www.ecpay.com.tw/)
• TWD currency configured in your store

Installation

1. Upload the addon via the CS-Cart admin panel (Addons > Manage addons > Upload)
2. Activate "CartModules: ECPay Payment Gateway"
3. Create a new payment method and select "ECPay Payment Gateway" as the processor
4. Enter your Merchant ID, HashKey, and HashIV from the ECPay merchant portal
5. Set the payment mode to "Test" for sandbox testing, then switch to "Live" when ready

Country & Currency

Country: Taiwan
Currency: TWD (New Taiwan Dollar) — integer amounts only, no decimals