[Skip to main content](#vessel-content)

☰ Documentation

#  ECPay payment plugin

Details    Written by: Administrator    Category: [Payment plugins](/support/documentation/hikashop/payment-plugins)     Published: 09 November 2026     Hits: 8

## Installation

- 1) Have an ECPay merchant account (特店). For tests, the test merchant ECPay publishes on its developer site (merchant ID 3002607, with its HashKey and HashIV) works without an account.
- 2) In the back office of ECPay, open 系統開發管理, 系統介接設定, and note your merchant ID, HashKey and HashIV.
- 3) Install this plugin with the Joomla extension manager and enable it.
- 4) In HikaShop, make sure your shop sells in New Taiwan dollars (TWD): the method only shows for orders in TWD.
- 5) In HikaShop, go to System > Payment methods, click New and choose the ECPay plugin.
- 6) Choose the environment, fill in the merchant ID, the HashKey and the HashIV, choose the payment methods, publish the method and save.
- 7) Nothing is needed in ECPay's back office for the notifications: your shop sends their address with each order. Your shop must be reachable from the internet, on port 80 or 443.

## Configuration

![The settings of the ECPay payment method in HikaShop](/images/doc/plugins/ecpay/ecpay_settings.png)

- **Environment**: Test sends the payments to ECPay's test environment, where nothing is charged; Live to the real one. Use the merchant ID, HashKey and HashIV of the same environment.
- **Merchant ID**: your 特店編號 at ECPay, digits only.
- **HashKey** and **HashIV**: the keys of step 2, which sign every message between your shop and ECPay.
- **Credit check code**: optional, for card refunds: the 商家檢查碼 in ECPay's back office, 信用卡收單, 信用卡授權資訊. With it, the plugin reads the state of the card payment at the bank and cancels or refunds it the right way; without it, it tries a cancellation, then a refund.
- **Payment methods**: "All the methods of my account" lets the customer choose on ECPay's page; a single method sends the customer straight to it.
- **Hidden methods**: with all the methods, the ones ECPay's page must not offer.
- **ATM: days to pay**: from 1 to 60. Empty: 3, ECPay's default.
- **Convenience store code: minutes to pay**: from 1 to 43200 (30 days), used when the method is the convenience store code. Empty: 10080 (7 days), ECPay's default.
- **Barcode: days to pay**: from 1 to 30, used when the method is the barcode. Empty: 7, ECPay's default.
- **Payment page language**: automatic (the language of the order) or always the one chosen.
- **Notification URL**: the address ECPay sends its notifications to, shown for information. It cannot be changed.
- **Debug**: writes every order sent, every notification and every call to ECPay to the payment log of HikaShop.
- **Pending status**: the status of an order waiting for its ATM, convenience store or barcode payment, "pending" by default.
- **Invalid status**: the status of an order whose payment failed, "cancelled" by default.
- **Verified status**: the status of a paid order, "confirmed" by default.
- **Refunded status**: giving an order paid by card this status cancels or refunds its payment at ECPay, "refunded" by default.

## Troubleshooting

- ECPay's page says "CheckMacValue Error" (10200073): the HashKey or the HashIV does not match the merchant ID, or they belong to the other environment.
- The method does not show at the checkout: the cart is not in New Taiwan dollars, or the merchant ID, HashKey or HashIV is missing.
- Orders stay unpaid although the customer paid: ECPay cannot reach your shop (a local address, a firewall, a port other than 80 or 443). Card payments are still confirmed when the customer comes back; for the others, use the "Check the payment at ECPay" button on the order.
- "The status was not changed: ECPay did not refund the card payment": ECPay's answers follow; a refund is not possible on ECPay's test environment, and the credit check code helps pick the right action.
- Payments by ATM, convenience store or barcode are refunded from ECPay's back office, not from HikaShop: the plugin tells you so when you give such an order the refunded status.
- ECPay blocks a shop that asks it too many questions in a short time for 30 minutes: use the check button only when needed.