使用 ezPay 藍新開立發票

概述

ezPay 藍新電子發票是台灣藍新金流集團旗下的電子發票加值服務平台（適用於「營業地點」為台灣 TW 且「網站幣別」為新台幣 TWD 的商店）。

在 Kanorio 中串接 ezPay 電子發票與收款金流完全獨立：無論買家使用 PAYUNi、SHOPLINE Payments、LINE Pay 或街口支付付款，系統都會在付款成功與退款完成時，自動呼叫 ezPay 介面完成發票開立、作廢或折讓。

---

開通前在 ezPay 後台必做的 3 項準備（防踩坑重點）

許多賣家在串接 ezPay 時，常遇到「儲存憑證連線測試有過，但第一筆訂單開發票卻失敗」的狀況。在回到 Kanorio 填寫金鑰前，請務必登入 ezPay 電子發票平台 確認已完成以下 3 件事：

1. 務必先送出「申請費率方案」啟用合約（最容易遺漏！）

為什麼連線測試成功，開立時卻失敗（錯誤碼 INV90005）？ ezPay 的「查詢 API（用於連線測試）」不會檢查合約狀態，但「開立 API」會嚴格檢查您是否已申請費率方案。若未完成此步驟，實際開立時會回傳 INV90005（合約未生效或已到期）。

• 請登入 ezPay 電子發票後台 › 前往「發票管理 › 管理設定 › 使用狀況 › 申請費率方案」，選擇適合您的方案並送出申請，確認使用狀態為「已啟用」。

2. 完成財政部字軌委任與「發票字軌號碼設定」

1. 在財政部電子發票整合服務平台，使用工商憑證將電子發票字軌號碼相關業務委任給 ezPay 電子發票加值服務平台。
2. 回到 ezPay 後台 › 前往「發票管理 › 管理設定」，開啟「委任下載新增字軌」與「自動上傳空白未使用字軌」，或至「發票字軌號碼設定」確認當期雙月字軌已有可用張數。

3. 複製商店代號與 32 碼 HashKey / 16 碼 HashIV

1. 在 ezPay 後台前往「商店管理 › 詳細資料」。
2. 複製以下 3 個欄位的正式環境資訊（注意：ezPay 測試區 cinv.ezpay.com.tw 與正式區 inv.ezpay.com.tw 是兩套獨立系統，金鑰互不相通，正式商店請務必取自正式區 inv.ezpay.com.tw）：
   • MerchantID（商店代號）
   • HashKey（32 碼英數，AES-256 專用）
   • HashIV（16 碼英數）

---

在 Kanorio 串接並啟用 ezPay 電子發票的步驟

1. 填入憑證並驗證連線

1. 前往 Kanorio 後台「網站設定 › 發票」。
2. 在「ezPay 電子發票」卡片點擊「設定憑證」（或「啟用」）。
3. 依序填入您的 8 碼統一編號、MerchantID（商店代號）、32 碼 HashKey 與 16 碼 HashIV。
4. 點擊「儲存」：系統會立即發送連線測試驗證您的金鑰是否正確；驗證通過後，金鑰會以 Google Cloud KMS 信封加密安全保存（詳見）。

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

點擊頁面右上角的「發票管理」按鈕，將 ezPay 電子發票 拖入「已啟用」區塊並儲存，公開網站結帳頁即刻生效。

---

買家結帳體驗與訂單「發票」分頁操作

1. 買家結帳發票選項：
   • 支援個人雲端發票（預設 ezPay 會員載具、手機條碼、自然人憑證）、愛心碼捐贈（含 919 創世、7585 喜憨兒、25885 家扶快捷鍵）與公司三聯式統編發票。
   • 買家輸入 8 碼統編時，系統自動查詢經濟部商工登記資料帶入「公司名稱」與「公司地址」（ezPay 規定公司統編發票 PrintFlag=Y 必填買受人地址）。
2. 自動開立、作廢與立即確認折讓：
   • 訂單付款成功後 5 分鐘內自動開立；退款完成後依台灣雙月申報期規則自動執行作廢或折讓（ezPay 折讓採用 Status=1 立即確認折讓模式，無需等待買家手動點擊確認信，詳見）。
3. 在訂單「發票」分頁檢視發票：
   • 前往「訂單」點開訂單切換至「發票」分頁，可點擊「複製發票資訊／複製折讓資訊」，或點擊「檢視發票」直接跳轉開啟 ezPay 官方發票查詢頁查看完整發票證明。

---

常見開立失敗原因排查

相關文件