使用绿界 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 强制要求「买受人地址」必须有值（缺值会被绿界以「打印发票，买受人地址须有值」退件），因此结账页会确保买家填妥公司地址后才提交订单。

---

在订单「发票」分页查看发票与一键「重寄通知信」

当订单完成付款或退款后，您可在后台「订单」点开该笔订单并切换至「发票」分页（作废与折让的自动判断规则详见）：

---

常见开具失败原因排查

相关文件