# 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](https://www.ecpay.com.tw/Business/invoice).

***

## Part 2: Connect ECPay to Oddle

### Step 1 — Get your ECPay credentials

1. Log in to the [ECPay merchant dashboard](https://vendor.ecpay.com.tw/).
2. Go to **系統開發管理 > 系統介接設定**.
3. Under **電子發票**, note the following three values — you'll need them in the next steps:
   * **商店代號** (Merchant ID)
   * **介接 HashKey**
   * **介接 HashIV**

![](/files/Wvig1BI8kdyOYmYZqi42)

### Step 2 — Enter your credentials in Oddle

1. Log in to the [Oddle dashboard](https://app.oddle.me/).
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.

![](/files/2CKjJrV6mzKLZiDPzYv8)

6. 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**.

{% hint style="warning" %}
If you process a manual refund, remember to update the payment status to **Unpaid** in Oddle to trigger the allowance. This is not automatic.
{% endhint %}

***

## 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.

![](/files/y0XyjrMY38F86LEHXIdF)

### 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

![](/files/kJpWxWZHyezq2dLxDmaf)

### 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**.

![](/files/siSeAIZnKrPdGBGONhbI)

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.

![](/files/rFr1Zta1xQq1uwAOmhUp)

### 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.

![](/files/a59Z3tT5eofzJjFUgo3s)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://www.oddle.me/docs/help-center/devices-and-integrations/how-do-i-set-up-ecpay-e-invoices-and-invoice-settings-taiwan.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.