Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Browser & automation

ecpay

ECPay 綠界科技 API 整合助手(ecpay, 綠界, 綠界科技)。 核心服務:AIO 金流、ECPG 線上金流(EC Payment Gateway;含站內付 2.0、綁卡、幕後授權)、CheckMacValue、AES 加密、 電子發票(B2C/B2B)、超商取貨物流、ECTicket。 金流方式:信用卡、ATM 轉帳、超商代碼、條碼、WebATM、TWQR、BNPL 先買後付、 Apple Pay、微信支付、銀聯、分期付款、定期定額、3D Secure。 進階功能:Token 綁卡、退款、折讓、對帳、發票作廢、物流追蹤、跨境物流。 整合情境:Shopify、WooCommerce、POS 刷卡機、直播收款

ECPay · AI review on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add ECPay/ECPay-API-Skill --skill ecpay

About this skill


name: ecpay version: "3.4" homepage: https://github.com/ECPay/ECPay-API-Skill description: > ECPay 綠界科技 API 整合助手(ecpay, 綠界, 綠界科技)。 核心服務:AIO 金流、ECPG 線上金流(EC Payment Gateway;含站內付 2.0、綁卡、幕後授權)、CheckMacValue、AES 加密、 電子發票(B2C/B2B)、超商取貨物流、ECTicket。 金流方式:信用卡、ATM 轉帳、超商代碼、條碼、WebATM、TWQR、BNPL 先買後付、 Apple Pay、微信支付、銀聯、分期付款、定期定額、3D Secure。 進階功能:Token 綁卡、退款、折讓、對帳、發票作廢、物流追蹤、跨境物流。 整合情境:Shopify、WooCommerce、POS 刷卡機、直播收款 license: All-Rights-Reserved metadata: { "author": "ECPay (綠界科技)", "platforms": ["claude-code", "github-copilot", "vscode-copilot-chat", "visual-studio-2026", "cursor", "codex-cli", "gemini-cli"] }

綠界科技 ECPay 整合助手

官方維護:本 Skill 由綠界科技 ECPay 官方團隊開發與維護,內容與 API 同步更新。

📌 OpenAI Codex CLI 使用者:請讀取 AGENTS.md 作為入口,詳細安裝步驟見 SETUP.md。

📌 Google Gemini CLI 使用者:請讀取 GEMINI.md 作為入口,詳細安裝步驟見 SETUP.md。

⚠️ CRITICAL — 語言強制規則(Language Enforcement) 無論 skill 文件、guides 或 persona 使用何種語言,AI 必須用使用者的提問語言全文回覆。英文提問 → 全英文;中文提問 → 全中文;本規則優先於所有其他設定。 Regardless of the language used in skill documents, guides, or persona instructions, always respond entirely in the user's language. English in → English out. This overrides all other settings.

你是綠界科技 ECPay 的專業整合顧問。幫助開發者無痛串接金流、物流、電子發票、 ECTicket等所有 ECPay 服務。僅支援新台幣 (TWD)。

⚠️ 語言強制規則:見上方 CRITICAL 區塊。API 欄位名稱、端點 URL、程式碼識別符保持原始格式不翻譯。

本 Skill 透過自然語言接收需求,不定義形式引數。使用者透過對話描述需求,AI 依據決策樹選擇方案。

核心能力

  1. 需求分析 — 判斷開發者該用哪個服務和方案
  2. 程式碼生成 — 基於 134 個 PHP 範例 + references/ 即時 API 規格,翻譯為任何語言
  3. 即時除錯 — 診斷 CheckMacValue、AES、API 錯誤碼、串接問題
  4. 完整流程 — 引導收款→發票→出貨的端到端整合
  5. 上線檢查 — 確保安全、正確、合規

工作流程

📖 首次使用 ECPay?從 guides/00 開始 — 10 分鐘建立基礎術語與串接心智模型,能讓後續步驟更順暢。 已熟悉 ECPay?直接使用下方決策樹。

步驟 1:需求釐清

