How do I set up ECPay e-invoices and invoice settings (Taiwan)?

This article covers everything you need to know about electronic invoicing for Taiwan — from registering with ECPay to configuring your checkout page and tracking issued invoices.

Taiwan law requires businesses to issue electronic invoices (e-invoices) for sales. Oddle integrates with ECPay to automate this process for your Oddle Shop orders.

---

Part 1: Register for ECPay

Before setting up the integration, you need an ECPay business account. ECPay is a third-party provider — fees apply.

Sign up and learn more at ecpay.com.tw.

---

Part 2: Connect ECPay to Oddle

Step 1 — Get your ECPay credentials

1. Log in to the ECPay merchant dashboard.
2. Go to 系統開發管理 > 系統介接設定.
3. Under 電子發票, note the following three values — you'll need them in the next steps:

   • 商店代號 (Merchant ID)
   • 介接 HashKey
   • 介接 HashIV

Step 2 — Enter your credentials in Oddle

1. Log in to the Oddle dashboard.
2. Click on your menu name, then click Invoice in the left panel.
3. Make sure Show e-invoice interface is selected.
4. Enable the toggle for 綠界科技ECPay e-invoice.
5. Enter the 商店代號, 電子發票介接 HashKey, and 電子發票介接 HashIV from Step 1.

1. Click Save.

The integration is now active. ECPay will automatically issue e-invoices for your online orders.

---

Part 3: How e-invoices are issued

How and when e-invoices are issued depends on your Oddle plan.

Oddle Lite plan

• An e-invoice is issued automatically as soon as online payment is received.
• When a refund is processed online, an allowance is automatically issued against the corresponding e-invoice.
• If any of the following fields on an order are updated after the e-invoice has been issued, a new e-invoice is re-issued to replace it:

  • Unified Business Number (統一編號)
  • Organisation Name (公司名稱)
  • Carrier Type (載具類別)
  • Individual ID (載具)

All other plans

• An e-invoice is issued when you update the order payment status to Paid.
• An allowance is issued when you update the payment status to Unpaid.

If you process a manual refund, remember to update the payment status to Unpaid in Oddle to trigger the allowance. This is not automatic.

---

Part 4: Configuring the invoice interface on your checkout page

Your Oddle Shop checkout page includes an Invoice Information section where guests can enter their invoice details. There are two versions of this interface.

Default invoice interface

The default interface is for merchants who issue invoices manually. Guests can optionally enter their Unified Business Number and Organisation Name if they need a uniform invoice for their company.

E-invoice interface

The e-invoice interface is for merchants using ECPay (or another e-invoice integration). In addition to the business number and organisation name, guests can choose how to receive their e-invoice:

• E-invoice carrier
• Cellphone barcode
• Citizen Digital Certificate

Switching to the e-invoice interface

1. Log in to your Oddle dashboard.
2. Click on your menu name.
3. Click Invoice in the left panel.
4. Select Show e-invoice interface and click Save.

The e-invoice interface will now appear on your checkout page.

---

Part 5: Checking e-invoice status

For customers

Customers can check their e-invoice status and number under Order History in Oddle Shop after the invoice has been issued.

For merchants — individual orders

In the Oddle dashboard or Register App, open an order and look for the E-invoice No. field. Once the invoice has been issued, the number will appear there.

For merchants — e-invoice report

To view all issued invoices and allowances in one place:

1. In the Oddle dashboard, go to Analytics > E-invoice.
2. Select the menu and issuance period you want to review.