使用綠界 ECPay 開立發票

概述

綠界科技（ECPay）是台灣廣泛使用的電子發票加值服務中心（適用於「營業地點」為台灣 TW 且「網站幣別」為新台幣 TWD 的商店）。

在 Kanorio 中，您可以單獨串接綠界的電子發票服務，不需要綁定使用綠界金流——無論買家是用 PAYUNi 統一金流、SHOPLINE Payments、LINE Pay 或街口支付付款，都能由綠界自動開立、作廢或折讓電子發票，並支援在 Kanorio 訂單後台直接點擊「重寄通知信」補發信件給買家。

---

開通前在綠界 ECPay 後台的準備

在前往 Kanorio 填寫憑證前，請先確認您已在 綠界科技官網 完成以下設定：

1. 開通綠界「B2C 電子發票」服務與字軌設定：
   • 完成綠界賣家認證並開通電子發票功能。
   • 在財政部電子發票整合服務平台將發票字軌委任給綠界科技，並於綠界廠商後台確認當期字軌已啟用且有足夠張數。
2. 取得「電子發票專用」介接金鑰（切勿與金流金鑰混用！）：
   • 登入綠界廠商後台 › 前往「系統開發管理 › 系統介接設定」。
   • 找到電子發票介接資訊，複製以下 3 個欄位：
     • MerchantID（特店編號）
     • HashKey（16 碼，電子發票專用）
     • HashIV（16 碼，電子發票專用）

最常見錯誤提醒：請勿填入「金流」的 HashKey / HashIV！ 綠界後台中，「全方位金流」、「物流」與「電子發票」各自使用不同組的 HashKey 與 HashIV。如果誤把金流的金鑰貼到發票設定中，連線測試時會出現解密失敗（代碼 110）。請務必確認複製的是電子發票專用的 16 碼金鑰。

---

在 Kanorio 串接並啟用綠界電子發票的 3 個步驟

1. 填入統編與綠界發票專用金鑰

1. 前往 Kanorio 後台「網站設定 › 發票」。
2. 在「綠界科技 ECPay」卡片點擊「設定憑證」（或「啟用」）。
3. 依序填入：
   • 統一編號（您公司的 8 碼統編）
   • MerchantID（特店編號）
   • HashKey（16 碼）
   • HashIV（16 碼）
4. 點擊「儲存」：系統會自動向綠界發送連線測試，驗證金鑰與 B2C 發票權限是否正常；通過後金鑰即以 Google Cloud KMS 信封加密安全保存。

2. 在「發票管理」將綠界設為啟用

點擊頁面右上角的「發票管理」按鈕，確認 綠界科技 ECPay 位於「已啟用」區塊並儲存。

3. 檢查綠界後台的「發票通知方式設定」

綠界在開立、作廢與折讓發票時會寄送通知信給買家（若為折讓單，Kanorio 會自動帶入買家 Email 請綠界寄發折讓通知憑證）。若您希望避免綠界後台設定與 API 通知重複寄信，可至綠界廠商後台的「發票通知方式設定」確認通知規則。

---

買家結帳體驗與「公司地址必填」原因

啟用綠界電子發票後，結帳頁會提供個人載具（綠界會員載具、手機條碼、自然人憑證）、愛心碼捐贈與公司三聯式統編發票：

• 個人綠界會員載具自動依 Email 歸戶：當買家選擇預設的雲端發票（不填手機條碼）時，系統會依綠界規範將發票歸戶至買家的結帳 Email。
• 公司統編自動帶入抬頭與地址（地址為綠界強制必填）：
  • 買家輸入 8 碼統編時，系統會自動查詢經濟部商工登記資料帶入「公司名稱」與「公司地址」。
  • 依綠界 B2C 電子發票 2.0 規格，打統編的公司發票預設為列印格式（Print=1），綠界 API 強制要求「買受人地址」必須有值（缺值會被綠界以「列印發票，買受人地址須有值」退件），因此結帳頁會確保買家填妥公司地址後才送出訂單。

---

在訂單「發票」分頁檢視發票與一鍵「重寄通知信」

當訂單完成付款或退款後，您可在後台「訂單」點開該筆訂單並切換至「發票」分頁（作廢與折讓的自動判斷規則詳見）：

---

常見開立失敗原因排查

相關文件