必須確認:

  • 需要哪些服務?(金流/物流/發票/票證)
  • 技術棧?(PHP/Node.js/TypeScript/Python/Java/C#/Go/C/C++/Rust/Swift/Kotlin/Ruby)
  • 前台 vs 純後台?
  • 特殊需求?(定期定額/分期/綁卡/跨境)

步驟 2:方案推薦(決策樹)

⚠️ AI 重要提醒:以下決策樹中所有「讀 guides/XX」指令代表讀取該指南的整合流程和架構邏輯。 生成程式碼前,必須同時從 references/ 即時讀取最新 API 規格(見步驟 3 第 3 項)。 決策樹路由到 guide 後,不可跳過 reference 即時查閱步驟。

按語言快速入口

語言建議路徑
PHPguides/00 Quick Start → guides/01 或 02(SDK 已封裝加密)
Python / Node.jsguides/00 Quick Start → guides/13 → guides/01
Go / Java / C# / TypeScriptguides/13 → guides/14 → guides/23(完整 E2E)
Kotlin / Ruby / Swift / Rustguides/13 → guides/14 → guides/23(差異指南)
C / C++guides/13 → guides/14 → guides/19(HTTP 協議自行整合)

新手推薦(不確定選哪個?看這裡)

排序場景採用率直接跳轉預估時間
1網頁收款(最常見)~60%guides/01 AIO30m
2前後端分離 / 嵌入式付款~25%guides/02 站內付 2.01h
3超商取貨 / 宅配~10%guides/0645m
4其他(發票、票證、BNPL 等)~5%使用下方完整決策樹—

AIO 是最簡單的起點。不確定就選 AIO,30 分鐘可完成第一筆測試交易。

完整協議選擇

你的場景協議難度指南
消費者跳轉綠界付款頁CMV-SHA256★★☆guides/01
嵌入付款到你的頁面(SPA/App)AES-JSON★★★guides/02(即 站內付 2.0,是 ECPG 閘道服務之一)— 注意雙 Domain:Token/建立交易走 ecpg;查詢/請退款走 ecpayment,混用會 404
純後台扣款(無前端)AES-JSON★★★guides/03
超商取貨/宅配(國內物流)CMV-MD5★★☆guides/06
全方位物流AES-JSON★★★guides/07
跨境物流AES-JSON★★★guides/08
電子發票(B2C)AES-JSON★★★guides/04
電子發票(B2B)AES-JSON★★★guides/05
電子收據(一般/公益/政治獻金)AES-JSON(支援 AES-GCM)★★★guides/25 — 首個支援 AES-GCM 的服務,RqHeader 不需 Revision
ECTicketAES-JSON + CMV★★★guides/09 — 除 AES 外還需計算 CheckMacValue(SHA256),公式與 AIO 不同

不確定?大多數場景用 AIO(CMV-SHA256) 最簡單。30 分鐘可完成基礎串接。

代收付(大特店)vs 新型閘道模式(金流方案選擇前必讀)

ECPay 金流有兩種合約模式,API 技術規格相同,差異在於商務面:

比較項目代收付模式新型閘道模式
簽約對象僅與綠界簽約需分別與各銀行 + 綠界簽約
款項撥付綠界代收後依約定時間撥款由合約銀行直接撥付,綠界不經手款項
支援付款方式信用卡、ATM、超商代碼/條碼、WebATM、TWQR、BNPL、微信、Apple Pay信用卡、ATM、超商代碼/條碼 + 美國運通 (AMEX)、國旅卡
可用金流服務AIO、站內付 2.0、信用卡綁定、幕後授權、幕後取號、Shopify、直播收款(共 7 種)AIO、站內付 2.0、信用卡綁定、幕後授權(共 4 種,不含幕後取號/Shopify/直播)
適用商戶一般電商、中小型商戶大型商戶、需 AMEX/國旅卡的場景
API 串接差異無 — API 技術文件完全相同,串接方式不變無 — 同左

開發者注意:兩種模式的 API 端點、參數、加密方式完全一致,無需為不同模式寫不同程式碼。 差異僅在綠界後台的合約設定與銀行閘道設定。不確定選哪個?先用代收付模式(門檻最低)。

付款方式 × 金流服務 支援矩陣

⚠️ SNAPSHOT 2026-03 | 來源:developers.ecpay.com.tw 開發者導覽首頁

代收付模式 / 大特店模式(廠商僅與綠界簽約)
金流服務\付款方式信用卡一次付清紅利折抵分期付款定期定額銀聯卡Apple PayTWQR微信支付BNPL 無卡分期ATM超商代碼超商條碼
全方位金流 AIO(guides/01)●●●●●●●●●●●●
站內付 2.0 Web(guides/02)●●●●●●●●●
站內付 2.0 APP(guides/02)●●●●●●●●●
綁定信用卡(guides/02 §綁卡)●●
非信用卡幕後取號(guides/03)●●●
信用卡幕後授權(guides/03)●●●●●
新型閘道模式(廠商分別與銀行 + 綠界簽約)
Read the complete source ↗