綠界 ECPay API Skill：官方 AI 串接知識包，不是 SDK，也不是開源授權 | Allen 知識庫 | Allen 知識庫
AI threads
綠界 ECPay API Skill：官方 AI 串接知識包，不是 SDK，也不是開源授權 2026年9月22日 5 分鐘閱讀 👁 7
綠界 ECPay API Skill：官方 AI 串接知識包，不是 SDK，也不是開源授權
ECPay API Skill 是綠界官方維護的 AI coding assistant 知識包，目標是讓 Claude Code、VS Code Copilot Chat、GitHub Copilot CLI、Cursor、Codex CLI、Gemini CLI 等工具在串接綠界金流、物流、電子發票、ECTicket 時，能讀取結構化指南、官方文件索引、測試向量與範例。社群說「Claude 安裝後可協助串接、自動開電子發票」方向正確，但要修正為：它本身不是代你呼叫 API 的服務，也不是 SDK；AI 生成的程式碼仍需工程師驗證、測試與保護正式憑證。
Threads 貼文稱 ECPay 推出可供 AI 使用的 API Skill，Claude 安裝後可協助串接，甚至自動開電子發票，並連到 GitHub repo ECPay/ecpay-api-skill。
核實後：
GitHub repo 確實存在，owner 為 ECPay，repo 名稱為 ECPay-API-Skill。
README 明確寫「綠界科技官方出品」，由 ECPay 團隊開發與維護。
Skill 入口為 SKILL.md，版本目前標示為 3.4。
它支援多個 AI 程式開發助手，不只 Claude Code，也包含 VS Code Copilot Chat、Visual Studio 2026、GitHub Copilot CLI、Cursor、OpenAI Codex CLI、Google Gemini CLI。
「自動開電子發票」應理解為：AI 可以依據 Skill 生成／修改串接程式碼與排錯流程；真正開立發票仍是你的系統用商店憑證呼叫 ECPay API，且必須通過測試與正式環境切換。
GitHub API 顯示 ECPay/ECPay-API-Skill 是 public repo，預設分支為 master，repo 描述為「ECPay API Skill 是一個 API AI Skill 套件」。目錄包含：
閱讀資訊
閱讀時間 5 分鐘
段落層級 24
瀏覽 7
日期 2026年9月22日
SKILL.md
SETUP.md
AGENTS.md
GEMINI.md
guides/
references/
scripts/
test-vectors/
SECURITY.md
LICENSEREADME 標示當前版本為 V3.4。SKILL.md frontmatter 也標示 version 3.4，homepage 指向 GitHub repo。
README 將 ECPay API Skill 定義為「AI 知識套件」，不是瀏覽器裡的一般聊天機器人，也不是 SDK。它提供 Markdown 文件、決策樹、整合指南、加密範例與官方 API 索引，讓 AI coding assistant 在專案中產生程式碼、診斷 CheckMacValue／AES／錯誤碼問題，並引導收款、發票、出貨等完整流程。
需求分析：判斷應用場景該用哪個 ECPay 服務。
程式碼生成：基於 PHP 範例與 references 即時 API 規格，翻譯為其他語言。
即時除錯：診斷 CheckMacValue、AES、API 錯誤碼與串接問題。
完整流程：收款 → 發票 → 出貨。
上線檢查：安全、正確性與合規檢查。
SKILL.md 與 README 涵蓋的主要服務包括：
AIO 全方位金流
ECPG 站內付 2.0
信用卡綁卡與幕後授權
CheckMacValue
AES 加解密
B2C／B2B 電子發票
電子收據
國內物流、全方位物流、跨境物流
ECTicket
Shopify、WooCommerce、POS、直播收款等情境
references/README.md 說明 references/ 目錄是 ECPay 官方開發者文件 URL 索引，合計約 20 個檔案、約 443 個 URL，指向 developers.ecpay.com.tw 的最新 API 規格。這是此 Skill 最有價值的設計：guides 提供整合邏輯，references 指向官方規格，避免 AI 只靠舊快照生成程式碼。
GitHub API 將 license 識別為 Other / NOASSERTION。LICENSE 內容明確是 All Rights Reserved ，版權歸綠界科技股份有限公司所有。
檢視及研讀內容。
執行程式碼範例以測試綠界 API 串接。
搭配 AI coding assistant 參考本著作，產出自有的 ECPay API 串接程式碼。
將全部或部分內容複製到共享函式庫、SDK 或教學素材中散布。
重新散布、轉授權或出售。
建立衍生著作用於商業銷售。
移除或修改著作權聲明或授權標示。
因此，這不是 MIT／Apache／BSD 開源專案。可以 clone／fork 供個人或組織內部評估與串接開發，但不應把內容打包成自己的 SDK、課程材料或商業知識庫再散布。
git clone https://github.com/ECPay/ECPay-API-Skill.git ~/.claude/skills/ecpay
或放在專案層級 .claude/skills/ecpay。安裝後可用 /ecpay 或詢問可用 skills 進行驗證。
SETUP.md 說明 Codex CLI 使用 AGENTS.md 作為入口，Gemini CLI 使用 GEMINI.md 作為入口。建議將 repo clone 到專案內 .ecpay-skill，再在專案根目錄的入口文件追加說明，讓 AI 讀取 .ecpay-skill/<入口文件> 作為 ECPay 整合知識庫入口。
README 提供 VS Code Copilot Chat、Visual Studio 2026、Cursor 的對應說明文件。這代表 ECPay 不是只針對 Claude，而是用多入口文件讓不同 AI coding assistant 都能讀到同一套知識。
references/README.md 明確說 guides 中的參數表是 snapshot；生成程式碼前，應透過 references 中的 URL 索引查閱 developers.ecpay.com.tw 最新規格。這點很重要，因為付款、發票、物流 API 的欄位與端點若過期，會直接造成交易失敗。
Skill 能讓 AI 更懂 ECPay，但 AI 仍可能誤用欄位、混淆服務、產生過時程式碼。正式上線前仍需工程師 review、測試環境驗證、callback 驗證、錯誤碼處理與資安檢查。
SECURITY.md 明確要求不要提交真實 MerchantID、HashKey、HashIV、.env 或正式憑證。正式環境應使用 AWS Secrets Manager、GCP Secret Manager、Azure Key Vault、Kubernetes Secrets、Vault 或平台環境變數，而不是把 .env 放到伺服器或 repo。
Skill 特別強調 CheckMacValue、AES-CBC／AES-GCM、三層 JSON、TransCode／RtnCode 的雙層檢查等。這些是綠界串接常見失敗點；導入 AI 後仍應用測試向量與官方測試帳號驗證。
雖然 repo 公開，但 license 是 All Rights Reserved。團隊可用於內部串接參考，但若要整理成公司內外部教材、SDK、共享模板或二次發布，需先確認是否超出授權。
Skill 自己也說 references 指向官方開發者文件；遇到 API 參數、端點、測試帳號或版本差異時，應以 developers.ecpay.com.tw 最新官方文件為準。
將 Skill clone 到專案內 .ecpay-skill。
在 AGENTS.md、GEMINI.md 或 IDE instructions 中明確要求 AI 先讀 Skill。
先用 AIO 或 B2C 發票測試帳號完成最小可行交易／開票。
對 AI 產生的 CheckMacValue 與 AES 程式碼跑 test vectors。
將 HashKey／HashIV 改為環境變數或 secret manager。
讓 AI 先讀現有付款／發票流程，再比對 Skill guides。
不要一次重寫金流；先針對錯誤碼處理、callback 驗證、密鑰管理補強。
對 staging 交易建立 golden tests。
將 ECPay ReturnURL、ClientBackURL、NotifyURL 流程畫成 sequence diagram 後再改程式。
固定 repo 版本或 tag，避免 Skill 更新造成 AI 行為不穩定。
PR 中禁止提交真實金鑰。
對付款與發票程式碼強制 code review。
每次升級 Skill 後重跑金流／發票 smoke tests。
ECPay API Skill 是綠界官方把 API 串接知識整理給 AI coding assistant 使用的一步。它的價值不在於取代官方 SDK，而在於把決策樹、整合指南、官方文件索引、測試向量與安全規則放進 AI 可讀的 repo。社群說法可保留，但應加上三個 caveat：它不是 SDK、不是自動代營運服務、也不是開源授權。最安全的用法是把它作為 AI 輔助串接手冊，讓工程師在測試環境逐步驗證後再上線。
社群來源：Threads 貼文，作為發現線索。
官方 GitHub：ECPay/ECPay-API-Skill。
官方 repo 文件：README、SKILL、SETUP、LICENSE、SECURITY、references。
官方 API 文件：developers.ecpay.com.tw，透過 repo references 索引查閱。