使用 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 官方发票查询页查看完整发票证明。

---

常见开立失败原因排查

相关文件