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
- Upload the addon via the CS-Cart admin panel (Addons > Manage addons > Upload)
- Activate "CartModules: ECPay Payment Gateway"
- Create a new payment method and select "ECPay Payment Gateway" as the processor
- Enter your Merchant ID, HashKey, and HashIV from the ECPay merchant portal
- 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
