ECPay (綠界) Integration
STATUS: SKELETON — body pending.
When to use this skill
- Integrating ECPay for credit card / ATM / CVS 代碼 / 超商取貨付款
- Combining ECPay logistics + payment in one flow
- Computing / verifying CheckMacValue signatures
- Handling ECPay callback webhooks
- Reconciliation with ECPay merchant portal
Do NOT use when
- Non-ECPay provider → specific skill for that provider
- Pure logistics (no payment) →
tw-ecom-logistics-cvs
Core concepts
TODO: ECPay positioning, CheckMacValue signature, the 超取+COD combined model.
Decision tree
TODO: when ECPay's combined flow beats separating payment vs shipping.
Implementation guidance
TODO: merchant setup, first txn, COD-at-pickup reconciliation.
Gotchas
TODO: 5-6 pitfalls (CheckMacValue param ordering / URL encoding gotchas, COD settlement offset, 超取 failure refund flow, cross-sandbox credential leakage, 境外 card compatibility).
IRON LAW
TODO.
Output Format
TODO.
Related
tw-payment-integrationtw-ecom-logistics-cvs
Last verified: 2026-04