ECPay/ECPay-API-Skill

Do not change this format. URLs follow the pattern `https://developers.ecpay.com.tw/{numeric_id}.md`.

# Run URL checks in parallel (8 concurrent) using a single curl per URL

# Each result line is either "FAIL [STATUS] url" or "WARN [type] detail"           REPORT=$(grep -roP 'https://[^)\">\s]*ecpay[^)\">\s]*' references/ --include='*.md' | \             sed 's/^[^:]*://' | sort -u | \

REPORT=$(grep -roP 'https://[^)\">\s]*ecpay[^)\">\s]*' references/ --include='*.md' | \

trap "rm -f \"$TMPFILE\"" EXIT

trap "rm -f \"$TMPFILE\"" EXIT               # Single curl: body → TMPFILE, HTTP status and effective URL → stdout               CURL_VARS=$(curl -s -L --retry 3 --retry-delay 5 --retry-all-errors --max-time 15 \

# Single curl: body → TMPFILE, HTTP status and effective URL → stdout               CURL_VARS=$(curl -s -L --retry 3 --retry-delay 5 --retry-all-errors --max-time 15 \                 -o "$TMPFILE" -w "%{http_code} %{url_effective}" "$url" 

CURL_VARS=$(curl -s -L --retry 3 --retry-delay 5 --retry-all-errors --max-time 15 \

[Credential-related source omitted]

所有重要的版本變更都記錄在此。格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-TW/1.0.0/)。

- **JS SDK 測試環境網址對齊官方 8989**：依[綠界官方 WEB JS SDK 使用說明](https://developers.ecpay.com.tw/8989/)，測試環境改用 `ecpg-stage.ecpay.com.tw/Scripts/sdk-1.0.0.js`、正式用 `ecpg.ecpay.com.tw/Scripts/sdk-1.0.0.js`，並統一帶版本參數 `?t=20210121100116`；載入的 SDK 環境須與 `ECPay.

- **`guides/06-logistics-domestic.md`**:`/Helper/QueryLogisticsTradeInfo/V5` → `/V2`(SDK example 為 V2,guide 杜撰 V5,複製貼上後直接 404) - **`guides/02-payment-ecpg.md`**:ThreeDURL 範例從杜撰的 `payment-stage.ecpay.com.tw/Cashier/3DVerify?tk=...` 改為官方真實格式 

- **`guides/02-payment-ecpg.md`**:ThreeDURL 範例從杜撰的 `payment-stage.ecpay.com.tw/Cashier/3DVerify?tk=...` 改為官方真實格式 `https://3durl.com.tw/...`(經 web_fetch 9053.md 確認)

- **`docs/internal/` 從公開 repo 移除**：此目錄內含公司內部文件（業務/行銷簡報、內部 audit report），不屬於公開 AI skill 知識庫範圍。執行步驟：① `git rm --cached docs/internal/簡報-ECPay-AI-Skill套件-Slides版.md docs/internal/簡報-ECPay-AI-Skill套件內部說明.md` 解除 HEAD tracking ② `.gitignore` 新增 `

- **`業務說明.md` 從公開 repo 完全移除（含歷史）**：此檔案為供業務人員、專案經理、客戶成功團隊閱讀的內部對外說明文件，不屬於公開 AI skill 知識庫範圍。執行步驟：① `git rm --cached` 解除 HEAD tracking ② `.gitignore` 新增 entry 避免後續誤 commit ③ `git filter-repo --path 業務說明.md --invert-paths` 從所有歷史 commit 中清除此檔案 ④ 

[Credential-related source omitted]

[Unreleased]: https://github.com/ECPay/ECPay-API-Skill/compare/v2.0.0...HEAD

[2.0.0]: https://github.com/ECPay/ECPay-API-Skill/compare/v1.5.7...v2.0.0

[1.5.4]: https://github.com/ECPay/ECPay-API-Skill/compare/v1.5.3...v1.5.4

[1.5.3]: https://github.com/ECPay/ECPay-API-Skill/compare/v1.5.2...v1.5.3

[1.5.2]: https://github.com/ECPay/ECPay-API-Skill/compare/v1.5.1...v1.5.2

[1.5.1]: https://github.com/ECPay/ECPay-API-Skill/compare/v1.5.0...v1.5.1

[1.5.0]: https://github.com/ECPay/ECPay-API-Skill/compare/v1.1.0...v1.5.0

[1.1.0]: https://github.com/ECPay/ECPay-API-Skill/compare/v1.0.0...v1.1.0

[1.0.0]: https://github.com/ECPay/ECPay-API-Skill/releases/tag/v1.0.0

**Contact**: techsupport@ecpay.com.tw | GitHub Issues: https://github.com/ECPay/ECPay-API-Skill/issues

1. **URL 可達性驗證**：抽查 references/ 中的 URL 是否仍可存取（建議每季抽查 10-20 個 URL） 2. **AI 即時讀取測試**：使用 `web_fetch` 讀取 2-3 個 reference URL，確認回傳內容包含預期的 API 參數表 3. **PHP SDK 版本檢查**：比對 `scripts/SDK_PHP/composer.json` 與 [ECPay 官方 PHP SDK](https://github.com/ECPa

2. **AI 即時讀取測試**：使用 `web_fetch` 讀取 2-3 個 reference URL，確認回傳內容包含預期的 API 參數表 3. **PHP SDK 版本檢查**：比對 `scripts/SDK_PHP/composer.json` 與 [ECPay 官方 PHP SDK](https://github.com/ECPay/ECPayAIO_PHP) 最新版本 4. **AI Section Index 驗證**：執行 `bash scripts/v

3. **PHP SDK 版本檢查**：比對 `scripts/SDK_PHP/composer.json` 與 [ECPay 官方 PHP SDK](https://github.com/ECPay/ECPayAIO_PHP) 最新版本

ECPay 官方 API 變更公告請見：[developers.ecpay.com.tw](https://developers.ecpay.com.tw)

- **棄用警告**：若 ECPay 官方廢棄某 API 端點，對應 guide 頂部將標注 `⚠<U+FE0F> 已棄用（官方公告：YYYY-MM）`，並維持至少一個版本的過渡說明 - **主版本升級**（如 v3.x）：提前在 `guides/00` 頂部列出破壞性變更清單，讓開發者有足夠時間準備遷移；所有破壞性變更同步記錄於 [CHANGELOG.md](./CHANGELOG.md) - ECPay API 官方棄用公告請見 [developers.ecpay.com.tw](ht

- ECPay API 官方棄用公告請見 [developers.ecpay.com.tw](https://developers.ecpay.com.tw)

# Clone 後切換至特定版本 git clone https://github.com/ECPay/ECPay-API-Skill.git ~/.codex/ecpay-skill

git clone https://github.com/ECPay/ECPay-API-Skill.git ~/.codex/ecpay-skill

| **VS Code Copilot Chat** | VS Code + GitHub Copilot 訂閱 | [vscode_copilot.md](./vscode_copilot.md) | | **Visual Studio 2026** | Visual Studio 2026 (v18.0+) + GitHub Copilot | [visual_studio_2026.md](./visual_studio_2026.md) | | Claude Code

| **Visual Studio 2026** | Visual Studio 2026 (v18.0+) + GitHub Copilot | [visual_studio_2026.md](./visual_studio_2026.md) | | Claude Code | Claude 訂閱或 Anthropic Console API 帳號 | [安裝文件](https://code.claude.com/docs/en/overview) | | GitHub C

| Claude Code | Claude 訂閱或 Anthropic Console API 帳號 | [安裝文件](https://code.claude.com/docs/en/overview) | | GitHub Copilot CLI | GitHub Copilot 訂閱 | [安裝文件](https://docs.github.com/en/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-cop

| GitHub Copilot CLI | GitHub Copilot 訂閱 | [安裝文件](https://docs.github.com/en/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli) | | Cursor | Cursor 安裝完成 | [下載頁面](https://cursor.com/download) | | OpenAI Codex CLI | OpenAI 帳號

| Cursor | Cursor 安裝完成 | [下載頁面](https://cursor.com/download) |

# 個人全域安裝（推薦，所有專案共享） git clone https://github.com/ECPay/ECPay-API-Skill.git ~/.claude/skills/ecpay

git clone https://github.com/ECPay/ECPay-API-Skill.git ~/.claude/skills/ecpay

# 或專案層級安裝（僅當前專案） git clone https://github.com/ECPay/ECPay-API-Skill.git .claude/skills/ecpay

git clone https://github.com/ECPay/ECPay-API-Skill.git .claude/skills/ecpay

# Clone 至專案目錄 git clone https://github.com/ECPay/ECPay-API-Skill.git .ecpay-skill

git clone https://github.com/ECPay/ECPay-API-Skill.git .ecpay-skill

# 方式一：Clone 本 repo，再將 .github/copilot-instructions.md 的內容複製到 # 你的目標專案根目錄的 .github/copilot-instructions.md 中（手動貼上，非自動 include） git clone https://github.com/ECPay/ECPay-API-Skill.git /path/to/ecpay-skill

git clone https://github.com/ECPay/ECPay-API-Skill.git /path/to/ecpay-skill

# 方式二：Clone 到目標專案的子目錄，再手動將 .github/copilot-instructions.md 的 # 完整內容貼至目標專案的 .github/copilot-instructions.md 末尾 git clone https://github.com/ECPay/ECPay-API-Skill.git .github/skills/ecpay

git clone https://github.com/ECPay/ECPay-API-Skill.git .github/skills/ecpay

# 方式一（推薦）：Clone 至專案目錄，Cursor 可透過 AGENTS.md 自動偵測 git clone https://github.com/ECPay/ECPay-API-Skill.git .ecpay-skill

git clone https://github.com/ECPay/ECPay-API-Skill.git .ecpay-skill

git clone https://github.com/ECPay/ECPay-API-Skill.git ~/.claude/skills/ecpay

以 8 執行緒並行 curl 檢查 `references/` 目錄下全部 443 個 `developers.ecpay.com.tw` URL：

- [綠界科技官網](https://www.ecpay.com.tw)

- [開發者文件](https://developers.ecpay.com.tw)

- [PHP SDK GitHub](https://github.com/ECPay/ECPayAIO_PHP)

1. **API 規格**：比對 [developers.ecpay.com.tw](https://developers.ecpay.com.tw) 官方文件

2. **PHP SDK**：比對 [ECPay 官方 GitHub](https://github.com/ECPay/ECPayAIO_PHP) 的範例程式碼

3. **技術諮詢**：至 [GitHub Issues](https://github.com/ECPay/ECPay-API-Skill/issues) 提問確認

| 用途 | 聯繫方式 | |------|---------| | Skill 技術諮詢 | [GitHub Issues](https://github.com/ECPay/ECPay-API-Skill/issues) |

| Skill 技術諮詢 | [GitHub Issues](https://github.com/ECPay/ECPay-API-Skill/issues) |

- **GitHub**：[提交 Security Issue](https://github.com/ECPay/ECPay-API-Skill/issues)

[Credential-related source omitted]

| 環境 | 推薦方案 | |------|---------| | AWS | [AWS Secrets Manager](https://docs.aws.amazon.com/secretsmanager/) 或 [AWS Parameter Store](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-parameter-store.html)（免費方案） |

|------|---------| | AWS | [AWS Secrets Manager](https://docs.aws.amazon.com/secretsmanager/) 或 [AWS Parameter Store](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-parameter-store.html)（免費方案） | | GCP | [Google

| AWS | [AWS Secrets Manager](https://docs.aws.amazon.com/secretsmanager/) 或 [AWS Parameter Store](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-parameter-store.html)（免費方案） |

| GCP | [Google Cloud Secret Manager](https://cloud.google.com/secret-manager) |

| Azure | [Azure Key Vault](https://azure.microsoft.com/services/key-vault/) |

| Vercel / Netlify | 平台內建 Environment Variables（加密儲存，不可在 UI 查看） | | Docker / K8s | Kubernetes Secrets 或 [HashiCorp Vault](https://www.vaultproject.io/) | | 自架伺服器 | 作業系統環境變數（由 systemd / supervisor 注入，不寫入磁碟） |

| Docker / K8s | Kubernetes Secrets 或 [HashiCorp Vault](https://www.vaultproject.io/) |

[Credential-related source omitted]

| 平台 | 安裝 | 官方文件 | |------|------|---------| | Codex | `npm install -g @openai/codex` | [github.com/openai/codex](https://github.com/openai/codex) |

|------|------|---------| | Codex | `npm install -g @openai/codex` | [github.com/openai/codex](https://github.com/openai/codex) | | Gemini | `npm install -g @google/gemini-cli` | [github.com/google-gemini/gemini-cli](https://github.com/goog

| Codex | `npm install -g @openai/codex` | [github.com/openai/codex](https://github.com/openai/codex) |

| Gemini | `npm install -g @google/gemini-cli` | [github.com/google-gemini/gemini-cli](https://github.com/google-gemini/gemini-cli) |

git clone https://github.com/ECPay/ECPay-API-Skill.git .ecpay-skill

git submodule add https://github.com/ECPay/ECPay-API-Skill.git .ecpay-skill

Unsupported or unresolved allowed-tools declaration

name: ecpay version: "3.4" homepage: https://github.com/ECPay/ECPay-API-Skill

version: "3.4" homepage: https://github.com/ECPay/ECPay-API-Skill description: >

homepage: https://github.com/ECPay/ECPay-API-Skill

> ⚠<U+FE0F> **SNAPSHOT 2026-03** | 來源：[developers.ecpay.com.tw](https://developers.ecpay.com.tw/) 開發者導覽首頁

| 8 | `RtnCode` 型別比對錯誤（字串 vs 整數） | 判斷永遠失敗 | CMV 協定→字串；AES-JSON→整數 | | 9 | 對非信用卡付款呼叫 DoAction 退款 | API 回錯誤 | 先檢查 PaymentType | | 10 | ItemName 含系統關鍵字（echo、curl 等） | WAF 攔截 10400011 | 僅放商品名稱 |

| 9 | 對非信用卡付款呼叫 DoAction 退款 | API 回錯誤 | 先檢查 PaymentType | | 10 | ItemName 含系統關鍵字（echo、curl 等） | WAF 攔截 10400011 | 僅放商品名稱 | | 11 | JS SDK `initialize` 傳整數（0/1）而非字串 | SDK 靜默失敗或連錯環境 | `ECPay.initialize('Stage', 1, cb)`（測試）或 `'Prod'`（正式） |

| 10 | ItemName 含系統關鍵字（echo、curl 等） | WAF 攔截 10400011 | 僅放商品名稱 |

| 服務 | 介接注意事項 URL | |------|----------------| | AIO 金流 | https://developers.ecpay.com.tw/2858.md |

|------|----------------| | AIO 金流 | https://developers.ecpay.com.tw/2858.md | | 站內付 2.0 (Web) | https://developers.ecpay.com.tw/8987.md |

| AIO 金流 | https://developers.ecpay.com.tw/2858.md |

| 站內付 2.0 (Web) | https://developers.ecpay.com.tw/8987.md |

| 站內付 2.0 (App) | https://developers.ecpay.com.tw/9168.md |

| 國內物流 | https://developers.ecpay.com.tw/7400.md |

| 全方位物流 | https://developers.ecpay.com.tw/10092.md |

| 跨境物流 | https://developers.ecpay.com.tw/8291.md |

| B2C 電子發票 | https://developers.ecpay.com.tw/7854.md |

| B2B 電子發票（存證模式）| https://developers.ecpay.com.tw/24176.md |

| 離線 POS 電子發票 | https://developers.ecpay.com.tw/13768.md |

| 電子收據 | https://developers.ecpay.com.tw/64230.md |

| ECTicket（純發行） | https://developers.ecpay.com.tw/29916.md |

| ECTicket（價金保管，首選） | https://developers.ecpay.com.tw/40322.md |

| 信用卡幕後授權 | https://developers.ecpay.com.tw/45901.md |

| 非信用卡幕後取號 | https://developers.ecpay.com.tw/27984.md |

| Shopify | https://developers.ecpay.com.tw/29070.md |

| 直播收款 | https://developers.ecpay.com.tw/41022.md |

│      例：references/Payment/全方位金流API技術文件.md ├── 2. 讀取該檔案，找到相關章節的 URL │      例：## 付款方式 / 信用卡一次付清 → https://developers.ecpay.com.tw/2866.md

├── 2. 讀取該檔案，找到相關章節的 URL │      例：## 付款方式 / 信用卡一次付清 → https://developers.ecpay.com.tw/2866.md ├── 3. 使用 web_fetch 工具讀取該 URL（取得官方最新規格）

│      例：## 付款方式 / 信用卡一次付清 → https://developers.ecpay.com.tw/2866.md

├── 3. 使用 web_fetch 工具讀取該 URL（取得官方最新規格） │      ├── 成功 → 進入步驟 3a │      ├── 404 / 連線失敗 → 嘗試 web_fetch https://developers.ecpay.com.tw 首頁搜尋對應主題

│      ├── 成功 → 進入步驟 3a │      ├── 404 / 連線失敗 → 嘗試 web_fetch https://developers.ecpay.com.tw 首頁搜尋對應主題 │      │      └── 仍失敗 → 以 guides/ 內容備援，但必須告知開發者並附上 reference URL

│      ├── 404 / 連線失敗 → 嘗試 web_fetch https://developers.ecpay.com.tw 首頁搜尋對應主題

└── 5. 開發者問到 references/ 未收錄的 API？        → ⚠<U+FE0F> 禁止從 AI 記憶中編造或猜測 URL        → 可嘗試 web_fetch https://developers.ecpay.com.tw 首頁搜尋

→ ⚠<U+FE0F> 禁止從 AI 記憶中編造或猜測 URL        → 可嘗試 web_fetch https://developers.ecpay.com.tw 首頁搜尋        → 若找到 developers.ecpay.com.tw 下的頁面，可引用但須註明「此 URL 未收錄於 references/ 索引，請自行確認有效性」

→ 可嘗試 web_fetch https://developers.ecpay.com.tw 首頁搜尋

| AI 平台 | 讀取 URL 的工具 | 用法 | |---------|----------------|------| | Claude Code | `web_fetch` | `web_fetch(url="https://developers.ecpay.com.tw/2866.md")` |

|---------|----------------|------| | Claude Code | `web_fetch` | `web_fetch(url="https://developers.ecpay.com.tw/2866.md")` | | VS Code Copilot Chat | `#file` + `@workspace` | 引用本地 guides/，搭配 `@workspace` 搜尋知識庫 |

| Claude Code | `web_fetch` | `web_fetch(url="https://developers.ecpay.com.tw/2866.md")` | | VS Code Copilot Chat | `#file` + `@workspace` | 引用本地 guides/，搭配 `@workspace` 搜尋知識庫 | | GitHub Copilot CLI | `web_fetch` / `fetch` | 同上 |

> ⚠<U+FE0F> **web_fetch 失敗時的備援**：若 web_fetch 逾時、回傳 404 或連線失敗： > 1. 先嘗試 web_fetch `https://developers.ecpay.com.tw` 首頁，搜尋對應 API 主題的替代 URL

> 1. 先嘗試 web_fetch `https://developers.ecpay.com.tw` 首頁，搜尋對應 API 主題的替代 URL

- [`SKILL.md`](../SKILL.md) §快速指令路由表 — AI 內部的指令對應邏輯 - [`README.md`](../README.md) §使用 — 給使用者的指令總覽與安裝指引 - [Claude Code 官方 Slash Commands 文件](https://code.claude.com/docs/en/skills) — Claude Code 的 slash commands / skills 官方規範

- [Claude Code 官方 Slash Commands 文件](https://code.claude.com/docs/en/skills) — Claude Code 的 slash commands / skills 官方規範

> - 測試信用卡號：4311-9522-2222-2222（安全碼任意三碼，有效期限任意未來月年，3D 驗證碼輸入 1234） > > **測試環境 URL**：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5`

> > **測試環境 URL**：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5` >

> **測試環境 URL**：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5`

> - HashIV：EkRm7iFT261dpevs > > **測試環境 URL**：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5`

> > **測試環境 URL**：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5` >

> **測試環境 URL**：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5`

> - HashIV：EkRm7iFT261dpevs > > **測試環境 URL**：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5`

> > **測試環境 URL**：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5` >

> **測試環境 URL**：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5`

> - 測試信用卡號：4311-9522-2222-2222（安全碼任意三碼，有效期限任意未來月年，3D 驗證碼 1234） > > **測試環境 URL**：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5`

> > **測試環境 URL**：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5` >

> **測試環境 URL**：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5`

> - 首期扣款走一般信用卡流程（消費者需輸入卡號），後續自動扣款 > - PeriodAmount 必須等於 TotalAmount，不一致會被拒絕 > - 如需停止訂閱，需用另一支 API：`POST https://payment-stage.ecpay.com.tw/Cashier/CreditCardPeriodAction`（Action=ReAuth 停止）

> - PeriodAmount 必須等於 TotalAmount，不一致會被拒絕 > - 如需停止訂閱，需用另一支 API：`POST https://payment-stage.ecpay.com.tw/Cashier/CreditCardPeriodAction`（Action=ReAuth 停止） > - 測試環境不會真的每月扣款，只會有第一期

> - 如需停止訂閱，需用另一支 API：`POST https://payment-stage.ecpay.com.tw/Cashier/CreditCardPeriodAction`（Action=ReAuth 停止）

> - 測試信用卡號（永豐 30 期）：4938-1777-7777-7777（安全碼任意三碼，有效期限任意未來月年，3D 驗證碼 1234） > > **測試環境 URL**：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5`

> > **測試環境 URL**：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5` >

> **測試環境 URL**：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5`

> - HashIV：EkRm7iFT261dpevs > > **測試環境 URL**：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5`

> > **測試環境 URL**：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5` >

> **測試環境 URL**：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5`

> - HashIV：EkRm7iFT261dpevs > > **測試環境 URL**：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5`

> > **測試環境 URL**：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5` >

> **測試環境 URL**：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5`

> > **測試環境 URL**： > - Token API（GetTokenbyTrade、CreatePayment）：`https://ecpg-stage.ecpay.com.tw`

> **測試環境 URL**： > - Token API（GetTokenbyTrade、CreatePayment）：`https://ecpg-stage.ecpay.com.tw` > - 查詢/請退款 API（QueryTrade、DoAction）：`https://ecpayment-stage.ecpay.com.tw`

> - Token API（GetTokenbyTrade、CreatePayment）：`https://ecpg-stage.ecpay.com.tw`

> - 查詢/請退款 API（QueryTrade、DoAction）：`https://ecpayment-stage.ecpay.com.tw`

> - **嚴禁混用這兩個 domain，混用會 404！** > > **前端 SDK**：測試環境用 `https://ecpg-stage.ecpay.com.tw/Scripts/sdk-1.0.0.js`、正式用 `https://ecpg.ecpay.com.tw/Scripts/sdk-1.0.0.js`（載入環境須與 `initialize('Stage'|'Prod')` 一致）

> > **前端 SDK**：測試環境用 `https://ecpg-stage.ecpay.com.tw/Scripts/sdk-1.0.0.js`、正式用 `https://ecpg.ecpay.com.tw/Scripts/sdk-1.0.0.js`（載入環境須與 `initialize('Stage'|'Prod')` 一致） >

> **前端 SDK**：測試環境用 `https://ecpg-stage.ecpay.com.tw/Scripts/sdk-1.0.0.js`、正式用 `https://ecpg.ecpay.com.tw/Scripts/sdk-1.0.0.js`（載入環境須與 `initialize('Stage'|'Prod')` 一致）

> > **需要實作的完整流程（5 步驟）**： > 1. **後端 GetTokenbyTrade**：`POST https://ecpg-stage.ecpay.com.tw/Merchant/GetTokenbyTrade`

> **需要實作的完整流程（5 步驟）**： > 1. **後端 GetTokenbyTrade**：`POST https://ecpg-stage.ecpay.com.tw/Merchant/GetTokenbyTrade` >    - Request Body 為 JSON：`{ MerchantID, RqHeader: { Timestamp }, Data: "AES加密後的字串" }`

> 1. **後端 GetTokenbyTrade**：`POST https://ecpg-stage.ecpay.com.tw/Merchant/GetTokenbyTrade`

> 2. **前端載入 SDK + 渲染信用卡表單**：React 中載入 `sdk-1.0.0.js`，呼叫 `ECPay.initialize(...)` 帶入 Token，SDK 會在 `<div id="ECPayPayment">` 中渲染信用卡輸入表單（此 div id 不可更改，SDK 硬編碼） > 3. **消費者填卡號 → SDK 回傳 PayToken**：消費者填完卡號按送出，SDK 觸發回調回傳 PayToken（一次性 token） > 4. **後

> 3. **消費者填卡號 → SDK 回傳 PayToken**：消費者填完卡號按送出，SDK 觸發回調回傳 PayToken（一次性 token） > 4. **後端 CreatePayment**：`POST https://ecpg-stage.ecpay.com.tw/Merchant/CreatePayment` >    - Data 明文帶入 PayToken 和 MerchantTradeNo

> 4. **後端 CreatePayment**：`POST https://ecpg-stage.ecpay.com.tw/Merchant/CreatePayment`

> > **測試環境 URL**： > - Token/綁卡/付款 API：`https://ecpg-stage.ecpay.com.tw`（GetTokenbyTrade、CreatePayment、GetTokenbyBindingCard、CreatePaymentWithCardID）

> **測試環境 URL**： > - Token/綁卡/付款 API：`https://ecpg-stage.ecpay.com.tw`（GetTokenbyTrade、CreatePayment、GetTokenbyBindingCard、CreatePaymentWithCardID） > - 查詢 API：`https://ecpayment-stage.ecpay.com.tw`（QueryTrade）

> - Token/綁卡/付款 API：`https://ecpg-stage.ecpay.com.tw`（GetTokenbyTrade、CreatePayment、GetTokenbyBindingCard、CreatePaymentWithCardID）

> - 查詢 API：`https://ecpayment-stage.ecpay.com.tw`（QueryTrade）

> > **Part B — 快速付款（已��卡的會員）**： > 1. 後端呼叫 `POST https://ecpg-stage.ecpay.com.tw/Merchant/GetTokenbyBindingCard`

> **Part B — 快速付款（已��卡的會員）**： > 1. 後端呼叫 `POST https://ecpg-stage.ecpay.com.tw/Merchant/GetTokenbyBindingCard` >    - Data 明文帶入 MerchantID、MerchantMemberID、BindCardID

> 1. 後端呼叫 `POST https://ecpg-stage.ecpay.com.tw/Merchant/GetTokenbyBindingCard`

>    - Data 明文帶入 MerchantID、MerchantMemberID、BindCardID > 2. 取得 Token 後，前端僅顯示卡號末四碼確認畫面（不需再輸入完整卡號） > 3. 後端呼叫 `POST https://ecpg-stage.ecpay.com.tw/Merchant/CreatePaymentWithCardID` 完成付款

> 2. 取得 Token 後，前端僅顯示卡號末四碼確認畫面（不需再輸入完整卡號） > 3. 後端呼叫 `POST https://ecpg-stage.ecpay.com.tw/Merchant/CreatePaymentWithCardID` 完成付款 >

> 3. 後端呼叫 `POST https://ecpg-stage.ecpay.com.tw/Merchant/CreatePaymentWithCardID` 完成付款

> - 測試信用卡號：4311-9522-2222-2222（安全碼任意三碼，有效期限任意未來月年，3D 驗證碼 1234） > > **測試環境 URL**：`https://ecpg-stage.ecpay.com.tw`

> > **測試環境 URL**：`https://ecpg-stage.ecpay.com.tw` >

> **測試環境 URL**：`https://ecpg-stage.ecpay.com.tw`

> **需要實作的完整流程**： > 1. **後端 API**（任何語言均可）：實作 GetTokenbyTrade 和 CreatePayment（同範例 8 的後端邏輯） > 2. **前端網頁**：建立一個 HTML 頁面，載入綠界 SDK `https://ecpg.ecpay.com.tw/Scripts/sdk-1.0.0.js`，在 `<div id="ECPayPayment">` 渲染信用卡表單

> 1. **後端 API**（任何語言均可）：實作 GetTokenbyTrade 和 CreatePayment（同範例 8 的後端邏輯） > 2. **前端網頁**：建立一個 HTML 頁面，載入綠界 SDK `https://ecpg.ecpay.com.tw/Scripts/sdk-1.0.0.js`，在 `<div id="ECPayPayment">` 渲染信用卡表單 > 3. **Swift App**：

> 2. **前端網頁**：建立一個 HTML 頁面，載入綠界 SDK `https://ecpg.ecpay.com.tw/Scripts/sdk-1.0.0.js`，在 `<div id="ECPayPayment">` 渲染信用卡表單

> - 測試信用卡號：4311-9522-2222-2222（安全碼任意三碼，有效期限任意未來月年，3D 驗證碼 1234） > > **測試環境 URL**：`https://ecpg-stage.ecpay.com.tw`

> > **測試環境 URL**：`https://ecpg-stage.ecpay.com.tw` >

> **測試環境 URL**：`https://ecpg-stage.ecpay.com.tw`

> **需要實作的完整流程**： > 1. **後端 API**（任何語言均可）：實作 GetTokenbyTrade 和 CreatePayment（同範例 8 的後端邏輯） > 2. **前端網頁**：建立 HTML 頁面，載入 `https://ecpg.ecpay.com.tw/Scripts/sdk-1.0.0.js`，渲染 `<div id="ECPayPayment">`

> 1. **後端 API**（任何語言均可）：實作 GetTokenbyTrade 和 CreatePayment（同範例 8 的後端邏輯） > 2. **前端網頁**：建立 HTML 頁面，載入 `https://ecpg.ecpay.com.tw/Scripts/sdk-1.0.0.js`，渲染 `<div id="ECPayPayment">` > 3. **Android App**：

> 2. **前端網頁**：建立 HTML 頁面，載入 `https://ecpg.ecpay.com.tw/Scripts/sdk-1.0.0.js`，渲染 `<div id="ECPayPayment">`

> - HashIV：EkRm7iFT261dpevs > > **測試環境 URL**：`https://ecpg-stage.ecpay.com.tw/Merchant/GenPaymentCode`

> > **測試環境 URL**：`https://ecpg-stage.ecpay.com.tw/Merchant/GenPaymentCode` >

> **測試環境 URL**：`https://ecpg-stage.ecpay.com.tw/Merchant/GenPaymentCode`

> - HashIV：EkRm7iFT261dpevs > > **測試環境 URL**：`https://payment-stage.ecpay.com.tw/Cashier/QueryTradeInfo/V5`

> > **測試環境 URL**：`https://payment-stage.ecpay.com.tw/Cashier/QueryTradeInfo/V5` >

> **測試環境 URL**：`https://payment-stage.ecpay.com.tw/Cashier/QueryTradeInfo/V5`

> - HashIV：EkRm7iFT261dpevs > > **測試環境 URL**：`https://payment-stage.ecpay.com.tw/CreditDetail/DoAction`

> > **測試環境 URL**：`https://payment-stage.ecpay.com.tw/CreditDetail/DoAction` >

> **測試環境 URL**：`https://payment-stage.ecpay.com.tw/CreditDetail/DoAction`

> > **測試環境 URL**： > - 查詢：`https://ecpayment-stage.ecpay.com.tw/1.0.0/Cashier/QueryTrade`（注意是 ecpayment，不是 ecpg）

> **測試環境 URL**： > - 查詢：`https://ecpayment-stage.ecpay.com.tw/1.0.0/Cashier/QueryTrade`（注意是 ecpayment，不是 ecpg） > - 定期定額操作：`https://ecpayment-stage.ecpay.com.tw/1.0.0/Credit/CreditCardPeriodAction`

> - 查詢：`https://ecpayment-stage.ecpay.com.tw/1.0.0/Cashier/QueryTrade`（注意是 ecpayment，不是 ecpg）

> - 定期定額操作：`https://ecpayment-stage.ecpay.com.tw/1.0.0/Credit/CreditCardPeriodAction`

> - HashIV：q9jcZX8Ib9LM8wYk > > **測試環境 URL**：`https://einvoice-stage.ecpay.com.tw/B2CInvoice/Issue`

> > **測試環境 URL**：`https://einvoice-stage.ecpay.com.tw/B2CInvoice/Issue` >

> **測試環境 URL**：`https://einvoice-stage.ecpay.com.tw/B2CInvoice/Issue`

> - HashIV：q9jcZX8Ib9LM8wYk > > **測試環境 URL**：`https://einvoice-stage.ecpay.com.tw/B2BInvoice/Issue`

> > **測試環境 URL**：`https://einvoice-stage.ecpay.com.tw/B2BInvoice/Issue` >

> **測試環境 URL**：`https://einvoice-stage.ecpay.com.tw/B2BInvoice/Issue`

> - HashIV：q9jcZX8Ib9LM8wYk > > **測試環境 URL**：`https://einvoice-stage.ecpay.com.tw/B2CInvoice/Allowance`

> > **測試環境 URL**：`https://einvoice-stage.ecpay.com.tw/B2CInvoice/Allowance` >

> **測試環境 URL**：`https://einvoice-stage.ecpay.com.tw/B2CInvoice/Allowance`

> > **測試環境 URL**： > - 作廢發票：`https://einvoice-stage.ecpay.com.tw/B2CInvoice/Invalid`

> **測試環境 URL**： > - 作廢發票：`https://einvoice-stage.ecpay.com.tw/B2CInvoice/Invalid` > - 查詢發票：`https://einvoice-stage.ecpay.com.tw/B2CInvoice/GetIssue`

> - 作廢發票：`https://einvoice-stage.ecpay.com.tw/B2CInvoice/Invalid`

> - 查詢發票：`https://einvoice-stage.ecpay.com.tw/B2CInvoice/GetIssue`

> - HashIV：v77hoKGq4kWxNNIS > > **測試環境 URL**：`https://logistics-stage.ecpay.com.tw`

> > **測試環境 URL**：`https://logistics-stage.ecpay.com.tw` >

> **測試環境 URL**：`https://logistics-stage.ecpay.com.tw`

> > **步驟 1 — 開啟門市地圖讓消費者選店**： > - 用 Form POST 到 `https://logistics-stage.ecpay.com.tw/Express/map`

> **步驟 1 — 開啟門市地圖讓消費者選店**： > - 用 Form POST 到 `https://logistics-stage.ecpay.com.tw/Express/map` > - 參數：MerchantID、LogisticsType=CVS、LogisticsSubType（UNIMART=7-11、FAMI=全家）、IsCollection=Y（取貨付款）、ServerReplyURL（收到選店結果的 URL）

> - 用 Form POST 到 `https://logistics-stage.ecpay.com.tw/Express/map`

> > **步驟 2 — 建立物流訂單**： > - POST 到 `https://logistics-stage.ecpay.com.tw/Express/Create`

> **步驟 2 — 建立物流訂單**： > - POST 到 `https://logistics-stage.ecpay.com.tw/Express/Create` > - Content-Type: application/x-www-form-urlencoded

> - POST 到 `https://logistics-stage.ecpay.com.tw/Express/Create`

> - HashIV：v77hoKGq4kWxNNIS > > **測試環境 URL**：`https://logistics-stage.ecpay.com.tw`

> > **測試環境 URL**：`https://logistics-stage.ecpay.com.tw` >

> **測試環境 URL**：`https://logistics-stage.ecpay.com.tw`

> > **步驟 1 — 建立宅配物流訂單**： > - POST 到 `https://logistics-stage.ecpay.com.tw/Express/Create`

> **步驟 1 — 建立宅配物流訂單**： > - POST 到 `https://logistics-stage.ecpay.com.tw/Express/Create` > - Content-Type: application/x-www-form-urlencoded

> - POST 到 `https://logistics-stage.ecpay.com.tw/Express/Create`

> > **步驟 2 — 產生測試標籤用於列印**： > - POST 到 `https://logistics-stage.ecpay.com.tw/Express/CreateTestData`

> **步驟 2 — 產生測試標籤用於列印**： > - POST 到 `https://logistics-stage.ecpay.com.tw/Express/CreateTestData` > - 帶入 MerchantID、AllPayLogisticsID、CheckMacValue

> - POST 到 `https://logistics-stage.ecpay.com.tw/Express/CreateTestData`

> - HashIV：v77hoKGq4kWxNNIS > > **測試環境 URL**：`https://logistics-stage.ecpay.com.tw/CrossBorder/`

> > **測試環境 URL**：`https://logistics-stage.ecpay.com.tw/CrossBorder/` >

> **測試環境 URL**：`https://logistics-stage.ecpay.com.tw/CrossBorder/`

> 3. 組合外層 JSON：`{ MerchantID, RqHeader: { Timestamp, Revision: "1.0.0" }, Data }` >    - 注意跨境物流 RqHeader 需 `Revision: "1.0.0"` > 4. POST 到 `https://logistics-stage.ecpay.com.tw/CrossBorder/CreateLogisticsOrder`，Content-Type: application/jso

>    - 注意跨境物流 RqHeader 需 `Revision: "1.0.0"` > 4. POST 到 `https://logistics-stage.ecpay.com.tw/CrossBorder/CreateLogisticsOrder`，Content-Type: application/json > 5. 回應處理：檢查 TransCode===1 → 解密 Data → 檢查 RtnCode===1 → 取得物流編號

> 4. POST 到 `https://logistics-stage.ecpay.com.tw/CrossBorder/CreateLogisticsOrder`，Content-Type: application/json

> > **測試環境 URL**： > - 查詢：`https://logistics-stage.ecpay.com.tw/Helper/QueryLogisticsTradeInfo/V5`

> **測試環境 URL**： > - 查詢：`https://logistics-stage.ecpay.com.tw/Helper/QueryLogisticsTradeInfo/V5` >

> - 查詢：`https://logistics-stage.ecpay.com.tw/Helper/QueryLogisticsTradeInfo/V5`

> - HashIV：37a0ad3c6ffa428b > > **測試環境 URL**：`https://ecticket-stage.ecpay.com.tw`

> > **測試環境 URL**：`https://ecticket-stage.ecpay.com.tw` >

> **測試環境 URL**：`https://ecticket-stage.ecpay.com.tw`

>    - 注意：CMV 公式與 AIO 不同！AIO 是排序所有參數，ECTicket是固定 `HashKey + Data + HashIV` > 4. 組合完整 Request JSON：`{ MerchantID, RqHeader: { Timestamp }, Data: "加密字串", CheckMacValue: "CMV字串" }` > 5. POST 到 `https://ecticket-stage.ecpay.com.tw/Voucher/Issue

> 4. 組合完整 Request JSON：`{ MerchantID, RqHeader: { Timestamp }, Data: "加密字串", CheckMacValue: "CMV字串" }` > 5. POST 到 `https://ecticket-stage.ecpay.com.tw/Voucher/IssueVoucher` >

> 5. POST 到 `https://ecticket-stage.ecpay.com.tw/Voucher/IssueVoucher`

> - HashIV：37a0ad3c6ffa428b > > **測試環境 URL**：`https://ecticket-stage.ecpay.com.tw`

> > **測試環境 URL**：`https://ecticket-stage.ecpay.com.tw` >

> **測試環境 URL**：`https://ecticket-stage.ecpay.com.tw`

> 1. 組合 Data 明文：MerchantID、VoucherNo（票券編號）、VerifyCode（驗證碼）、UseQuantity（核銷數量） > 2. AES 加密 → 計算 CheckMacValue（`HashKey={HashKey}&Data={加密Data}&HashIV={HashIV}` → SHA256 → 大寫） > 3. POST 到 `https://ecticket-stage.ecpay.com.tw/Voucher/UseVoucher

> 2. AES 加密 → 計算 CheckMacValue（`HashKey={HashKey}&Data={加密Data}&HashIV={HashIV}` → SHA256 → 大寫） > 3. POST 到 `https://ecticket-stage.ecpay.com.tw/Voucher/UseVoucher` > 4. 三重驗證回應：TransCode===1 → 解密 → 驗 CMV → RtnCode===1

> 3. POST 到 `https://ecticket-stage.ecpay.com.tw/Voucher/UseVoucher`

> 1. 組合 Data 明文：MerchantID、VoucherNo、ReturnQuantity > 2. 同樣 AES 加密 + CMV > 3. POST 到 `https://ecticket-stage.ecpay.com.tw/Voucher/ReturnVoucher`

> 2. 同樣 AES 加密 + CMV > 3. POST 到 `https://ecticket-stage.ecpay.com.tw/Voucher/ReturnVoucher` > 4. 三重驗證回應

> 3. POST 到 `https://ecticket-stage.ecpay.com.tw/Voucher/ReturnVoucher`

> > **Phase 1 — 收款（AIO 金流）**： > - 端點：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5`

> **Phase 1 — 收款（AIO 金流）**： > - 端點：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5` > - 加密：CheckMacValue SHA256（金流版 URL encode）

> - 端點：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5`

> > **Phase 2 — 開發票（B2C 電子發票）**： > - 端點：`https://einvoice-stage.ecpay.com.tw/B2CInvoice/Issue`

> **Phase 2 — 開發票（B2C 電子發票）**： > - 端點：`https://einvoice-stage.ecpay.com.tw/B2CInvoice/Issue` > - 加密：AES-128-CBC（AES 版 URL encode，不轉小寫，不做 .NET 替換）

> - 端點：`https://einvoice-stage.ecpay.com.tw/B2CInvoice/Issue`

> > **Phase 3 — 出貨（國內物流超商取貨）**： > - 端點：`https://logistics-stage.ecpay.com.tw/Express/Create`

> **Phase 3 — 出貨（國內物流超商取貨）**： > - 端點：`https://logistics-stage.ecpay.com.tw/Express/Create` > - 加密：CheckMacValue **MD5**（金流版 URL encode，但雜湊用 MD5 不是 SHA256）

> - 端點：`https://logistics-stage.ecpay.com.tw/Express/Create`

> > **Phase 1 — 訂閱建立（首次付款）**： > - 端點：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5`

> **Phase 1 — 訂閱建立（首次付款）**： > - 端點：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5` > - 額外參數：PeriodAmount、PeriodType=M（月）、Frequency=1（每1月）、ExecTimes=12（執行12次）、PeriodReturnURL

> - 端點：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5`

> > **Phase 3 — 自動開立發票**： > - 端點：`https://einvoice-stage.ecpay.com.tw/B2CInvoice/Issue`

> **Phase 3 — 自動開立發票**： > - 端點：`https://einvoice-stage.ecpay.com.tw/B2CInvoice/Issue` > - 加密：AES-128-CBC

> - 端點：`https://einvoice-stage.ecpay.com.tw/B2CInvoice/Issue`

> - 金流帳號（3002607）和發票帳號（2000132）不同，不可混用 > - PeriodReturnURL 和 ReturnURL 是兩個不同的 callback（首期用 ReturnURL，後續用 PeriodReturnURL） > - 如需停止訂閱，呼叫 `POST https://payment-stage.ecpay.com.tw/Cashier/CreditCardPeriodAction`（Action=ReAuth）

> - PeriodReturnURL 和 ReturnURL 是兩個不同的 callback（首期用 ReturnURL，後續用 PeriodReturnURL） > - 如需停止訂閱，呼叫 `POST https://payment-stage.ecpay.com.tw/Cashier/CreditCardPeriodAction`（Action=ReAuth） > - 測試環境只會有首期扣款，不會真的每月扣

> - 如需停止訂閱，呼叫 `POST https://payment-stage.ecpay.com.tw/Cashier/CreditCardPeriodAction`（Action=ReAuth）

> **我的環境**： > - 測試帳號：MerchantID=3002607, HashKey=pwFHCqoQZGmho4w6, HashIV=EkRm7iFT261dpevs > - 測試環境 URL：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5`

> - 測試帳號：MerchantID=3002607, HashKey=pwFHCqoQZGmho4w6, HashIV=EkRm7iFT261dpevs > - 測試環境 URL：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5` >

> - 測試環境 URL：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5`

> > **請幫我確認**： > 1. CreatePayment 的完整 URL 是否為 `https://ecpg-stage.ecpay.com.tw/Merchant/CreatePayment`（注意是 **ecpg**，不是 ecpayment）

> **請幫我確認**： > 1. CreatePayment 的完整 URL 是否為 `https://ecpg-stage.ecpay.com.tw/Merchant/CreatePayment`（注意是 **ecpg**，不是 ecpayment） > 2. 是否在程式碼中不小心把所有 API 都指向了同一個 domain

> 1. CreatePayment 的完整 URL 是否為 `https://ecpg-stage.ecpay.com.tw/Merchant/CreatePayment`（注意是 **ecpg**，不是 ecpayment）

> **我的環境**： > - 測試帳號：MerchantID=3002607, HashKey=pwFHCqoQZGmho4w6, HashIV=EkRm7iFT261dpevs > - 測試環境 URL：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5`

> - 測試帳號：MerchantID=3002607, HashKey=pwFHCqoQZGmho4w6, HashIV=EkRm7iFT261dpevs > - 測試環境 URL：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5` >

> - 測試環境 URL：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5`

> 7. **綠界測試環境特性**： >    - 測試環境的 Callback 可能有延遲（數秒到數分鐘） >    - 可登入測試特店後台 `https://vendor-stage.ecpay.com.tw` 查看交易記錄確認付款是否成功

>    - 測試環境的 Callback 可能有延遲（數秒到數分鐘） >    - 可登入測試特店後台 `https://vendor-stage.ecpay.com.tw` 查看交易記錄確認付款是否成功 >

>    - 可登入測試特店後台 `https://vendor-stage.ecpay.com.tw` 查看交易記錄確認付款是否成功

> 4. 產生可分享的短連結或 QR Code > > **測試環境 URL**：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5`

> > **測試環境 URL**：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5` >

> **測試環境 URL**：`https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5`

> - HashIV：q9jcZX8Ib9LM8wYk > > **測試環境 URL**：`https://einvoice-stage.ecpay.com.tw/Receipt/Issue`

> > **測試環境 URL**：`https://einvoice-stage.ecpay.com.tw/Receipt/Issue` > （⚠<U+FE0F> 收據走 `/Receipt/*`，發票走 `/B2CInvoice/*` 或 `/B2BInvoice/*`，不可混用）

> **測試環境 URL**：`https://einvoice-stage.ecpay.com.tw/Receipt/Issue`

> - HashIV：q9jcZX8Ib9LM8wYk > > **測試環境 URL**：`https://einvoice-stage.ecpay.com.tw/Receipt/Issue`

> > **測試環境 URL**：`https://einvoice-stage.ecpay.com.tw/Receipt/Issue` >

> **測試環境 URL**：`https://einvoice-stage.ecpay.com.tw/Receipt/Issue`

> - HashIV：EkRm7iFT261dpevs（⚠<U+FE0F> GCM 模式不使用 HashIV，IV 由程式每次隨機產生 12 byte） > > **測試環境 URL**：`https://einvoice-stage.ecpay.com.tw/Receipt/Issue`

> > **測試環境 URL**：`https://einvoice-stage.ecpay.com.tw/Receipt/Issue` >

> **測試環境 URL**：`https://einvoice-stage.ecpay.com.tw/Receipt/Issue`

> > **測試環境 URL**： > - 查詢單筆：`https://einvoice-stage.ecpay.com.tw/Receipt/GetReceipt`

> **測試環境 URL**： > - 查詢單筆：`https://einvoice-stage.ecpay.com.tw/Receipt/GetReceipt` > - 修改：`https://einvoice-stage.ecpay.com.tw/Receipt/UpdateIssue`

> - 查詢單筆：`https://einvoice-stage.ecpay.com.tw/Receipt/GetReceipt`

> - 修改：`https://einvoice-stage.ecpay.com.tw/Receipt/UpdateIssue`

> - 作廢：`https://einvoice-stage.ecpay.com.tw/Receipt/Invalid`

> - 通知：`https://einvoice-stage.ecpay.com.tw/Receipt/Notification`

>     private const string HASH_KEY = "ejCk326UnaZWKisg"; >     private const string HASH_IV = "q9jcZX8Ib9LM8wYk"; >     private const string BASE_URL = "https://einvoice-stage.ecpay.com.tw/Receipt";

>     private const string HASH_IV = "q9jcZX8Ib9LM8wYk"; >     private const string BASE_URL = "https://einvoice-stage.ecpay.com.tw/Receipt"; >

>     private const string BASE_URL = "https://einvoice-stage.ecpay.com.tw/Receipt";

> 🎯 **最快測試路徑（無需 ReturnURL）**： > 1. 建立訂單時設定 `SimulatePaid=1` > 2. `ReturnURL` 填任意 HTTPS URL（如 `https://example.com/notify`）

> 1. 建立訂單時設定 `SimulatePaid=1` > 2. `ReturnURL` 填任意 HTTPS URL（如 `https://example.com/notify`） > 3. 前端完成模擬付款流程後，用 QueryTradeInfo API 主動查詢訂單狀態

> 2. `ReturnURL` 填任意 HTTPS URL（如 `https://example.com/notify`）

> > **SimulatePaid 後的下一步**：SimulatePaid=1 驗證了前端流程。完成後建議： > 1. 設定 [ngrok](https://ngrok.com)（`ngrok http 3000`）取得公開 HTTPS URL

> **SimulatePaid 後的下一步**：SimulatePaid=1 驗證了前端流程。完成後建議： > 1. 設定 [ngrok](https://ngrok.com)（`ngrok http 3000`）取得公開 HTTPS URL > 2. 將 ReturnURL 改為 ngrok URL，移除 `SimulatePaid=1`

> 1. 設定 [ngrok](https://ngrok.com)（`ngrok http 3000`）取得公開 HTTPS URL

1. **立即開始開發** — 使用下方共用測試帳號，無需等待任何申請 2. 至 [綠界科技官網](https://www.ecpay.com.tw) 申請帳號並提交營業登記相關文件

2. 至 [綠界科技官網](https://www.ecpay.com.tw) 申請帳號並提交營業登記相關文件

> |---------|----------------| > | 可手動實作 AES-128-CBC 加解密（非 PHP）| 先用 PHP SDK（`PostWithAesJsonResponseService` 已封裝所有加密） | > | 後端有兩個可接收 HTTP POST 的**公開** URL（ReturnURL + OrderResultURL）| 先用 [ngrok](https://ngrok.com) 或 [RequestBin](https://req

> | 可手動實作 AES-128-CBC 加解密（非 PHP）| 先用 PHP SDK（`PostWithAesJsonResponseService` 已封裝所有加密） | > | 後端有兩個可接收 HTTP POST 的**公開** URL（ReturnURL + OrderResultURL）| 先用 [ngrok](https://ngrok.com) 或 [RequestBin](https://requestbin.com) 建立臨時端點 | > | 前端頁面可

> | 後端有兩個可接收 HTTP POST 的**公開** URL（ReturnURL + OrderResultURL）| 先用 [ngrok](https://ngrok.com) 或 [RequestBin](https://requestbin.com) 建立臨時端點 |

> | 前端頁面可載入外部 JavaScript（無嚴格 CSP 限制） | 先確認 CSP 設定允許 `https://ecpg-stage.ecpay.com.tw` |

<form method="POST" action="https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5">

<input type="hidden" name="TradeDesc" value="ECPay5MinDemo">     <input type="hidden" name="ItemName" value="測試商品">     <input type="hidden" name="ReturnURL" value="https://example.com/notify">

<input type="hidden" name="ItemName" value="測試商品">     <input type="hidden" name="ReturnURL" value="https://example.com/notify">     <input type="hidden" name="EncryptType" value="1">

<input type="hidden" name="ReturnURL" value="https://example.com/notify">

"pwFHCqoQZGmho4w6",                           // ← [必改] 你的 HashKey 	"EkRm7iFT261dpevs",                           // ← [必改] 你的 HashIV 	"https://payment-stage.ecpay.com.tw",          // ← [正式時改] 移除 -stage

"EkRm7iFT261dpevs",                           // ← [必改] 你的 HashIV 	"https://payment-stage.ecpay.com.tw",          // ← [正式時改] 移除 -stage }

"https://payment-stage.ecpay.com.tw",          // ← [正式時改] 移除 -stage

"MerchantID": config.MerchantID, "MerchantTradeNo": fmt.Sprintf("Go%d", time.Now().Unix()), // 最長 20 字元 			"MerchantTradeDate": now, "PaymentType": "aio", "TotalAmount": "100", 			"TradeDesc": "測試", "ItemName": "測試商品", "ReturnURL": "https:/

"MerchantTradeDate": now, "PaymentType": "aio", "TotalAmount": "100", 			"TradeDesc": "測試", "ItemName": "測試商品", "ReturnURL": "https://example.com/notify", // ⚠<U+FE0F> TODO: 替換 			"ChoosePayment": "ALL", "EncryptType": "1",

"TradeDesc": "測試", "ItemName": "測試商品", "ReturnURL": "https://example.com/notify", // ⚠<U+FE0F> TODO: 替換

fmt.Fprint(w, `</form><script>document.getElementById('f').submit()</script>`) 	}) 	fmt.Println("Go Server: http://localhost:3000/checkout")

}) 	fmt.Println("Go Server: http://localhost:3000/checkout") 	http.ListenAndServe(":3000", nil)

fmt.Println("Go Server: http://localhost:3000/checkout")

# WAF 關鍵字過濾（ItemName / TradeDesc 防護） # 規格來源：https://developers.ecpay.com.tw/2858.md

# 規格來源：https://developers.ecpay.com.tw/2858.md

r'|passwd|uname|finger|mail|xterm|traceroute|tracert|tftp|wget|curl|bash'

'TradeDesc'        => UrlService::ecpayUrlEncode('測試交易'),  // 依官方 SDK 範例，TradeDesc 需預先 ecpayUrlEncode     'ItemName'         => '測試商品一件',           // ItemName 由 SDK 內部處理 CMV 時自動編碼，不需預先 encode     'ReturnURL'        => 'https://example.com/

'ItemName'         => '測試商品一件',           // ItemName 由 SDK 內部處理 CMV 時自動編碼，不需預先 encode     'ReturnURL'        => 'https://example.com/ecpay/notify',  // ⚠<U+FE0F> TODO: 替換為你的公開回呼 URL（本地開發可用 ngrok，見「本地開發環境」節）     'ChoosePayment'    => 'Credit',    

'ReturnURL'        => 'https://example.com/ecpay/notify',  // ⚠<U+FE0F> TODO: 替換為你的公開回呼 URL（本地開發可用 ngrok，見「本地開發環境」節）

echo $autoSubmitFormService->generate(     $input,     'https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5'

$input,     'https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5' );

'https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5'

1. 登入特店後台：`https://vendor-stage.ecpay.com.tw`

hashKey: 'pwFHCqoQZGmho4w6', // ← [必改] 替換為你的 HashKey   hashIv: 'EkRm7iFT261dpevs',  // ← [必改] 替換為你的 HashIV   baseUrl: 'https://payment-stage.ecpay.com.tw', // ← [正式時改] 移除 -stage

hashIv: 'EkRm7iFT261dpevs',  // ← [必改] 替換為你的 HashIV   baseUrl: 'https://payment-stage.ecpay.com.tw', // ← [正式時改] 移除 -stage };

baseUrl: 'https://payment-stage.ecpay.com.tw', // ← [正式時改] 移除 -stage

TradeDesc: '測試交易',  // CheckMacValue 計算會自動處理 URL encode，不需預先編碼     ItemName: '測試商品',     ReturnURL: 'https://example.com/ecpay/notify', // ⚠<U+FE0F> TODO: 替換為你的公開回呼 URL（本地開發可用 ngrok，見「本地開發環境」節）

ItemName: '測試商品',     ReturnURL: 'https://example.com/ecpay/notify', // ⚠<U+FE0F> TODO: 替換為你的公開回呼 URL（本地開發可用 ngrok，見「本地開發環境」節）     ChoosePayment: 'ALL',

ReturnURL: 'https://example.com/ecpay/notify', // ⚠<U+FE0F> TODO: 替換為你的公開回呼 URL（本地開發可用 ngrok，見「本地開發環境」節）

app.listen(3000, () => console.log('Server: http://localhost:3000/checkout'));

'hash_key': 'pwFHCqoQZGmho4w6',                    # ← [必改] 替換為你的 HashKey     'hash_iv': 'EkRm7iFT261dpevs',                     # ← [必改] 替換為你的 HashIV     'base_url': 'https://payment-stage.ecpay.com.tw',   # ← [正式時改] 移除 -stage

'hash_iv': 'EkRm7iFT261dpevs',                     # ← [必改] 替換為你的 HashIV     'base_url': 'https://payment-stage.ecpay.com.tw',   # ← [正式時改] 移除 -stage }

'base_url': 'https://payment-stage.ecpay.com.tw',   # ← [正式時改] 移除 -stage

'TradeDesc': '測試交易',  # CheckMacValue 計算會自動處理 URL encode，不需預先編碼         'ItemName': '測試商品',         'ReturnURL': 'https://example.com/ecpay/notify',  # ⚠<U+FE0F> TODO: 替換為你的公開回呼 URL（本地開發可用 ngrok，見「本地開發環境」節）

'ItemName': '測試商品',         'ReturnURL': 'https://example.com/ecpay/notify',  # ⚠<U+FE0F> TODO: 替換為你的公開回呼 URL（本地開發可用 ngrok，見「本地開發環境」節）         'ChoosePayment': 'ALL',

'ReturnURL': 'https://example.com/ecpay/notify',  # ⚠<U+FE0F> TODO: 替換為你的公開回呼 URL（本地開發可用 ngrok，見「本地開發環境」節）

### curl 範例

curl -X POST https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5 \

-d "TradeDesc=%e6%b8%ac%e8%a9%a6" \   -d "ItemName=%e6%b8%ac%e8%a9%a6%e5%95%86%e5%93%81" \   -d "ReturnURL=https://example.com/notify" \

-d "ItemName=%e6%b8%ac%e8%a9%a6%e5%95%86%e5%93%81" \   -d "ReturnURL=https://example.com/notify" \   -d "ChoosePayment=ALL" \

-d "ReturnURL=https://example.com/notify" \

1. 安裝 ngrok：`brew install ngrok` 或從 [ngrok.com](https://ngrok.com) 下載

2. 啟動你的本地伺服器（例如 `node server.js` 在 port 3000） 3. 開啟 ngrok：`ngrok http 3000` 4. 複製 ngrok 給的公開 URL（例如 `https://abc123.ngrok-free.app`）

3. 開啟 ngrok：`ngrok http 3000` 4. 複製 ngrok 給的公開 URL（例如 `https://abc123.ngrok-free.app`） 5. 將此 URL 填入 `ReturnURL` 參數

4. 複製 ngrok 給的公開 URL（例如 `https://abc123.ngrok-free.app`）

6. 測試完成後可在 ngrok 控制面板 `http://127.0.0.1:4040` 查看請求記錄

const response = await fetch('https://einvoice-stage.ecpay.com.tw/B2CInvoice/Issue', { // Node.js 18+ 內建 fetch；舊版請改用 const https = require('https') 或 npm install node-fetch

decrypted = unpad(cipher.decrypt(base64.b64decode(cipher_text)), AES.block_size)

resp = requests.post('https://einvoice-stage.ecpay.com.tw/B2CInvoice/Issue', json=request_body)

'TradeDesc'         => 'Test',     'ItemName'          => '測試商品',     'ReturnURL'         => 'https://你的網站/ecpay/notify',   // Server-to-Server

'ItemName'          => '測試商品',     'ReturnURL'         => 'https://你的網站/ecpay/notify',   // Server-to-Server     'ChoosePayment'     => 'Credit',

'ReturnURL'         => 'https://你的網站/ecpay/notify',   // Server-to-Server

'EncryptType'       => 1, ]; echo $autoSubmitFormService->generate($input, 'https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5');

echo $autoSubmitFormService->generate($input, 'https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5');

[Credential-related source omitted]

'MerchantTradeNo' => $tradeNo,     'TimeStamp'       => time(), ], 'https://payment-stage.ecpay.com.tw/Cashier/QueryTradeInfo/V5');

'TimeStamp'       => time(), ], 'https://payment-stage.ecpay.com.tw/Cashier/QueryTradeInfo/V5'); // $result['TradeStatus'] === '1' 表示已付款

], 'https://payment-stage.ecpay.com.tw/Cashier/QueryTradeInfo/V5');

| Content-Type | `application/x-www-form-urlencoded` | | 認證 | CheckMacValue（SHA256） — 詳見 [guides/13-checkmacvalue.md](./13-checkmacvalue.md) | | 正式環境 | `https://payment.ecpay.com.tw` |

| 認證 | CheckMacValue（SHA256） — 詳見 [guides/13-checkmacvalue.md](./13-checkmacvalue.md) | | 正式環境 | `https://payment.ecpay.com.tw` | | 測試環境 | `https://payment-stage.ecpay.com.tw` |

| 正式環境 | `https://payment.ecpay.com.tw` |

| 測試環境 | `https://payment-stage.ecpay.com.tw` |

| 功能 | 端點路徑 | 完整正式環境 URL | 回應格式 | |------|---------|----------------|---------| | 建立訂單 | `/Cashier/AioCheckOut/V5` | `https://payment.ecpay.com.tw/Cashier/AioCheckOut/V5` | HTML（重導） |

|------|---------|----------------|---------| | 建立訂單 | `/Cashier/AioCheckOut/V5` | `https://payment.ecpay.com.tw/Cashier/AioCheckOut/V5` | HTML（重導） | | 查詢訂單 | `/Cashier/QueryTradeInfo/V5` | `https://payment.ecpay.com.tw/Cashier/QueryTradeIn

| 建立訂單 | `/Cashier/AioCheckOut/V5` | `https://payment.ecpay.com.tw/Cashier/AioCheckOut/V5` | HTML（重導） |

| 查詢訂單 | `/Cashier/QueryTradeInfo/V5` | `https://payment.ecpay.com.tw/Cashier/QueryTradeInfo/V5` | URL-encoded |

| 信用卡請退款 | `/CreditDetail/DoAction`（⚠<U+FE0F> Stage 環境不可用） | `https://payment.ecpay.com.tw/CreditDetail/DoAction` | URL-encoded |

| 取號結果查詢 | `/Cashier/QueryPaymentInfo` | — | URL-encoded | | 定期定額作業 | `/Cashier/CreditCardPeriodAction` | — | URL-encoded | | 對帳檔下載 | `/PaymentMedia/TradeNoAio` | `https://vendor.ecpay.com.tw/PaymentMedia/TradeNoAio` | text |

| 定期定額作業 | `/Cashier/CreditCardPeriodAction` | — | URL-encoded | | 對帳檔下載 | `/PaymentMedia/TradeNoAio` | `https://vendor.ecpay.com.tw/PaymentMedia/TradeNoAio` | text | | 信用卡撥款對帳 | `/CreditDetail/FundingReconDetail` | — | text |

| 對帳檔下載 | `/PaymentMedia/TradeNoAio` | `https://vendor.ecpay.com.tw/PaymentMedia/TradeNoAio` | text |

| TradeDesc | String | 200 | 交易描述（請勿帶入特殊字元） | 測試交易 | | ItemName | String | 400 | 商品名稱（多項用 `#` 分隔） | 商品A#商品B | | ReturnURL | String | 200 | 付款結果通知 URL（Server 端） | https://你的網站/ecpay/notify |

| ItemName | String | 400 | 商品名稱（多項用 `#` 分隔） | 商品A#商品B | | ReturnURL | String | 200 | 付款結果通知 URL（Server 端） | https://你的網站/ecpay/notify | | ChoosePayment | String | 20 | 付款方式 | ALL / Credit / ATM / CVS / BARCODE / WebATM / ApplePay / TWQR / 

| ReturnURL | String | 200 | 付款結果通知 URL（Server 端） | https://你的網站/ecpay/notify |

**端點**：`POST https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5`

'TradeDesc'        => UrlService::ecpayUrlEncode('測試交易'),  // 官方 SDK 範例做法，見 scripts/SDK_PHP/example/Payment/Aio/CreateCreditOrder.php     'ItemName'         => '測試商品',     'ReturnURL'        => 'https://你的網站/ecpay/notify',

'ItemName'         => '測試商品',     'ReturnURL'        => 'https://你的網站/ecpay/notify',     'ChoosePayment'    => 'Credit',

'ReturnURL'        => 'https://你的網站/ecpay/notify',

'TradeDesc'        => UrlService::ecpayUrlEncode('交易描述範例'),     'ItemName'         => '範例商品一批 100 TWD x 1',     'ReturnURL'        => 'https://你的網站/ecpay/notify',

'ItemName'         => '範例商品一批 100 TWD x 1',     'ReturnURL'        => 'https://你的網站/ecpay/notify',     'ChoosePayment'    => 'ATM',

'ReturnURL'        => 'https://你的網站/ecpay/notify',

'EncryptType'      => 1,     'ExpireDate'       => 7,              // ATM 繳費期限（天，範圍 1-60）     'PaymentInfoURL'   => 'https://你的網站/ecpay/payment-info',  // 取號結果通知 URL

'ExpireDate'       => 7,              // ATM 繳費期限（天，範圍 1-60）     'PaymentInfoURL'   => 'https://你的網站/ecpay/payment-info',  // 取號結果通知 URL ];

'PaymentInfoURL'   => 'https://你的網站/ecpay/payment-info',  // 取號結果通知 URL

'TradeDesc'        => UrlService::ecpayUrlEncode('交易描述範例'),     'ItemName'         => '範例商品一批 100 TWD x 1',     'ReturnURL'        => 'https://你的網站/ecpay/notify',

'ItemName'         => '範例商品一批 100 TWD x 1',     'ReturnURL'        => 'https://你的網站/ecpay/notify',     'ChoosePayment'    => 'CVS',

'ReturnURL'        => 'https://你的網站/ecpay/notify',

'Desc_3'           => '範例交易描述 3',     'Desc_4'           => '範例交易描述 4',     'PaymentInfoURL'   => 'https://你的網站/ecpay/payment-info',  // 取號結果通知 URL

'Desc_4'           => '範例交易描述 4',     'PaymentInfoURL'   => 'https://你的網站/ecpay/payment-info',  // 取號結果通知 URL ];

'PaymentInfoURL'   => 'https://你的網站/ecpay/payment-info',  // 取號結果通知 URL

'TradeDesc'        => UrlService::ecpayUrlEncode('交易描述範例'),     'ItemName'         => '範例商品一批 100 TWD x 1',     'ReturnURL'        => 'https://你的網站/ecpay/notify',

'ItemName'         => '範例商品一批 100 TWD x 1',     'ReturnURL'        => 'https://你的網站/ecpay/notify',     'ChoosePayment'    => 'BARCODE',

'ReturnURL'        => 'https://你的網站/ecpay/notify',

'Desc_3'           => '範例交易描述 3',     'Desc_4'           => '範例交易描述 4',     'PaymentInfoURL'   => 'https://你的網站/ecpay/payment-info',  // 取號結果通知 URL

'Desc_4'           => '範例交易描述 4',     'PaymentInfoURL'   => 'https://你的網站/ecpay/payment-info',  // 取號結果通知 URL ];

'PaymentInfoURL'   => 'https://你的網站/ecpay/payment-info',  // 取號結果通知 URL

$response = $postService->post(     $input,     'https://payment-stage.ecpay.com.tw/Cashier/QueryPaymentInfo'

$input,     'https://payment-stage.ecpay.com.tw/Cashier/QueryPaymentInfo' );

'https://payment-stage.ecpay.com.tw/Cashier/QueryPaymentInfo'

'TradeDesc'        => '月訂閱方案',     'ItemName'         => '月訂閱 x1',     'ReturnURL'        => 'https://你的網站/ecpay/notify',

'ItemName'         => '月訂閱 x1',     'ReturnURL'        => 'https://你的網站/ecpay/notify',     'ChoosePayment'    => 'Credit',

'ReturnURL'        => 'https://你的網站/ecpay/notify',

'Frequency'        => 1,       // 每 1 個月執行一次     'ExecTimes'        => 12,      // 共執行 12 次（最少 2 次）     'PeriodReturnURL'  => 'https://你的網站/ecpay/period-notify',  // 第 2 次起扣款結果通知（第 1 次走 ReturnURL）

'ExecTimes'        => 12,      // 共執行 12 次（最少 2 次）     'PeriodReturnURL'  => 'https://你的網站/ecpay/period-notify',  // 第 2 次起扣款結果通知（第 1 次走 ReturnURL） ];

'PeriodReturnURL'  => 'https://你的網站/ecpay/period-notify',  // 第 2 次起扣款結果通知（第 1 次走 ReturnURL）

echo $autoSubmitFormService->generate(     $input,     'https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5'

$input,     'https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5' );

'https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5'

> ⚠<U+FE0F> 收到通知後必須回應 `1|OK`。`PeriodReturnURL` 每期僅通知一次，若未收到請用[信用卡定期定額訂單查詢](https://developers.ecpay.com.tw/2892.md)取得實際授權結果。

$response = $postService->post(     $input,     'https://payment-stage.ecpay.com.tw/Cashier/CreditCardPeriodAction'

$input,     'https://payment-stage.ecpay.com.tw/Cashier/CreditCardPeriodAction' );

'https://payment-stage.ecpay.com.tw/Cashier/CreditCardPeriodAction'

$response = $postService->post(     $input,     'https://payment-stage.ecpay.com.tw/Cashier/QueryCreditCardPeriodInfo'

$input,     'https://payment-stage.ecpay.com.tw/Cashier/QueryCreditCardPeriodInfo' );

'https://payment-stage.ecpay.com.tw/Cashier/QueryCreditCardPeriodInfo'

> 商家應在第 3 次失敗時主動通知消費者，避免合約被取消。 > 扣款結果（第 2 次起）通知至 `PeriodReturnURL`；若第一次授權失敗，該訂單不會進入排程，需重新建立訂單。 > 失敗扣款可透過[定期定額訂單作業 API](https://developers.ecpay.com.tw/2900.md) 或綠界廠商管理後台進行補授權。

> 失敗扣款可透過[定期定額訂單作業 API](https://developers.ecpay.com.tw/2900.md) 或綠界廠商管理後台進行補授權。

> 原始範例：`scripts/SDK_PHP/example/Payment/Aio/Capture.php` > > ⚠<U+FE0F> SDK 範例（Capture.php）預設使用測試環境 URL，正式環境需替換為 `https://payment.ecpay.com.tw`。

> ⚠<U+FE0F> SDK 範例（Capture.php）預設使用測試環境 URL，正式環境需替換為 `https://payment.ecpay.com.tw`。

$response = $postService->post(         $input,         'https://payment.ecpay.com.tw/CreditDetail/DoAction'  // ⚠<U+FE0F> Stage 環境不支援 DoAction（無法實際授權），須使用正式環境

$input,         'https://payment.ecpay.com.tw/CreditDetail/DoAction'  // ⚠<U+FE0F> Stage 環境不支援 DoAction（無法實際授權），須使用正式環境     );

'https://payment.ecpay.com.tw/CreditDetail/DoAction'  // ⚠<U+FE0F> Stage 環境不支援 DoAction（無法實際授權），須使用正式環境

$response = $postService->post(     $input,     'https://payment.ecpay.com.tw/CreditDetail/DoAction'  // ⚠<U+FE0F> DoAction 僅正式環境，測試環境不可用

$input,     'https://payment.ecpay.com.tw/CreditDetail/DoAction'  // ⚠<U+FE0F> DoAction 僅正式環境，測試環境不可用 );

'https://payment.ecpay.com.tw/CreditDetail/DoAction'  // ⚠<U+FE0F> DoAction 僅正式環境，測試環境不可用

$response = $postService->post(         $input,         'https://payment-stage.ecpay.com.tw/Cashier/QueryTradeInfo/V5'

$input,         'https://payment-stage.ecpay.com.tw/Cashier/QueryTradeInfo/V5'     );

'https://payment-stage.ecpay.com.tw/Cashier/QueryTradeInfo/V5'

$response = $postService->post(     $input,     'https://payment-stage.ecpay.com.tw/CreditDetail/QueryTrade/V2'

$input,     'https://payment-stage.ecpay.com.tw/CreditDetail/QueryTrade/V2' );

'https://payment-stage.ecpay.com.tw/CreditDetail/QueryTrade/V2'

echo $autoSubmitFormService->generate(     $input,     'https://vendor-stage.ecpay.com.tw/PaymentMedia/TradeNoAio'

$input,     'https://vendor-stage.ecpay.com.tw/PaymentMedia/TradeNoAio' );

'https://vendor-stage.ecpay.com.tw/PaymentMedia/TradeNoAio'

echo $autoSubmitFormService->generate(     $input,     'https://payment-stage.ecpay.com.tw/CreditDetail/FundingReconDetail'

$input,     'https://payment-stage.ecpay.com.tw/CreditDetail/FundingReconDetail' );

'https://payment-stage.ecpay.com.tw/CreditDetail/FundingReconDetail'

HASH_KEY     = 'pwFHCqoQZGmho4w6' HASH_IV      = 'EkRm7iFT261dpevs' PAYMENT_URL  = 'https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5'

PAYMENT_URL  = 'https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5'

# ✅ 填入你的 ngrok 或可公開訪問的 URL RETURN_URL   = 'https://你的網域/ecpay/notify'   # Server-to-Server Form POST（必填）

RETURN_URL   = 'https://你的網域/ecpay/notify'   # Server-to-Server Form POST（必填）

if __name__ == '__main__':     print(f'結帳頁面：http://localhost:5000/checkout')

print(f'結帳頁面：http://localhost:5000/checkout')

def safe_item_name(items: list[str], max_len: int = 390) -> str:     """安全組合 ItemName，避免超過 400 字元被截斷導致 CMV 錯誤。     規格來源：SNAPSHOT 2026-03 | https://developers.ecpay.com.tw/2862.md

"""安全組合 ItemName，避免超過 400 字元被截斷導致 CMV 錯誤。     規格來源：SNAPSHOT 2026-03 | https://developers.ecpay.com.tw/2862.md     """

規格來源：SNAPSHOT 2026-03 | https://developers.ecpay.com.tw/2862.md

[Credential-related source omitted]

| Content-Type | `application/json` | | 認證 | AES-128-CBC 加密 Data 欄位 — 詳見 [guides/14-aes-encryption.md](./14-aes-encryption.md) | | Token 環境 | `https://ecpg-stage.ecpay.com.tw`（測試） / `https://ecpg.ecpay.com.tw`（正式） |

| 認證 | AES-128-CBC 加密 Data 欄位 — 詳見 [guides/14-aes-encryption.md](./14-aes-encryption.md) | | Token 環境 | `https://ecpg-stage.ecpay.com.tw`（測試） / `https://ecpg.ecpay.com.tw`（正式） | | 交易/查詢環境 | `https://ecpayment-stage.ecpay.com.tw`（測試） / `http

| Token 環境 | `https://ecpg-stage.ecpay.com.tw`（測試） / `https://ecpg.ecpay.com.tw`（正式） |

| 交易/查詢環境 | `https://ecpayment-stage.ecpay.com.tw`（測試） / `https://ecpayment.ecpay.com.tw`（正式） |

| AES-128-CBC 加密 | `Crypto.AES.MODE_CBC` + PKCS7 pad | `crypto.createCipheriv('aes-128-cbc')` | `aes.NewCipher()` + `cipher.NewCBCEncrypter()` | `Cipher.getInstance("AES/CBC/PKCS5Padding")` | | Base64 | `base64.b64encode()` | `Buffer.from(x

| HTTP POST | `requests.post(url, json=body)` | `fetch(url, {method:'POST', headers:{'Content-Type':'application/json'}, body:JSON.stringify(body)})` | `http.Post()` | `HttpClient` |

"MerchantTradeNo": f"test{int(time.time())}",         "TotalAmount": 100,     # 整數         "ReturnURL": "https://yourdomain.com/ecpay/notify",

"TotalAmount": 100,     # 整數         "ReturnURL": "https://yourdomain.com/ecpay/notify",         "TradeDesc": "測試",

"ReturnURL": "https://yourdomain.com/ecpay/notify",

"ItemName": "商品"     },     "CardInfo": {"OrderResultURL": "https://yourdomain.com/ecpay/result"},

},     "CardInfo": {"OrderResultURL": "https://yourdomain.com/ecpay/result"},     "ConsumerInfo": {

"CardInfo": {"OrderResultURL": "https://yourdomain.com/ecpay/result"},

raw = base64.b64decode(encrypted_base64)

"Data": aes_encrypt(data_payload)   # 複用步驟 0 / 步驟 1 的 aes_encrypt     }     resp = requests.post(

}     resp = requests.post(         'https://ecpg-stage.ecpay.com.tw/Merchant/CreatePayment',  # ← ecpg，不是 ecpayment

resp = requests.post(

'https://ecpg-stage.ecpay.com.tw/Merchant/CreatePayment',  # ← ecpg，不是 ecpayment

**端點**：`POST https://ecpg-stage.ecpay.com.tw/Merchant/GetTokenbyTrade`

'MerchantTradeNo'   => 'Test' . time(),             'TotalAmount'       => 100,             'ReturnURL'         => 'https://你的網站/ecpay/notify',

'TotalAmount'       => 100,             'ReturnURL'         => 'https://你的網站/ecpay/notify',             'TradeDesc'         => '測試交易',

'ReturnURL'         => 'https://你的網站/ecpay/notify',

'CardInfo' => [             'Redeem'            => 0,  // ⚠<U+FE0F> 整數 0（PHP SDK 寫法），非 PHP 語言建議省略此欄位             'OrderResultURL'    => 'https://你的網站/ecpay/result',

'Redeem'            => 0,  // ⚠<U+FE0F> 整數 0（PHP SDK 寫法），非 PHP 語言建議省略此欄位             'OrderResultURL'    => 'https://你的網站/ecpay/result',             'CreditInstallment' => '3,6,12',

'OrderResultURL'    => 'https://你的網站/ecpay/result',

]; try {     $response = $postService->post($input, 'https://ecpg-stage.ecpay.com.tw/Merchant/GetTokenbyTrade');

try {     $response = $postService->post($input, 'https://ecpg-stage.ecpay.com.tw/Merchant/GetTokenbyTrade');     // 解密 Data 取得 Token

$response = $postService->post($input, 'https://ecpg-stage.ecpay.com.tw/Merchant/GetTokenbyTrade');

<!-- 1. jQuery（必要依賴，SDK 啟動時檢查 typeof jQuery） --> <script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>

<script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>

<!-- 2. node-forge（必要依賴，SDK 用於前端加密） --> <script src="https://cdn.jsdelivr.net/npm/node-forge@0.7.0/dist/forge.min.js"></script> <!-- 3. ECPay 站內付 JS SDK（依環境擇一載入；載入的環境須與下方 initialize 一致）-->

<script src="https://cdn.jsdelivr.net/npm/node-forge@0.7.0/dist/forge.min.js"></script>

<!-- 3. ECPay 站內付 JS SDK（依環境擇一載入；載入的環境須與下方 initialize 一致）--> <!-- 測試環境： --> <script src="https://ecpg-stage.ecpay.com.tw/Scripts/sdk-1.0.0.js?t=20210121100116"></script>

<!-- 測試環境： --> <script src="https://ecpg-stage.ecpay.com.tw/Scripts/sdk-1.0.0.js?t=20210121100116"></script> <!-- 正式環境（上線時改用此行）： -->

<script src="https://ecpg-stage.ecpay.com.tw/Scripts/sdk-1.0.0.js?t=20210121100116"></script>

<!-- <script src="https://ecpg.ecpay.com.tw/Scripts/sdk-1.0.0.js?t=20210121100116"></script> -->

> **⚠<U+FE0F> JS SDK domain 說明**：依[綠界官方 WEB JS SDK 使用說明（8989）](https://developers.ecpay.com.tw/8989/)，

> **載入的 SDK 環境務必與 `ECPay.initialize('Stage'|'Prod', ...)` 的環境一致**（測試載 stage + `initialize('Stage')`；正式載 prod + `initialize('Prod')`）。 > 路徑為 `/Scripts/sdk-1.0.0.js`（大寫 `S`），並帶版本參數 `?t=20210121100116`（與官方範例一致）。 > ECPay 更新 SDK 版本或路徑時，請以[綠界站內付官

> ECPay 更新 SDK 版本或路徑時，請以[綠界站內付官方文件](https://developers.ecpay.com.tw/8989/)及[官方 GitHub 範例](https://github.com/ECPay/ECPayPaymentGatewayKit_Web)中的最新版本為準。

> **CSP（Content Security Policy）設定**：若你的網站啟用了 CSP header，需允許 ECPay domain： > - `script-src`: 加入 `https://ecpg.ecpay.com.tw`（正式）及 `https://ecpg-stage.ecpay.com.tw`（測試，SDK 檔案由測試 domain 載入）

> - `script-src`: 加入 `https://ecpg.ecpay.com.tw`（正式）及 `https://ecpg-stage.ecpay.com.tw`（測試，SDK 檔案由測試 domain 載入）

> - `frame-src`: 加入 `https://ecpg.ecpay.com.tw`（正式）及 `https://ecpg-stage.ecpay.com.tw`（測試，SDK 內部 iframe 連接測試環境）

> - `connect-src`: 加入 `https://ecpg.ecpay.com.tw`（正式）及 `https://ecpg-stage.ecpay.com.tw`（測試，SDK 內部 API 呼叫）

> **API 呼叫風格說明**：下方使用官方 SDK 的 positional 風格（`ECPay.createPayment(Token, Language, callBack, Version)`）。 > 以[官方文件](https://developers.ecpay.com.tw/9003.md)及 [GitHub 範例](https://github.com/ECPay/ECPayPaymentGatewayKit_Web)為準。

> 以[官方文件](https://developers.ecpay.com.tw/9003.md)及 [GitHub 範例](https://github.com/ECPay/ECPayPaymentGatewayKit_Web)為準。

]; try {     $response = $postService->post($input, 'https://ecpg-stage.ecpay.com.tw/Merchant/CreatePayment');

try {     $response = $postService->post($input, 'https://ecpg-stage.ecpay.com.tw/Merchant/CreatePayment');     // 檢查 TransCode 是否為 1（成功）

$response = $postService->post($input, 'https://ecpg-stage.ecpay.com.tw/Merchant/CreatePayment');

},   "ThreeDInfo": {     "ThreeDURL": "https://3durl.com.tw/..."

"ThreeDInfo": {     "ThreeDURL": "https://3durl.com.tw/..."   }

"ThreeDURL": "https://3durl.com.tw/..."

| **Vue 3** | `window.location.href = threeDUrl` | ❌ `router.push(threeDUrl)`（vue-router 不處理外部 URL） | | **Nuxt 3** | `window.location.href = threeDUrl` | ❌ `navigateTo(threeDUrl)` 在 SSR 模式下行為不一致 | | **純 JavaScript** | `window.location.href 

| **純 JavaScript** | `window.location.href = threeDUrl` | ❌ `fetch(threeDUrl)`（fetch 不會改變用戶頁面） |

// ✅ 所有框架通用的正確做法 const result = await fetch('/ecpay/create-payment', {

const result = await fetch('/ecpay/create-payment', {

'TradeDesc'         => '綁卡驗證',             'ItemName'          => '綁卡',             'ReturnURL'         => 'https://你的網站/ecpay/notify',

'ItemName'          => '綁卡',             'ReturnURL'         => 'https://你的網站/ecpay/notify',         ],

'ReturnURL'         => 'https://你的網站/ecpay/notify',

],         'OrderResultURL' => 'https://你的網站/ecpay/bind-result',         'CustomField'    => '自訂欄位',

'OrderResultURL' => 'https://你的網站/ecpay/bind-result',

], ]; $response = $postService->post($input, 'https://ecpg-stage.ecpay.com.tw/Merchant/GetTokenbyBindingCard');

$response = $postService->post($input, 'https://ecpg-stage.ecpay.com.tw/Merchant/GetTokenbyBindingCard');

], ]; $response = $postService->post($input, 'https://ecpg-stage.ecpay.com.tw/Merchant/CreateBindCard');

$response = $postService->post($input, 'https://ecpg-stage.ecpay.com.tw/Merchant/CreateBindCard');

'MerchantTradeNo'   => 'Pay' . time(),             'TotalAmount'       => 500,             'ReturnURL'         => 'https://你的網站/ecpay/notify',

'TotalAmount'       => 500,             'ReturnURL'         => 'https://你的網站/ecpay/notify',             'TradeDesc'         => '綁卡扣款',

'ReturnURL'         => 'https://你的網站/ecpay/notify',

], ]; $response = $postService->post($input, 'https://ecpg-stage.ecpay.com.tw/Merchant/CreatePaymentWithCardID');

$response = $postService->post($input, 'https://ecpg-stage.ecpay.com.tw/Merchant/CreatePaymentWithCardID');

], ]; $response = $postService->post($input, 'https://ecpg-stage.ecpay.com.tw/Merchant/GetMemberBindCard');

$response = $postService->post($input, 'https://ecpg-stage.ecpay.com.tw/Merchant/GetMemberBindCard');

], ]; $response = $postService->post($input, 'https://ecpg-stage.ecpay.com.tw/Merchant/DeleteMemberBindCard');

$response = $postService->post($input, 'https://ecpg-stage.ecpay.com.tw/Merchant/DeleteMemberBindCard');

], ]; $response = $postService->post($input, 'https://ecpg-stage.ecpay.com.tw/Merchant/GetTokenbyUser');

$response = $postService->post($input, 'https://ecpg-stage.ecpay.com.tw/Merchant/GetTokenbyUser');

]; // ⚠<U+FE0F> DoAction 僅正式環境可用（測試環境無此 API） // 正式環境：https://ecpayment.ecpay.com.tw/1.0.0/Credit/DoAction

// ⚠<U+FE0F> DoAction 僅正式環境可用（測試環境無此 API） // 正式環境：https://ecpayment.ecpay.com.tw/1.0.0/Credit/DoAction $response = $postService->post($input, 'https://ecpayment.ecpay.com.tw/1.0.0/Credit/DoAction');

// 正式環境：https://ecpayment.ecpay.com.tw/1.0.0/Credit/DoAction

$response = $postService->post($input, 'https://ecpayment.ecpay.com.tw/1.0.0/Credit/DoAction');

], ]; $response = $postService->post($input, 'https://ecpayment-stage.ecpay.com.tw/1.0.0/Cashier/CreditCardPeriodAction');

$response = $postService->post($input, 'https://ecpayment-stage.ecpay.com.tw/1.0.0/Cashier/CreditCardPeriodAction');

], ]; $response = $postService->post($input, 'https://ecpayment-stage.ecpay.com.tw/1.0.0/Cashier/QueryTrade');

$response = $postService->post($input, 'https://ecpayment-stage.ecpay.com.tw/1.0.0/Cashier/QueryTrade');

端點：`POST https://ecpayment-stage.ecpay.com.tw/1.0.0/CreditDetail/QueryTrade`

端點：`POST https://ecpayment-stage.ecpay.com.tw/1.0.0/Cashier/QueryPaymentInfo`

端點：`POST https://ecpayment-stage.ecpay.com.tw/1.0.0/Cashier/QueryTrade`（同一般查詢端點）

// 手動設定 JSON header 並呼叫 $curlService->setHeaders(['Content-Type:application/json']); $result = $curlService->run(json_encode($input), 'https://ecpayment-stage.ecpay.com.tw/1.0.0/Cashier/QueryTradeMedia');

$result = $curlService->run(json_encode($input), 'https://ecpayment-stage.ecpay.com.tw/1.0.0/Cashier/QueryTradeMedia');

Content-Security-Policy: script-src 'self' https://ecpg-stage.ecpay.com.tw https://ecpg.ecpay.com.tw;

frame-src 'self' https://ecpg-stage.ecpay.com.tw https://ecpg.ecpay.com.tw;

connect-src 'self' https://ecpg-stage.ecpay.com.tw https://ecpg.ecpay.com.tw;

> 正式環境只需保留 `https://ecpg.ecpay.com.tw`，移除 `-stage`。

brew install ngrok          # macOS choco install ngrok         # Windows（需先安裝 Chocolatey） # 或直接下載：https://ngrok.com/download

# 或直接下載：https://ngrok.com/download

# 3. 複製 Forwarding URL（格式如 https://a1b2c3d4.ngrok-free.app）

> **零安裝替代方案**：用 [RequestBin](https://requestbin.com/r) 建立臨時端點接收 callback，查看完整 JSON 結構後再實作解析邏輯。

> **ReturnURL / OrderResultURL 尚未準備好？** 先用 [RequestBin](https://requestbin.com) 或 `ngrok http 3000` 建立暫時端點，確認付款流程後再串接正式 callback 邏輯。無公開 URL 的替代方案見本節末尾。

| `CardInfo.Redeem` | String(1) | — 選填 | 是否使用紅利折抵。⚠<U+FE0F> **實測確認**：傳入字串 `"N"`/`"Y"` 會導致 API 回傳 `5100011 The parameter [Redeem] Incorrect format`。PHP SDK 範例使用整數 `0`（PHP 弱型別可運作）。**非 PHP 語言建議直接省略此選填欄位**（使用預設值不折抵），避免格式問題。若必須指定，請先以實際 API 測試確認可接受的格式 |

| `ATMInfo.ExpireDate` | Int | ✅ ChoosePaymentList=3 時必填 | 繳費有效天數（1~60，預設 3） | | `ATMInfo.ATMBankCode` | String(10) | — 選填 | 指定繳費銀行代碼，見[銀行代碼表](https://developers.ecpay.com.tw/9113.md)。不指定時系統預設特店申請的 ATM 繳費銀行 | | `CVSInfo.StoreExpireDate` | I

| `ATMInfo.ATMBankCode` | String(10) | — 選填 | 指定繳費銀行代碼，見[銀行代碼表](https://developers.ecpay.com.tw/9113.md)。不指定時系統預設特店申請的 ATM 繳費銀行 |

> 💡 **消費者自費分期**（官方規格 9040.md 2026-03）：當 `ChoosePaymentList` 包含 `0,1,2` 且 `CreditInstallment` 為 `3` 時，消費金額達 **1,000 元（含）以上**即可使用「消費者自費分期」。此功能為信用卡一次付清及分期付款的附加服務，無法單獨使用。消費者自費分期**不支援**信用卡紅利、永豐30期、定期定額及銀聯卡。當選擇信用卡分期、自費分期付款方式，輸入卡號判斷為簽帳金融卡時，會阻擋限制交易

resp = requests.post(

'https://ecpg-stage.ecpay.com.tw/Merchant/GetTokenbyTrade',

"MerchantTradeNo": f"precheck{int(time.time())}",                 "TotalAmount": 100,                 "ReturnURL": "https://example.com/notify",

"TotalAmount": 100,                 "ReturnURL": "https://example.com/notify",                 "TradeDesc": "預檢", "ItemName": "預檢"

"ReturnURL": "https://example.com/notify",

"TradeDesc": "預檢", "ItemName": "預檢"             },             "CardInfo": {"OrderResultURL": "https://example.com/result"},  # Redeem 選填，建議省略以避免格式問題

},             "CardInfo": {"OrderResultURL": "https://example.com/result"},  # Redeem 選填，建議省略以避免格式問題             "ConsumerInfo": {

"CardInfo": {"OrderResultURL": "https://example.com/result"},  # Redeem 選填，建議省略以避免格式問題

const resp = await axios.post(         'https://ecpg-stage.ecpay.com.tw/Merchant/GetTokenbyTrade',

'https://ecpg-stage.ecpay.com.tw/Merchant/GetTokenbyTrade',

MerchantTradeNo: `precheck${ts}`,                     TotalAmount: 100,                     ReturnURL: 'https://example.com/notify',

TotalAmount: 100,                     ReturnURL: 'https://example.com/notify',                     TradeDesc: '預檢', ItemName: '預檢'

ReturnURL: 'https://example.com/notify',

TradeDesc: '預檢', ItemName: '預檢'                 },                 CardInfo: { OrderResultURL: 'https://example.com/result' },  // Redeem 選填，建議省略

},                 CardInfo: { OrderResultURL: 'https://example.com/result' },  // Redeem 選填，建議省略                 ConsumerInfo: {

CardInfo: { OrderResultURL: 'https://example.com/result' },  // Redeem 選填，建議省略

**端點**：`POST https://ecpg-stage.ecpay.com.tw/Merchant/GetTokenbyTrade`（注意：`ecpg-stage`，**不是** `ecpayment-stage`）

'MerchantTradeNo'   => 'Test' . time(),   // 每次必須唯一             'TotalAmount'       => 100,             'ReturnURL'         => 'https://你的網站/ecpay/notify',

'TotalAmount'       => 100,             'ReturnURL'         => 'https://你的網站/ecpay/notify',             'TradeDesc'         => '測試',

'ReturnURL'         => 'https://你的網站/ecpay/notify',

'ItemName'          => '測試商品',         ],         'CardInfo'     => ['Redeem' => 0, 'OrderResultURL' => 'https://你的網站/ecpay/result'],  // ⚠<U+FE0F> Redeem 整數 0 僅適用 PHP 弱型別;JS/TS/Python/Go 等強型別語言務必傳整數 0(非字串 "0"/"N"),或直接**省略此選填欄位**(預設不折抵)。字串 "N"/"Y"

],         'CardInfo'     => ['Redeem' => 0, 'OrderResultURL' => 'https://你的網站/ecpay/result'],  // ⚠<U+FE0F> Redeem 整數 0 僅適用 PHP 弱型別;JS/TS/Python/Go 等強型別語言務必傳整數 0(非字串 "0"/"N"),或直接**省略此選填欄位**(預設不折抵)。字串 "N"/"Y" 會觸發 `5100011 The parameter [Redeem] In

'CardInfo'     => ['Redeem' => 0, 'OrderResultURL' => 'https://你的網站/ecpay/result'],  // ⚠<U+FE0F> Redeem 整數 0 僅適用 PHP 弱型別;JS/TS/Python/Go 等強型別語言務必傳整數 0(非字串 "0"/"N"),或直接**省略此選填欄位**(預設不折抵)。字串 "N"/"Y" 會觸發 `5100011 The parameter [Redeem] Incorrect for

],     ], ], 'https://ecpg-stage.ecpay.com.tw/Merchant/GetTokenbyTrade');

], 'https://ecpg-stage.ecpay.com.tw/Merchant/GetTokenbyTrade');

MerchantTradeNo: merchantTradeNo,            // ④ 每次必須唯一                 TotalAmount: 100,                 ReturnURL: 'https://你的網站/ecpay/notify',

TotalAmount: 100,                 ReturnURL: 'https://你的網站/ecpay/notify',                 TradeDesc: '測試',

ReturnURL: 'https://你的網站/ecpay/notify',

ItemName: '測試商品',             },             CardInfo: { OrderResultURL: 'https://你的網站/ecpay/result' },  // Redeem 選填，建議省略

},             CardInfo: { OrderResultURL: 'https://你的網站/ecpay/result' },  // Redeem 選填，建議省略             ConsumerInfo: {

CardInfo: { OrderResultURL: 'https://你的網站/ecpay/result' },  // Redeem 選填，建議省略

const res = await axios.post(         'https://ecpg-stage.ecpay.com.tw/Merchant/GetTokenbyTrade',  // ← ecpg，不是 ecpayment

'https://ecpg-stage.ecpay.com.tw/Merchant/GetTokenbyTrade',  // ← ecpg，不是 ecpayment

<!-- ⚠<U+FE0F> 三個依賴缺一不可：jQuery → node-forge → ECPay SDK，順序不可調換 --> <!-- ⚠<U+FE0F> 測試環境載入 stage SDK（正式改用 ecpg.ecpay.com.tw），環境須與 initialize('Stage'|'Prod') 一致 --> <script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>

<!-- ⚠<U+FE0F> 測試環境載入 stage SDK（正式改用 ecpg.ecpay.com.tw），環境須與 initialize('Stage'|'Prod') 一致 --> <script src="https://code.jquery.com/jquery-3.7.1.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/node-forge@0.7.0/dist/forge.min.js"></scri

<script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>

<script src="https://cdn.jsdelivr.net/npm/node-forge@0.7.0/dist/forge.min.js"></script>

<!--渲染付款界面UI，請勿更動id--> <div id="ECPayPayment"></div> <script src="https://ecpg-stage.ecpay.com.tw/Scripts/sdk-1.0.0.js?t=20210121100116"></script>

<script src="https://ecpg-stage.ecpay.com.tw/Scripts/sdk-1.0.0.js?t=20210121100116"></script>

> | 頁面無任何輸入框 | Token 無效或已逾時（預設 10 分鐘） | 回步驟 1 確認 Token 非空；縮短測試流程時間 | > | Console CORS 錯誤 | 測試/正式環境 SDK URL 與 Token 不一致 | 確認 SDK URL 與 GetToken 端點環境完全一致 | > | Console CSP 錯誤 | Content-Security-Policy 阻擋 | CSP header 加入 `https://ecpg-stage.ec

> | Console CORS 錯誤 | 測試/正式環境 SDK URL 與 Token 不一致 | 確認 SDK URL 與 GetToken 端點環境完全一致 | > | Console CSP 錯誤 | Content-Security-Policy 阻擋 | CSP header 加入 `https://ecpg-stage.ecpay.com.tw`（script-src、frame-src、connect-src） | > | callback 未觸發 | 消費

> | Console CSP 錯誤 | Content-Security-Policy 阻擋 | CSP header 加入 `https://ecpg-stage.ecpay.com.tw`（script-src、frame-src、connect-src） |

**端點**：`POST https://ecpg-stage.ecpay.com.tw/Merchant/CreatePayment`（仍是 `ecpg-stage`）

'RqHeader'   => ['Timestamp' => time()],     'Data'       => $data, ], 'https://ecpg-stage.ecpay.com.tw/Merchant/CreatePayment');

], 'https://ecpg-stage.ecpay.com.tw/Merchant/CreatePayment');

const ecpayRes = await axios.post(         'https://ecpg-stage.ecpay.com.tw/Merchant/CreatePayment',  // ← ecpg，不是 ecpayment

'https://ecpg-stage.ecpay.com.tw/Merchant/CreatePayment',  // ← ecpg，不是 ecpayment

raw = base64.b64decode(encrypted_base64)

1. GetToken 時 `ReturnURL` 填任意合法 HTTPS URL（例如 `https://example.com`）

'MerchantTradeNo' => '你在步驟1使用的訂單編號',     ], ], 'https://ecpayment-stage.ecpay.com.tw/1.0.0/Cashier/QueryTrade');

], ], 'https://ecpayment-stage.ecpay.com.tw/1.0.0/Cashier/QueryTrade'); // $response['Data']['RtnCode'] === 1 → 交易成功

], 'https://ecpayment-stage.ecpay.com.tw/1.0.0/Cashier/QueryTrade');

ngrok http 5000 # 將 ngrok 給你的 URL 設為環境變數後啟動 BASE_URL=https://xxxx.ngrok-free.app python app.py

BASE_URL=https://xxxx.ngrok-free.app python app.py

# ── 你的公開 URL（ngrok http 5000 後填入）─────────────────── BASE_URL   = os.getenv('BASE_URL', 'https://YOUR-NGROK-URL.ngrok-free.app')

BASE_URL   = os.getenv('BASE_URL', 'https://YOUR-NGROK-URL.ngrok-free.app')

# ── 端點（測試環境）────────────────────────────────────────── ECPG_URL      = 'https://ecpg-stage.ecpay.com.tw'       # GetToken, CreatePayment

ECPG_URL      = 'https://ecpg-stage.ecpay.com.tw'       # GetToken, CreatePayment

ECPAYMENT_URL = 'https://ecpayment-stage.ecpay.com.tw'  # QueryTrade, DoAction

ct = base64.b64decode(cipher_b64)

<!-- 步驟 2：載入綠界 JS SDK — 三個依賴缺一不可 -->   <!-- ⚠<U+FE0F> 測試環境載入 stage SDK（正式改用 ecpg.ecpay.com.tw），環境須與 initialize('Stage'|'Prod') 一致 -->   <script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>

<!-- ⚠<U+FE0F> 測試環境載入 stage SDK（正式改用 ecpg.ecpay.com.tw），環境須與 initialize('Stage'|'Prod') 一致 -->   <script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>   <script src="https://cdn.jsdelivr.net/npm/node-forge@0.7.0/dist/forge.min.js"></

<script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>

<script src="https://cdn.jsdelivr.net/npm/node-forge@0.7.0/dist/forge.min.js"></script>

<script src="https://ecpg-stage.ecpay.com.tw/Scripts/sdk-1.0.0.js?t=20210121100116"></script>

// 步驟 1：後端取 Token     setStatus('正在取得 Token…');     fetch('/ecpay/gettoken', {

setStatus('正在取得 Token…');     fetch('/ecpay/gettoken', {       method: 'POST',

fetch('/ecpay/gettoken', {

setStatus('取得 PayToken，送出付款中…');           // 步驟 4：後端呼叫 CreatePayment           fetch('/ecpay/create_payment', {

// 步驟 4：後端呼叫 CreatePayment           fetch('/ecpay/create_payment', {             method: 'POST',

fetch('/ecpay/create_payment', {

> ✅ **預期執行結果**： > 1. 瀏覽 `http://localhost:5000` → 看到「正在取得 Token…」

> 1. 瀏覽 `http://localhost:5000` → 看到「正在取得 Token…」

npm install express axios BASE_URL=https://xxxx.ngrok-free.app node app.js

BASE_URL=https://xxxx.ngrok-free.app node app.js

const BASE_URL    = process.env.BASE_URL || 'https://YOUR-NGROK-URL.ngrok-free.app';

const RETURN_URL  = `${BASE_URL}/ecpay/callback`; const RESULT_URL  = `${BASE_URL}/ecpay/result`; const ECPG_URL    = 'https://ecpg-stage.ecpay.com.tw';

const ECPG_URL    = 'https://ecpg-stage.ecpay.com.tw';

app.get('/', (req, res) => res.send(`<!DOCTYPE html> <html lang="zh-TW"><head><meta charset="UTF-8"><title>站內付 2.0 測試</title> <script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>

<html lang="zh-TW"><head><meta charset="UTF-8"><title>站內付 2.0 測試</title> <script src="https://code.jquery.com/jquery-3.7.1.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/node-forge@0.7.0/dist/forge.min.js"></script>

<script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>

<script src="https://cdn.jsdelivr.net/npm/node-forge@0.7.0/dist/forge.min.js"></script>

<!-- ⚠<U+FE0F> 測試環境載入 stage SDK（正式改用 ecpg.ecpay.com.tw），須與 initialize('Stage'|'Prod') 一致 --> <script src="https://ecpg-stage.ecpay.com.tw/Scripts/sdk-1.0.0.js?t=20210121100116"></script> </head><body>

<script src="https://ecpg-stage.ecpay.com.tw/Scripts/sdk-1.0.0.js?t=20210121100116"></script>

function setStatus(msg) { document.getElementById('status').textContent = msg; }   setStatus('正在取得 Token…');   fetch('/ecpay/gettoken', {

setStatus('正在取得 Token…');   fetch('/ecpay/gettoken', {     method: 'POST', headers: {'Content-Type':'application/json'},

fetch('/ecpay/gettoken', {

if (e != null) { setStatus('PayToken 失敗：'+e); return; }         setStatus('送出付款中…');         fetch('/ecpay/create_payment', {

setStatus('送出付款中…');         fetch('/ecpay/create_payment', {           method: 'POST', headers: {'Content-Type':'application/json'},

fetch('/ecpay/create_payment', {

app.listen(5000, () => {   console.log('🚀 Server: http://localhost:5000');

console.log('🚀 Server: http://localhost:5000');

HASH_KEY    = b'pwFHCqoQZGmho4w6' HASH_IV     = b'EkRm7iFT261dpevs' ECPG_URL    = 'https://ecpg-stage.ecpay.com.tw'

ECPG_URL    = 'https://ecpg-stage.ecpay.com.tw'

# ✅ 填入你的 ngrok 或可公開訪問的 URL（格式：https://xxxx.ngrok-free.app）

RETURN_URL = 'https://你的網域/ecpay/notify'   # Server-to-Server JSON POST（必填）

raw = unpad(cipher.decrypt(base64.b64decode(base64_str)), 16).decode('utf-8')

'Data': aes_encrypt(data)     }     outer = requests.post(url, json=body).json()

}     outer = requests.post(url, json=body).json()     if outer.get('TransCode') != 1:

outer = requests.post(url, json=body).json()

if __name__ == '__main__':     print(f'ATM 取號：http://localhost:5001/payment/atm')

print(f'ATM 取號：http://localhost:5001/payment/atm')

print(f'CVS 取號：http://localhost:5001/payment/cvs')

> **測試 ATM/CVS ReturnURL**：測試環境不需要真正到 ATM/超商繳費。登入 `https://vendor-stage.ecpay.com.tw` → 訂單管理 → 找到你的訂單 → 「模擬付款」，即可觸發非同步 ReturnURL 通知。

> ⚠<U+FE0F> **測試提醒**：測試環境的 ATM/CVS 付款，可在**綠界測試後台手動觸發 ReturnURL**，不需要真正到 ATM/超商繳費。   > 路徑：登入 `https://vendor-stage.ecpay.com.tw` → 訂單管理 → 找到你的訂單 → 「模擬付款」。

> 路徑：登入 `https://vendor-stage.ecpay.com.tw` → 訂單管理 → 找到你的訂單 → 「模擬付款」。

], ]; $response = $postService->post($input, 'https://ecpayment-stage.ecpay.com.tw/1.0.0/Cashier/QueryPaymentInfo');

]; $response = $postService->post($input, 'https://ecpayment-stage.ecpay.com.tw/1.0.0/Cashier/QueryPaymentInfo'); // $response['Data'] 解密後包含 BankCode / vAccount 或 PaymentNo

$response = $postService->post($input, 'https://ecpayment-stage.ecpay.com.tw/1.0.0/Cashier/QueryPaymentInfo');

// ⚠<U+FE0F> SDK 依賴 jQuery + node-forge，必須先載入（見下方 loadDependencies） // ⚠<U+FE0F> 測試環境用 ecpg-stage，正式環境改用 ecpg；載入環境須與 initialize('Stage'|'Prod') 一致 const ECPAY_SDK_URL = 'https://ecpg-stage.ecpay.com.tw/Scripts/sdk-1.0.0.js?t=20210121100116';

const ECPAY_SDK_URL = 'https://ecpg-stage.ecpay.com.tw/Scripts/sdk-1.0.0.js?t=20210121100116';

setStatus('取得 Token 中…');     try {       const res = await fetch('/api/ecpay/gettoken', {

try {       const res = await fetch('/api/ecpay/gettoken', {         method: 'POST',

const res = await fetch('/api/ecpay/gettoken', {

try {         // 步驟 4：後端 CreatePayment         const res = await fetch('/api/ecpay/create_payment', {

// 步驟 4：後端 CreatePayment         const res = await fetch('/api/ecpay/create_payment', {           method: 'POST',

const res = await fetch('/api/ecpay/create_payment', {

Data: aesEncrypt(payload),   };   const ecRes = await fetch('https://ecpg-stage.ecpay.com.tw/Merchant/GetTokenbyTrade', {

};   const ecRes = await fetch('https://ecpg-stage.ecpay.com.tw/Merchant/GetTokenbyTrade', {     method: 'POST', headers: { 'Content-Type': 'application/json' },

const ecRes = await fetch('https://ecpg-stage.ecpay.com.tw/Merchant/GetTokenbyTrade', {

// 載入 ECPay SDK   // ⚠<U+FE0F> 三個依賴必須按順序載入：jQuery → node-forge → ECPay SDK   await loadScript('https://code.jquery.com/jquery-3.7.1.min.js');

// ⚠<U+FE0F> 三個依賴必須按順序載入：jQuery → node-forge → ECPay SDK   await loadScript('https://code.jquery.com/jquery-3.7.1.min.js');   await loadScript('https://cdn.jsdelivr.net/npm/node-forge@0.7.0/dist/forge.min.js');

await loadScript('https://code.jquery.com/jquery-3.7.1.min.js');

await loadScript('https://cdn.jsdelivr.net/npm/node-forge@0.7.0/dist/forge.min.js');

// ⚠<U+FE0F> 測試環境用 ecpg-stage，正式改用 ecpg；載入環境須與 initialize('Stage'|'Prod') 一致   await loadScript('https://ecpg-stage.ecpay.com.tw/Scripts/sdk-1.0.0.js?t=20210121100116');   status.value = '取得 Token 中…';

await loadScript('https://ecpg-stage.ecpay.com.tw/Scripts/sdk-1.0.0.js?t=20210121100116');   status.value = '取得 Token 中…';   const res = await fetch('/api/ecpay/gettoken', {

status.value = '取得 Token 中…';   const res = await fetch('/api/ecpay/gettoken', {     method: 'POST',

const res = await fetch('/api/ecpay/gettoken', {

window.ECPay.getPayToken(async function(paymentInfo, errMsg) {     if (errMsg != null) { status.value = '失敗：' + errMsg; return; }     const r = await fetch('/api/ecpay/create_payment', {

if (errMsg != null) { status.value = '失敗：' + errMsg; return; }     const r = await fetch('/api/ecpay/create_payment', {       method: 'POST',

const r = await fetch('/api/ecpay/create_payment', {

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

1. 登入 [Apple Developer](https://developer.apple.com/account/)

| Content-Type | 無特殊要求（plain text 即可） | | HTTPS 必要 | ✅ 必須透過 HTTPS 可存取（HTTP 不行） | | 驗證網址 | `https://你的網域/.well-known/apple-developer-merchantid-domain-association` |

| 驗證網址 | `https://你的網域/.well-known/apple-developer-merchantid-domain-association` |

if (typeof errMsg === 'string' && errMsg.includes('Token')) {       // Token 過期，重新呼叫後端取得新 Token + 新 MerchantTradeNo       fetch('/api/get-token').then(r => r.json()).then(({ token, tradeNo }) => {

// Token 過期，重新呼叫後端取得新 Token + 新 MerchantTradeNo       fetch('/api/get-token').then(r => r.json()).then(({ token, tradeNo }) => {         updateToken(token, tradeNo);  // 更新前端持有的 Token

fetch('/api/get-token').then(r => r.json()).then(({ token, tradeNo }) => {

for attempt in range(max_retries + 1):         try:             outer = requests.post(url, json={

try:             outer = requests.post(url, json={                 'MerchantID': MERCHANT_ID,

outer = requests.post(url, json={

'TradeDesc'         => 'backend auth test',             'ItemName'          => '測試商品',         // 必填             'ReturnURL'         => 'https://你的網站/ecpay/backend-notify',

'ItemName'          => '測試商品',         // 必填             'ReturnURL'         => 'https://你的網站/ecpay/backend-notify',             // ⚠<U+FE0F> ChoosePayment / CardInfo / ConsumerInfo 為 OrderInfo 的子物件（官方規格 45958.md）

'ReturnURL'         => 'https://你的網站/ecpay/backend-notify',

], ]; $response = $postService->post($input, 'https://ecpayment-stage.ecpay.com.tw/1.0.0/Cashier/BackAuth');

$response = $postService->post($input, 'https://ecpayment-stage.ecpay.com.tw/1.0.0/Cashier/BackAuth');

| Content-Type | `application/json` | | 認證 | AES-128-CBC 加密 Data 欄位 — 詳見 [guides/14-aes-encryption.md](./14-aes-encryption.md) | | 測試環境（BackAuth / CreditPeriodAction） | `https://ecpayment-stage.ecpay.com.tw` |

| 認證 | AES-128-CBC 加密 Data 欄位 — 詳見 [guides/14-aes-encryption.md](./14-aes-encryption.md) | | 測試環境（BackAuth / CreditPeriodAction） | `https://ecpayment-stage.ecpay.com.tw` | | 正式環境（BackAuth / CreditPeriodAction） | `https://ecpayment.ecpay.com

| 測試環境（BackAuth / CreditPeriodAction） | `https://ecpayment-stage.ecpay.com.tw` |

| 正式環境（BackAuth / CreditPeriodAction） | `https://ecpayment.ecpay.com.tw` |

| 測試環境（CreatePaymentWithCardID 綁卡代扣系列） | `https://ecpg-stage.ecpay.com.tw` |

| 正式環境（CreatePaymentWithCardID 綁卡代扣系列） | `https://ecpg.ecpay.com.tw` |

], ]; $response = $postService->post($input, 'https://ecpayment-stage.ecpay.com.tw/1.0.0/Cashier/BackAuth');

$response = $postService->post($input, 'https://ecpayment-stage.ecpay.com.tw/1.0.0/Cashier/BackAuth');

端點和完整參數詳見官方文件：[references/Payment/信用卡幕後授權API技術文件.md](../references/Payment/信用卡幕後授權API技術文件.md)（16 個 URL）， 其中授權交易參數頁面為：https://developers.ecpay.com.tw/45958.md

其中授權交易參數頁面為：https://developers.ecpay.com.tw/45958.md

'TradeDesc'         => '綁卡交易描述',         'ItemName'          => '交易名稱',         'ReturnURL'         => 'https://你的網站/ecpay/return',

'ItemName'          => '交易名稱',         'ReturnURL'         => 'https://你的網站/ecpay/return',     ],

'ReturnURL'         => 'https://你的網站/ecpay/return',

],     'OrderResultURL' => 'https://你的網站/ecpay/bind-result',     'CustomField'    => '自訂欄位',

'OrderResultURL' => 'https://你的網站/ecpay/bind-result',

'Data'       => $data, ]; $response = $postService->post($input, 'https://ecpg-stage.ecpay.com.tw/Merchant/GetTokenbyBindingCard');

[Credential-related source omitted]

$response = $postService->post($input, 'https://ecpg-stage.ecpay.com.tw/Merchant/GetTokenbyBindingCard');

'MerchantTradeNo'   => 'test' . time(),         'TotalAmount'       => '100',         'ReturnURL'         => 'https://你的網站/ecpay/return',

'TotalAmount'       => '100',         'ReturnURL'         => 'https://你的網站/ecpay/return',         'TradeDesc'         => 'DESC',

'ReturnURL'         => 'https://你的網站/ecpay/return',

'Data'       => $data, ]; $response = $postService->post($input, 'https://ecpg-stage.ecpay.com.tw/Merchant/CreatePaymentWithCardID');

$response = $postService->post($input, 'https://ecpg-stage.ecpay.com.tw/Merchant/CreatePaymentWithCardID');

'MerchantTradeNo'  => '綁卡時的 MerchantTradeNo', ]; // POST → 'https://ecpg-stage.ecpay.com.tw/Merchant/GetMemberBindCard'

// POST → 'https://ecpg-stage.ecpay.com.tw/Merchant/GetMemberBindCard'

'BindCardID' => '要刪除的 BindCardID', ]; // POST → 'https://ecpg-stage.ecpay.com.tw/Merchant/DeleteMemberBindCard'

// POST → 'https://ecpg-stage.ecpay.com.tw/Merchant/DeleteMemberBindCard'

'TradeDesc'         => '背景取號測試',             'ItemName'          => '測試商品',             'ReturnURL'         => 'https://你的網站/ecpay/notify',

'ItemName'          => '測試商品',             'ReturnURL'         => 'https://你的網站/ecpay/notify',         ],

'ReturnURL'         => 'https://你的網站/ecpay/notify',

], ]; $response = $postService->post($input, 'https://ecpayment-stage.ecpay.com.tw/1.0.0/Cashier/GenPaymentCode');

$response = $postService->post($input, 'https://ecpayment-stage.ecpay.com.tw/1.0.0/Cashier/GenPaymentCode');

> ⚠<U+FE0F> **DoAction 測試環境限制**：測試環境因無法提供實際授權，故無法使用 DoAction API（`/1.0.0/Credit/DoAction`）。正式環境端點為 `https://ecpayment.ecpay.com.tw/1.0.0/Credit/DoAction`。

端點：`POST https://ecpayment-stage.ecpay.com.tw/1.0.0/Cashier/CreditCardPeriodAction`

'Data'       => $data, ]; $response = $postService->post($input, 'https://ecpayment-stage.ecpay.com.tw/1.0.0/Cashier/CreditCardPeriodAction');

$response = $postService->post($input, 'https://ecpayment-stage.ecpay.com.tw/1.0.0/Cashier/CreditCardPeriodAction');

- PHP SDK：`composer require ecpay/sdk` - SDK Service：`PostWithAesJsonResponseService` - 基礎端點：`https://einvoice-stage.ecpay.com.tw/B2CInvoice/`

- 基礎端點：`https://einvoice-stage.ecpay.com.tw/B2CInvoice/`

> ⚠<U+FE0F> **SNAPSHOT 2026-04** | 來源：`references/Invoice/B2C電子發票介接技術文件.md` > 📋 以下為 B2C 發票 Issue API 欄位一覽。詳細規格請 web_fetch [7896.md](https://developers.ecpay.com.tw/7896.md)。

> 📋 以下為 B2C 發票 Issue API 欄位一覽。詳細規格請 web_fetch [7896.md](https://developers.ecpay.com.tw/7896.md)。

// ECPay B2C 電子發票開立範例 // 資料來源：SNAPSHOT 2026-04 based on web_fetch https://developers.ecpay.com.tw/7896.md

// 資料來源：SNAPSHOT 2026-04 based on web_fetch https://developers.ecpay.com.tw/7896.md

try {     $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/Issue');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/Issue');

ct = base64.b64decode(cipher_b64)

# 開立發票 data = post_invoice('https://einvoice-stage.ecpay.com.tw/B2CInvoice/Issue', {

data = post_invoice('https://einvoice-stage.ecpay.com.tw/B2CInvoice/Issue', {

// 開立發票 postInvoice('https://einvoice-stage.ecpay.com.tw/B2CInvoice/Issue', {

postInvoice('https://einvoice-stage.ecpay.com.tw/B2CInvoice/Issue', {

| Content-Type | `application/json` | | 認證 | AES-128-CBC 加密 Data 欄位 — 詳見 [guides/14-aes-encryption.md](./14-aes-encryption.md) | | 測試環境 | `https://einvoice-stage.ecpay.com.tw` |

| 認證 | AES-128-CBC 加密 Data 欄位 — 詳見 [guides/14-aes-encryption.md](./14-aes-encryption.md) | | 測試環境 | `https://einvoice-stage.ecpay.com.tw` | | 正式環境 | `https://einvoice.ecpay.com.tw` |

| 測試環境 | `https://einvoice-stage.ecpay.com.tw` |

| 正式環境 | `https://einvoice.ecpay.com.tw` |

]; try {     $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/Issue');

try {     $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/Issue');     // 成功時 Data 包含 InvoiceNo（發票號碼）

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/Issue');

'PayType'       => '2',         // 2=綠界金流         'PayAct'        => 'ECPAY',         'NotifyURL'     => 'https://你的網站/ecpay/invoice-notify',

'PayAct'        => 'ECPAY',         'NotifyURL'     => 'https://你的網站/ecpay/invoice-notify',     ],

'NotifyURL'     => 'https://你的網站/ecpay/invoice-notify',

], ]; $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/DelayIssue');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/DelayIssue');

], ]; $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/TriggerIssue');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/TriggerIssue');

'Data'       => ['MerchantID' => '2000132', 'Tsr' => '之前的交易序號'], ]; $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/CancelDelayIssue');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/CancelDelayIssue');

], ]; $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/Invalid');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/Invalid');

], ]; $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/VoidWithReIssue');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/VoidWithReIssue');

], ]; $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/Allowance');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/Allowance');

],     // 公立學校及政府機關折讓（AllowanceByCollegiate）專屬：結果非同步通知到此 URL     'ReturnURL' => 'https://你的網站/ecpay/allowance-collegiate-notify',

// 公立學校及政府機關折讓（AllowanceByCollegiate）專屬：結果非同步通知到此 URL     'ReturnURL' => 'https://你的網站/ecpay/allowance-collegiate-notify', ];

'ReturnURL' => 'https://你的網站/ecpay/allowance-collegiate-notify',

try {     $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/AllowanceByCollegiate');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/AllowanceByCollegiate');

> ⚠<U+FE0F> **SNAPSHOT 2026-04** | 來源：`references/Invoice/B2C電子發票介接技術文件.md` → [檢查碼機制](https://developers.ecpay.com.tw/38242.md)

], ]; $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/AllowanceInvalid');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/AllowanceInvalid');

'Data'       => ['MerchantID' => '2000132', 'BarCode' => '/1234567'], ]; $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/CheckBarcode');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/CheckBarcode');

'Data'       => ['MerchantID' => '2000132', 'LoveCode' => '168001'], ]; $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/CheckLoveCode');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/CheckLoveCode');

'Data'       => ['MerchantID' => '2000132', 'InvoiceNo' => 'AB12345678', 'InvoiceDate' => '2025-01-15'], ]; $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/GetIssue');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/GetIssue');

'Data'       => ['MerchantID' => '2000132', 'RelateNumber' => 'Inv1234567890'], ]; $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/GetIssue');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/GetIssue');

]; try {     $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/GetIssueList');

try {     $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/GetIssueList');     // Data 包含 TotalCount（總筆數）、InvoiceData（發票陣列）

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/GetIssueList');

], ]; $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/InvoiceNotify');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/InvoiceNotify');

], ]; $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/GetInvoiceWordSetting');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/GetInvoiceWordSetting');

| API | 端點 | 參考 URL | |-----|------|---------| | 統一編號驗證 | `/B2CInvoice/CheckCompanyIdentifier` | [規格](https://developers.ecpay.com.tw/32089.md) |

|-----|------|---------| | 統一編號驗證 | `/B2CInvoice/CheckCompanyIdentifier` | [規格](https://developers.ecpay.com.tw/32089.md) | | 取消線上折讓 | `/B2CInvoice/CancelAllowance` | [規格](https://developers.ecpay.com.tw/7913.md) |

| 統一編號驗證 | `/B2CInvoice/CheckCompanyIdentifier` | [規格](https://developers.ecpay.com.tw/32089.md) |

| 取消線上折讓 | `/B2CInvoice/CancelAllowance` | [規格](https://developers.ecpay.com.tw/7913.md) |

| 發票列印 | `/B2CInvoice/InvoicePrint` | [規格](https://developers.ecpay.com.tw/7949.md) |

| 編輯延遲開立 | `/B2CInvoice/EditDelayIssue` | [規格](https://developers.ecpay.com.tw/47979.md) |

]; try {     $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/GetGovInvoiceWordSetting');

try {     $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/GetGovInvoiceWordSetting');     // Data 包含財政部核發的字軌配號清單

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/GetGovInvoiceWordSetting');

]; try {     $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/InvoiceWordSetting');

try {     $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/InvoiceWordSetting'); } catch (\Exception $e) {

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/InvoiceWordSetting');

]; try {     $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/UpdateInvoiceWordStatus');

try {     $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/UpdateInvoiceWordStatus'); } catch (\Exception $e) {

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/UpdateInvoiceWordStatus');

]; try {     $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/GetIssueByRelateNo');

try {     $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/GetIssueByRelateNo');     // Data 包含 InvoiceNo（發票號碼）、InvoiceDate 等發票資訊

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/GetIssueByRelateNo');

- SDK Service：`PostWithAesJsonResponseService` - 基礎端點:   - 測試環境:`https://einvoice-stage.ecpay.com.tw/B2BInvoice/`

- 基礎端點:   - 測試環境:`https://einvoice-stage.ecpay.com.tw/B2BInvoice/`   - 正式環境:`https://einvoice.ecpay.com.tw/B2BInvoice/`

- 測試環境:`https://einvoice-stage.ecpay.com.tw/B2BInvoice/`

- 正式環境:`https://einvoice.ecpay.com.tw/B2BInvoice/`

// ECPay B2B 電子發票開立範例（存證模式） // 資料來源：SNAPSHOT 2026-04 based on web_fetch https://developers.ecpay.com.tw/24230.md

// 資料來源：SNAPSHOT 2026-04 based on web_fetch https://developers.ecpay.com.tw/24230.md

try {     $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/Issue');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/Issue');

// 開立存證模式 B2B 發票 postInvoiceB2B('https://einvoice-stage.ecpay.com.tw/B2BInvoice/Issue', {

postInvoiceB2B('https://einvoice-stage.ecpay.com.tw/B2BInvoice/Issue', {

], ]; $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/IssueConfirm');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/IssueConfirm');

| Content-Type | `application/json` | | 認證 | AES-128-CBC 加密 Data 欄位 — 詳見 [guides/14-aes-encryption.md](./14-aes-encryption.md) | | 測試環境 | `https://einvoice-stage.ecpay.com.tw` |

| 認證 | AES-128-CBC 加密 Data 欄位 — 詳見 [guides/14-aes-encryption.md](./14-aes-encryption.md) | | 測試環境 | `https://einvoice-stage.ecpay.com.tw` | | 正式環境 | `https://einvoice.ecpay.com.tw` |

| 測試環境 | `https://einvoice-stage.ecpay.com.tw` |

| 正式環境 | `https://einvoice.ecpay.com.tw` |

> ⚠<U+FE0F> **SNAPSHOT 2026-04** | 來源：`references/Invoice/B2B電子發票API技術文件_存證模式.md`（[24230.md](https://developers.ecpay.com.tw/24230.md)）及 `_交換模式.md`（[14850.md](https://developers.ecpay.com.tw/14850.md)）

> 📋 以下為 B2B 發票 Issue API 欄位一覽。詳細規格請 web_fetch [24230.md](https://developers.ecpay.com.tw/24230.md) 存證模式或 [14850.md](https://developers.ecpay.com.tw/14850.md) 交換模式。

], ]; $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/Issue');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/Issue');

> - **B2B** 使用 `ItemTax`（Number）— 代表該商品的**稅額金額**（整數，最多 11 位），選填（未帶由綠界代算）；特種稅額發票帶 `0` > - **⚠<U+FE0F> 兩者語意完全不同**：`ItemTaxType` 是稅別分類碼（字串），`ItemTax` 是實際稅額數值（數字）。帶錯欄位名或型別會直接導致開立失敗 > - **⚠<U+FE0F> SDK 差異**：官方 PHP SDK 範例使用 `ItemTaxType`（B2C 欄位名），但官方 API 技術文件（

> - **⚠<U+FE0F> SDK 差異**：官方 PHP SDK 範例使用 `ItemTaxType`（B2C 欄位名），但官方 API 技術文件（[24230.md](https://developers.ecpay.com.tw/24230.md)、[14850.md](https://developers.ecpay.com.tw/14850.md)）的 B2B 欄位名為 `ItemTax`。本指南依**官方 API 技術文件**使用 `ItemTax`。若使用 SDK 包裝，

], ]; $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/IssueConfirm');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/IssueConfirm');

], ]; $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/Invalid');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/Invalid');

], ]; $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/InvalidConfirm');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/InvalidConfirm');

], ]; $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/Reject');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/Reject');

], ]; $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/RejectConfirm');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/RejectConfirm');

], ]; $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/Allowance');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/Allowance');

], ]; $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/Notify');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/Notify');

], ]; $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/MaintainMerchantCustomerData');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/MaintainMerchantCustomerData');

], ]; $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/GetInvoiceWordSetting');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/GetInvoiceWordSetting');

]; try {     $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/Issue');

try {     $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/Issue');     // 存證模式開立後即生效，不需要買方確認

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/Issue');

]; try {     $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/Allowance');

try {     $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/Allowance');     // 存證模式折讓直接生效，不需要 AllowanceConfirm

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/Allowance');

]; try {     $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/Invalid');

try {     $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/Invalid');     // 存證模式作廢直接生效，不需要 InvalidConfirm

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/Invalid');

]; try {     $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/CancelAllowance');

try {     $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/CancelAllowance'); } catch (\Exception $e) {

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2BInvoice/CancelAllowance');

> 完整參數規格請用 `web_fetch` 讀取 `references/Invoice/B2B電子發票API技術文件_存證模式.md` → 發票作業 / 註銷重開（https://developers.ecpay.com.tw/49927.md）

- ⚠<U+FE0F> **B2C 與 C2C 帳號不可混用**：B2C 帳號無法建立 C2C 訂單（反之亦然），API 會回傳 MerchantID 不符錯誤 - 加密方式：CheckMacValue **MD5**（與金流不同！） - 基礎端點：`https://logistics-stage.ecpay.com.tw/`

- 基礎端點：`https://logistics-stage.ecpay.com.tw/`

'LogisticsSubType' => 'FAMI',      // FAMI=全家，測試環境可用     'IsCollection'     => 'N',     'ServerReplyURL'   => 'https://你的網站/ecpay/map-result',  // ⚠<U+FE0F> 此為「地圖選店結果」專用端點,與步驟 2 建單的物流狀態通知端點不同

'IsCollection'     => 'N',     'ServerReplyURL'   => 'https://你的網站/ecpay/map-result',  // ⚠<U+FE0F> 此為「地圖選店結果」專用端點,與步驟 2 建單的物流狀態通知端點不同 ];

'ServerReplyURL'   => 'https://你的網站/ecpay/map-result',  // ⚠<U+FE0F> 此為「地圖選店結果」專用端點,與步驟 2 建單的物流狀態通知端點不同

echo $autoSubmitFormService->generate($input, 'https://logistics-stage.ecpay.com.tw/Express/map');

'ReceiverCellPhone' => '0987654321',     'ReceiverStoreID'   => $cvsStoreID,   // 從步驟 1 取得     'ServerReplyURL'    => 'https://你的網站/ecpay/logistics-notify',  // ⚠<U+FE0F> 此為「物流狀態通知」專用端點,與步驟 1 的地圖選店端點(`/ecpay/map-result`)不同

'ReceiverStoreID'   => $cvsStoreID,   // 從步驟 1 取得     'ServerReplyURL'    => 'https://你的網站/ecpay/logistics-notify',  // ⚠<U+FE0F> 此為「物流狀態通知」專用端點,與步驟 1 的地圖選店端點(`/ecpay/map-result`)不同 ];

'ServerReplyURL'    => 'https://你的網站/ecpay/logistics-notify',  // ⚠<U+FE0F> 此為「物流狀態通知」專用端點,與步驟 1 的地圖選店端點(`/ecpay/map-result`)不同

]; $response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/Create'); // 解析 pipe-separated 回應：1|OK|AllPayLogisticsID=...

$response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/Create');

[Credential-related source omitted]

| Content-Type | `application/x-www-form-urlencoded` | | 認證 | CheckMacValue（**MD5**，非 SHA256） — 詳見 [guides/13-checkmacvalue.md](./13-checkmacvalue.md) | | 測試環境 | `https://logistics-stage.ecpay.com.tw` |

| 認證 | CheckMacValue（**MD5**，非 SHA256） — 詳見 [guides/13-checkmacvalue.md](./13-checkmacvalue.md) | | 測試環境 | `https://logistics-stage.ecpay.com.tw` | | 正式環境 | `https://logistics.ecpay.com.tw` |

| 測試環境 | `https://logistics-stage.ecpay.com.tw` |

| 正式環境 | `https://logistics.ecpay.com.tw` |

'LogisticsSubType'=> 'FAMI',       // B2C: FAMI/UNIMART/HILIFE; C2C: FAMIC2C/UNIMARTC2C/HILIFEC2C/OKMARTC2C     'IsCollection'    => 'N',           // Y=貨到付款, N=僅配送     'ServerReplyURL'  => 'https://你的網站/ecpay/map-result',

'IsCollection'    => 'N',           // Y=貨到付款, N=僅配送     'ServerReplyURL'  => 'https://你的網站/ecpay/map-result', ];

'ServerReplyURL'  => 'https://你的網站/ecpay/map-result',

echo $autoSubmitFormService->generate($input, 'https://logistics-stage.ecpay.com.tw/Express/map');

'ReceiverName'     => '收件人',     'ReceiverCellPhone'=> '0987654321',     'ServerReplyURL'   => 'https://你的網站/ecpay/logistics-notify',

'ReceiverCellPhone'=> '0987654321',     'ServerReplyURL'   => 'https://你的網站/ecpay/logistics-notify',     'ReceiverStoreID'  => '門市代碼',  // 從電子地圖取得

'ServerReplyURL'   => 'https://你的網站/ecpay/logistics-notify',

try {     $response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/Create');

$response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/Create');

'ScheduledPickupTime' => '4',          // 4=不限時     'ScheduledDeliveryTime'=> '4',         // 4=不限時     'ServerReplyURL'      => 'https://你的網站/ecpay/logistics-notify',

'ScheduledDeliveryTime'=> '4',         // 4=不限時     'ServerReplyURL'      => 'https://你的網站/ecpay/logistics-notify', ];

'ServerReplyURL'      => 'https://你的網站/ecpay/logistics-notify',

try {     $response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/Create');

$response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/Create');

'ServiceType'    => '4',     'SenderName'     => '退貨人',     'ServerReplyURL' => 'https://你的網站/ecpay/return-notify',

'SenderName'     => '退貨人',     'ServerReplyURL' => 'https://你的網站/ecpay/return-notify', ];

'ServerReplyURL' => 'https://你的網站/ecpay/return-notify',

]; // 全家退貨 $response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/express/ReturnCVS');

// 全家退貨 $response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/express/ReturnCVS'); // 統一退貨

$response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/express/ReturnCVS');

$response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/express/ReturnUniMartCVS');

'Temperature'      => '0001',     'Distance'         => '00',     'ServerReplyURL'   => 'https://你的網站/ecpay/return-notify',

'Distance'         => '00',     'ServerReplyURL'   => 'https://你的網站/ecpay/return-notify', ];

'ServerReplyURL'   => 'https://你的網站/ecpay/return-notify',

$response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/ReturnHome');

'ShipmentDate'     => '2025/01/20', ]; $response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Helper/UpdateShipmentInfo');

$response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Helper/UpdateShipmentInfo');

'ReceiverStoreID'  => '新門市代碼', ]; $response = $postServiceC2C->post($input, 'https://logistics-stage.ecpay.com.tw/Express/UpdateStoreInfo');

$response = $postServiceC2C->post($input, 'https://logistics-stage.ecpay.com.tw/Express/UpdateStoreInfo');

'CVSValidationNo'  => '驗證碼', ]; $response = $postServiceC2C->post($input, 'https://logistics-stage.ecpay.com.tw/Express/CancelC2COrder');

$response = $postServiceC2C->post($input, 'https://logistics-stage.ecpay.com.tw/Express/CancelC2COrder');

'TimeStamp'        => time(), ]; $response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Helper/QueryLogisticsTradeInfo/V2');

$response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Helper/QueryLogisticsTradeInfo/V2');

'AllPayLogisticsID'=> '物流編號', ]; echo $autoSubmitFormService->generate($input, 'https://logistics-stage.ecpay.com.tw/helper/printTradeDocument');

echo $autoSubmitFormService->generate($input, 'https://logistics-stage.ecpay.com.tw/helper/printTradeDocument');

'CvsType'    => 'All',  // All/FAMI/UNIMART/HILIFE/OKMART/UNIMARTFREEZE ]; $response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Helper/GetStoreList');

$response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Helper/GetStoreList');

'MerchantID'       => '2000132',     'LogisticsSubType' => 'FAMI',     'ClientReplyURL'   => 'https://你的網站/ecpay/test-data-result',

'LogisticsSubType' => 'FAMI',     'ClientReplyURL'   => 'https://你的網站/ecpay/test-data-result', ];

'ClientReplyURL'   => 'https://你的網站/ecpay/test-data-result',

echo $autoSubmitFormService->generate($input, 'https://logistics-stage.ecpay.com.tw/Express/CreateTestData');

> **⚠<U+FE0F> 帳號與國內物流（B2C）相同，但協議不同**：國內物流使用 CMV-MD5（Form POST），全方位物流 v2 使用 **AES-JSON**（JSON POST）。API 端點前綴也不同（`/Express/` vs `/Express/v2/`）。 - SDK Service：`PostWithAesJsonResponseService` 或 `PostWithAesStrResponseService` - 基礎端點：`https://logisti

- 基礎端點：`https://logistics-stage.ecpay.com.tw/Express/v2/`

'SenderZipCode'   => '106',         'SenderAddress'   => '台北市大安區測試路1號',         'ServerReplyURL'  => 'https://你的網站/ecpay/logistics-notify',  // ← 物流狀態 callback

'SenderAddress'   => '台北市大安區測試路1號',         'ServerReplyURL'  => 'https://你的網站/ecpay/logistics-notify',  // ← 物流狀態 callback         'ClientReplyURL'  => 'https://你的網站/ecpay/logistics-result',  // ← 消費者選店後的前端跳轉

'ServerReplyURL'  => 'https://你的網站/ecpay/logistics-notify',  // ← 物流狀態 callback

'ClientReplyURL'  => 'https://你的網站/ecpay/logistics-result',  // ← 消費者選店後的前端跳轉

], ]; $response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/v2/RedirectToLogisticsSelection');

]; $response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/v2/RedirectToLogisticsSelection'); echo $response['body'];  // 輸出 HTML 重導向頁面（消費者進行選店）

$response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/v2/RedirectToLogisticsSelection');

]; // PostWithAesJsonResponseService 內部自動驗證 TransCode，TransCode ≠ 1 時拋出 TransException（雙層檢查的第一層） $response = $postService2->post($input, 'https://logistics-stage.ecpay.com.tw/Express/v2/CreateByTempTrade');

// PostWithAesJsonResponseService 內部自動驗證 TransCode，TransCode ≠ 1 時拋出 TransException（雙層檢查的第一層） $response = $postService2->post($input, 'https://logistics-stage.ecpay.com.tw/Express/v2/CreateByTempTrade'); // ✅ 成功：$response['Data']['RtnCode']

$response = $postService2->post($input, 'https://logistics-stage.ecpay.com.tw/Express/v2/CreateByTempTrade');

ct = base64.b64decode(cipher_b64)

| Content-Type | `application/json` | | 認證 | AES-128-CBC 加密 Data 欄位 — 詳見 [guides/14-aes-encryption.md](./14-aes-encryption.md) | | 測試環境 | `https://logistics-stage.ecpay.com.tw` |

| 認證 | AES-128-CBC 加密 Data 欄位 — 詳見 [guides/14-aes-encryption.md](./14-aes-encryption.md) | | 測試環境 | `https://logistics-stage.ecpay.com.tw` | | 正式環境 | `https://logistics.ecpay.com.tw` |

| 測試環境 | `https://logistics-stage.ecpay.com.tw` |

| 正式環境 | `https://logistics.ecpay.com.tw` |

'SenderZipCode'   => '106',         'SenderAddress'   => '台北市大安區測試路1號',         'ServerReplyURL'  => 'https://你的網站/ecpay/logistics-notify',

'SenderAddress'   => '台北市大安區測試路1號',         'ServerReplyURL'  => 'https://你的網站/ecpay/logistics-notify',         'ClientReplyURL'  => 'https://你的網站/ecpay/logistics-result',

'ServerReplyURL'  => 'https://你的網站/ecpay/logistics-notify',

'ClientReplyURL'  => 'https://你的網站/ecpay/logistics-result',

], ]; $response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/v2/RedirectToLogisticsSelection');

]; $response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/v2/RedirectToLogisticsSelection'); echo $response['body'];  // 輸出 HTML 頁面

$response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/v2/RedirectToLogisticsSelection');

], ]; $response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/v2/UpdateTempTrade');

$response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/v2/UpdateTempTrade');

], ]; $response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/v2/CreateByTempTrade');

$response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/v2/CreateByTempTrade');

], ]; $response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/v2/QueryLogisticsTradeInfo');

$response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/v2/QueryLogisticsTradeInfo');

], ]; $response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/v2/PrintTradeDocument');

]; $response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/v2/PrintTradeDocument'); echo $response['body'];

$response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/v2/PrintTradeDocument');

'ServiceType'    => '4',         'SenderName'     => '退貨人',         'ServerReplyURL' => 'https://你的網站/ecpay/return-notify',

'SenderName'     => '退貨人',         'ServerReplyURL' => 'https://你的網站/ecpay/return-notify',     ],

'ServerReplyURL' => 'https://你的網站/ecpay/return-notify',

], ]; $response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/v2/ReturnCVS');

$response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/v2/ReturnCVS');

'Distance'       => '00',     'Specification'  => '0001',     'ServerReplyURL' => 'https://你的網站/ecpay/return-notify',

'Specification'  => '0001',     'ServerReplyURL' => 'https://你的網站/ecpay/return-notify', ];

'ServerReplyURL' => 'https://你的網站/ecpay/return-notify',

$response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/v2/ReturnHome');

'ShipmentDate' => '2026/03/16', ]; $response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/v2/UpdateShipmentInfo');

$response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/v2/UpdateShipmentInfo');

'LogisticsSubType' => 'FAMI', ]; $response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/v2/CreateTestData');

$response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/v2/CreateTestData');

'CVSValidationNo'  => '驗證碼', ]; $response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/v2/CancelC2COrder');

$response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/v2/CancelC2COrder');

'ReceiverStoreID'  => '新門市代碼', ]; $response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/v2/UpdateStoreInfo');

$response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/Express/v2/UpdateStoreInfo');

> **此帳號也與 AIO 金流的 `3002607`、發票的 `2000132`(同編號但不同 HashKey)、離線發票的 `3085340` 完全無關**。切勿混用 HashKey/HashIV。 - SDK Service：`PostWithAesJsonResponseService` - 基礎端點：`https://logistics-stage.ecpay.com.tw/CrossBorder/`

- 基礎端點：`https://logistics-stage.ecpay.com.tw/CrossBorder/`

| Content-Type | `application/json` | | 認證 | AES-128-CBC 加密 Data 欄位 — 詳見 [guides/14-aes-encryption.md](./14-aes-encryption.md) | | 測試環境 | `https://logistics-stage.ecpay.com.tw` |

| 認證 | AES-128-CBC 加密 Data 欄位 — 詳見 [guides/14-aes-encryption.md](./14-aes-encryption.md) | | 測試環境 | `https://logistics-stage.ecpay.com.tw` | | 正式環境 | `https://logistics.ecpay.com.tw` |

| 測試環境 | `https://logistics-stage.ecpay.com.tw` |

| 正式環境 | `https://logistics.ecpay.com.tw` |

'SenderEmail'       => 'sender@example.com',         'Remark'            => '備註',         'ServerReplyURL'    => 'https://你的網站/ecpay/cb-notify',

'Remark'            => '備註',         'ServerReplyURL'    => 'https://你的網站/ecpay/cb-notify',     ],

'ServerReplyURL'    => 'https://你的網站/ecpay/cb-notify',

], ]; $response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/CrossBorder/Create');

$response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/CrossBorder/Create');

dec = unpad(decipher.decrypt(base64.b64decode(b64)), 16).decode('utf-8')

resp = requests.post('https://logistics-stage.ecpay.com.tw/CrossBorder/Create', json={

'SenderAddress':     '台北市大安區測試路1號',         'SenderEmail':       'sender@example.com',         'ServerReplyURL':    'https://你的網站/ecpay/cb-notify',

'SenderEmail':       'sender@example.com',         'ServerReplyURL':    'https://你的網站/ecpay/cb-notify',     })

'ServerReplyURL':    'https://你的網站/ecpay/cb-notify',

'LogisticsSubType' => 'UNIMARTCBCVS',     'Destination'      => 'SG',     'ServerReplyURL'   => 'https://你的網站/ecpay/map-result',

'Destination'      => 'SG',     'ServerReplyURL'   => 'https://你的網站/ecpay/map-result', ];

'ServerReplyURL'   => 'https://你的網站/ecpay/map-result',

echo $autoSubmitFormService->generate($input, 'https://logistics-stage.ecpay.com.tw/CrossBorder/Map');

], ]; $response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/CrossBorder/Print');

$response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/CrossBorder/Print');

], ]; $response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/CrossBorder/QueryLogisticsTradeInfo');

$response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/CrossBorder/QueryLogisticsTradeInfo');

], ]; $response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/CrossBorder/CreateTestData');

$response = $postService->post($input, 'https://logistics-stage.ecpay.com.tw/CrossBorder/CreateTestData');

測試環境 URL：`https://ecticket-stage.ecpay.com.tw`

'IssueType'          => '4',          // 必填：4=純序號     'Operator'           => 'System',     // 必填：建立人員（限英數字）     'UseStatusNotifyURL' => 'https://你的網站/ecticket/notify',

'Operator'           => 'System',     // 必填：建立人員（限英數字）     'UseStatusNotifyURL' => 'https://你的網站/ecticket/notify',     'TicketInfo'         => [

'UseStatusNotifyURL' => 'https://你的網站/ecticket/notify',

HASH_KEY     = 'c539115ea7674f20'   # ⚠<U+FE0F> 價金保管特店測試帳號，不同於金流/發票 HASH_IV      = '86f625e60cb1473a' ECTICKET_URL = 'https://ecticket-stage.ecpay.com.tw'

ECTICKET_URL = 'https://ecticket-stage.ecpay.com.tw'

encrypted = base64.b64decode(cipher_b64)

encrypted = base64.b64decode(cipher_b64)

'IssueType':          '4',          # 必填：4=純序號（不需先上架商品）         'Operator':           'System',     # 必填：建立人員（限英數字）         'UseStatusNotifyURL': 'https://YOUR-NGROK-URL.ngrok-free.app/ecticket/notify',

'Operator':           'System',     # 必填：建立人員（限英數字）         'UseStatusNotifyURL': 'https://YOUR-NGROK-URL.ngrok-free.app/ecticket/notify',         'TicketInfo': [{

'UseStatusNotifyURL': 'https://YOUR-NGROK-URL.ngrok-free.app/ecticket/notify',

encrypted = base64.b64decode(cipher_b64)

| Content-Type | `application/json` | | 認證 | AES-128-CBC 加密 Data 欄位 + **CheckMacValue** 必填 — 詳見 [guides/14-aes-encryption.md](./14-aes-encryption.md) | | 測試環境 | `https://ecticket-stage.ecpay.com.tw` |

| 認證 | AES-128-CBC 加密 Data 欄位 + **CheckMacValue** 必填 — 詳見 [guides/14-aes-encryption.md](./14-aes-encryption.md) | | 測試環境 | `https://ecticket-stage.ecpay.com.tw` | | 正式環境 | `https://ecticket.ecpay.com.tw` |

| 測試環境 | `https://ecticket-stage.ecpay.com.tw` |

| 正式環境 | `https://ecticket.ecpay.com.tw` |

'IssueType'          => '4',     // 必填：4=純序號（不需先上架商品）     'Operator'           => 'System', // 必填：建立人員（限英數字）     'UseStatusNotifyURL' => 'https://你的網站/ecticket/notify',

'Operator'           => 'System', // 必填：建立人員（限英數字）     'UseStatusNotifyURL' => 'https://你的網站/ecticket/notify',     'TicketInfo'         => [

'UseStatusNotifyURL' => 'https://你的網站/ecticket/notify',

$curlService = $factory->create('JsonCurlService'); try {     $raw      = $curlService->run($outerJson, 'https://ecticket-stage.ecpay.com.tw/api/issuance/issue');

try {     $raw      = $curlService->run($outerJson, 'https://ecticket-stage.ecpay.com.tw/api/issuance/issue');     $response = json_decode($raw, true);

$raw      = $curlService->run($outerJson, 'https://ecticket-stage.ecpay.com.tw/api/issuance/issue');

]); try {     $raw      = $curlService->run($outerJson, 'https://ecticket-stage.ecpay.com.tw/api/Ticket/WriteOff');

try {     $raw      = $curlService->run($outerJson, 'https://ecticket-stage.ecpay.com.tw/api/Ticket/WriteOff');     $response = json_decode($raw, true);

$raw      = $curlService->run($outerJson, 'https://ecticket-stage.ecpay.com.tw/api/Ticket/WriteOff');

> - **ECTicket**使用簡化版（`urlencode` → `strtolower` 僅此兩步，**不做 .NET 特殊字元還原**） > > 詳見官方附錄：[檢查碼機制](https://developers.ecpay.com.tw/29998.md)。

> > 詳見官方附錄：[檢查碼機制](https://developers.ecpay.com.tw/29998.md)。 > 倉庫內 `scripts/SDK_PHP/example/Ecticket/README.md` 提供的是高階整合提醒；**⚠<U+FE0F> 注意：該 README 誤標 CheckMacValue 為「AIO 公式」，實際上ECTicket CMV 公式與 AIO 完全不同**（無排序、無 .NET 字元還原），正確公式以此處說明與 `test-vectors

> 詳見官方附錄：[檢查碼機制](https://developers.ecpay.com.tw/29998.md)。

// 5. 直接 POST（不透過 PostWithAesJsonResponseService，避免 Data 被二次加密） $curlService = $factory->create('JsonCurlService'); $raw         = $curlService->run(json_encode($input), 'https://ecticket-stage.ecpay.com.tw/api/issuance/issue');

$curlService = $factory->create('JsonCurlService'); $raw         = $curlService->run(json_encode($input), 'https://ecticket-stage.ecpay.com.tw/api/issuance/issue');                                                        // ⚠<U+FE0F> 端點依模式：價金保管 /ap

$raw         = $curlService->run(json_encode($input), 'https://ecticket-stage.ecpay.com.tw/api/issuance/issue');

const HASH_KEY = 'c539115ea7674f20'; const HASH_IV = '86f625e60cb1473a'; const BASE_URL = 'https://ecticket-stage.ecpay.com.tw';

const BASE_URL = 'https://ecticket-stage.ecpay.com.tw';

IssueType: '4',               // 必填：4=純序號（不需先上架商品）     Operator: 'System',           // 必填：建立人員（限英數字）     UseStatusNotifyURL: 'https://your-domain.com/ecticket/notify',

Operator: 'System',           // 必填：建立人員（限英數字）     UseStatusNotifyURL: 'https://your-domain.com/ecticket/notify',     TicketInfo: [

UseStatusNotifyURL: 'https://your-domain.com/ecticket/notify',

const res = await fetch(`${BASE_URL}/api/issuance/issue`, {

HASH_KEY = 'c539115ea7674f20' HASH_IV = '86f625e60cb1473a' BASE_URL = 'https://ecticket-stage.ecpay.com.tw'

BASE_URL = 'https://ecticket-stage.ecpay.com.tw'

'IssueType': '4',             # 必填：4=純序號（不需先上架商品）         'Operator': 'System',         # 必填：建立人員（限英數字）         'UseStatusNotifyURL': 'https://你的網站/ecticket/notify',

'Operator': 'System',         # 必填：建立人員（限英數字）         'UseStatusNotifyURL': 'https://你的網站/ecticket/notify',         'TicketInfo': [

'UseStatusNotifyURL': 'https://你的網站/ecticket/notify',

'CheckMacValue': calc_ecticket_cmv(data_json, HASH_KEY, HASH_IV),     }     resp = requests.post(f'{BASE_URL}/api/issuance/issue', json=payload)

}     resp = requests.post(f'{BASE_URL}/api/issuance/issue', json=payload)     result = resp.json()

resp = requests.post(f'{BASE_URL}/api/issuance/issue', json=payload)

'CheckMacValue': calc_ecticket_cmv(data_json, HASH_KEY, HASH_IV),     }     resp = requests.post(f'{BASE_URL}/api/Ticket/WriteOff', json=payload)

}     resp = requests.post(f'{BASE_URL}/api/Ticket/WriteOff', json=payload)     result = resp.json()

resp = requests.post(f'{BASE_URL}/api/Ticket/WriteOff', json=payload)

> ℹ<U+FE0F> 上述版本為官方文件最後驗證版本，模組可能持續更新支援更新的平台版本。最新版本請至 [ECPay 官網](https://www.ecpay.com.tw) 廠商專區 → 模組下載頁面確認。

1. 從 [ECPay 官網](https://www.ecpay.com.tw) → 廠商專區 → 模組下載，下載 WooCommerce 模組

> - 把金流帳號用於物流 → 呼叫物流 API 時回傳「MerchantID 不符」或 CheckMacValue 驗證失敗 > - 把物流/發票帳號用於金流 → 前台結帳出現 `10100248` 帳號錯誤或 CheckMacValue Error > - 三組帳號在 ECPay 後台 [廠商專區](https://vendor.ecpay.com.tw) 分別管理,測試階段可用 ECPay 提供的三組測試帳號(金流 3002607 / 發票 2000132 / 物流另行

> - 三組帳號在 ECPay 後台 [廠商專區](https://vendor.ecpay.com.tw) 分別管理,測試階段可用 ECPay 提供的三組測試帳號(金流 3002607 / 發票 2000132 / 物流另行申請)

> 僅需金流功能的商家可繼續使用 2.4.3。 > > ⚠<U+FE0F> **版本與套件名稱注意**：Magento 模組未包含在 `ecpay/sdk` 套件中，Composer 套件名稱（如 `ecpay/magento2-payment`）與支援版本**可能隨版本更新變動**，請以 [Packagist](https://packagist.org/) 及 [ECPay 官網](https://www.ecpay.com.tw) 廠商專區 → 模組下載頁面的最新資訊為準。

> ⚠<U+FE0F> **版本與套件名稱注意**：Magento 模組未包含在 `ecpay/sdk` 套件中，Composer 套件名稱（如 `ecpay/magento2-payment`）與支援版本**可能隨版本更新變動**，請以 [Packagist](https://packagist.org/) 及 [ECPay 官網](https://www.ecpay.com.tw) 廠商專區 → 模組下載頁面的最新資訊為準。

# ⚠<U+FE0F> 套件名稱可能隨版本變動,請至以下任一來源確認最新名稱:    #   - Packagist: https://packagist.org/ (搜尋 "ecpay")

#   - Packagist: https://packagist.org/ (搜尋 "ecpay")

#   - ECPay 官網: https://www.ecpay.com.tw 廠商專區 → 模組下載

- ECPay 模組更新時，建議先在測試環境驗證再更新正式環境 - 從 ECPay 測試環境切換到正式環境時，需在模組設定中更換帳號資訊 - 各平台模組的最新版本和更新日誌可在 [ECPay 官網](https://www.ecpay.com.tw) 廠商專區查看

- 各平台模組的最新版本和更新日誌可在 [ECPay 官網](https://www.ecpay.com.tw) 廠商專區查看

[Credential-related source omitted]

[Credential-related source omitted]

char* ecpay_url_encode(CURL *curl, const char *source) {

/* 4. ECPay URL encode */    /* curl_easy_init() 在資源不足時可能回傳 NULL */     CURL *curl = curl_easy_init();

/* curl_easy_init() 在資源不足時可能回傳 NULL */     CURL *curl = curl_easy_init();     if (!curl) { free(raw); return NULL; }

CURL *curl = curl_easy_init();

TradeDesc=測試   ItemName=測試商品   ReturnURL=https://example.com/notify

ItemName=測試商品   ReturnURL=https://example.com/notify   ChoosePayment=ALL

ReturnURL=https://example.com/notify

產生步驟： 1. 排序後組合：`HashKey=pwFHCqoQZGmho4w6&ChoosePayment=ALL&EncryptType=1&ItemName=測試商品&MerchantID=3002607&MerchantTradeDate=2025/01/01 12:00:00&MerchantTradeNo=Test1234567890&PaymentType=aio&ReturnURL=https://example.com/notify&TotalAmount=

1. 排序後組合：`HashKey=pwFHCqoQZGmho4w6&ChoosePayment=ALL&EncryptType=1&ItemName=測試商品&MerchantID=3002607&MerchantTradeDate=2025/01/01 12:00:00&MerchantTradeNo=Test1234567890&PaymentType=aio&ReturnURL=https://example.com/notify&TotalAmount=100&Tr

'TradeDesc': '測試',     'ItemName': '測試商品',     'ReturnURL': 'https://example.com/notify',

'ItemName': '測試商品',     'ReturnURL': 'https://example.com/notify',     'ChoosePayment': 'ALL',

'ReturnURL': 'https://example.com/notify',

encrypted = base64.b64decode(cipher_text)

byte[] encrypted = Convert.FromBase64String(cipherText);

> # Ubuntu/Debian: sudo apt install libssl-dev

/* 編譯：gcc -o aes aes.c -lssl -lcrypto -lcurl  * JSON 處理建議使用 cJSON: https://github.com/DaveGamble/cJSON */

* JSON 處理建議使用 cJSON: https://github.com/DaveGamble/cJSON */

char* ecpay_aes_encrypt(const char* json_str, const char* hash_key, const char* hash_iv) {     /* Step 1: URL encode */     CURL *curl = curl_easy_init();

/* Step 1: URL encode */     CURL *curl = curl_easy_init();     char *url_encoded = curl_easy_escape(curl, json_str, 0);

CURL *curl = curl_easy_init();

CURL *curl = curl_easy_init();

raw = base64.b64decode(b64)

byte[] raw = Convert.FromBase64String(encryptedB64);

**高優先度（最常見失敗原因）：** 1. **回應格式**：必須回應純字串 `1|OK`（不可有 HTML 標籤、BOM、換行、HTTP header 之外的內容） 2. **URL 格式**：必須是完整的 `https://` URL（不可是 http://，不可是 localhost）

1. **回應格式**：必須回應純字串 `1|OK`（不可有 HTML 標籤、BOM、換行、HTTP header 之外的內容） 2. **URL 格式**：必須是完整的 `https://` URL（不可是 http://，不可是 localhost） 3. **超時**：ReturnURL 必須在 **10 秒內**回應 `1|OK`；耗時邏輯需放入非同步佇列（見 [guides/22](./22-performance-scaling.md)）

2. **URL 格式**：必須是完整的 `https://` URL（不可是 http://，不可是 localhost）

└─ 【log 未出現】 → ReturnURL 未被呼叫，排查 URL 設定：        ├─ 是 localhost 或 127.0.0.1？→ 改用 ngrok 或公開主機        ├─ 是 http:// 而非 https://？→ 改用 https（自簽憑證會被拒）

├─ 是 localhost 或 127.0.0.1？→ 改用 ngrok 或公開主機        ├─ 是 http:// 而非 https://？→ 改用 https（自簽憑證會被拒）        ├─ Port 非 443？→ 改用 443（80 用 http）

├─ 是 http:// 而非 https://？→ 改用 https（自簽憑證會被拒）

raw = base64.b64decode(your_encrypted_b64)

// 後端解密 CreatePayment 回應後，回傳給前端 const result = await fetch('/your-backend/create-payment', { ... }).then(r => r.json());

const result = await fetch('/your-backend/create-payment', { ... }).then(r => r.json());

**所有步驟都確認後仍然無法成功？** 請至 [GitHub Issues](https://github.com/ECPay/ECPay-API-Skill/issues) 或聯繫 techsupport@ecpay.com.tw，提供：MerchantTradeNo、呼叫時間、完整的 request/response JSON（注意遮蔽 HashKey/HashIV）。

|---------|---------|---------| | URL 用 localhost | 檢查建單時 ReturnURL 值 | 改用 ngrok 或公開 URL | | ReturnURL 使用 HTTP 而非 HTTPS | 確認 ReturnURL 開頭是否為 `https://` | 改成 HTTPS URL，綠界不接受 HTTP |

| URL 用 localhost | 檢查建單時 ReturnURL 值 | 改用 ngrok 或公開 URL | | ReturnURL 使用 HTTP 而非 HTTPS | 確認 ReturnURL 開頭是否為 `https://` | 改成 HTTPS URL，綠界不接受 HTTP | | 路由不接受 POST | 用 curl 手動 POST 測試 | 確保路由允許 POST 方法 |

| ReturnURL 使用 HTTP 而非 HTTPS | 確認 ReturnURL 開頭是否為 `https://` | 改成 HTTPS URL，綠界不接受 HTTP | | 路由不接受 POST | 用 curl 手動 POST 測試 | 確保路由允許 POST 方法 | | 端點返回非 `1\|OK` | 查你的伺服器 log | 端點必須明確 echo '1\|OK' |

| 路由不接受 POST | 用 curl 手動 POST 測試 | 確保路由允許 POST 方法 |

1. 驗證 ReturnURL 可公開訪問：    curl -X POST https://你的domain/ecpay/callback -d "test=1"

curl -X POST https://你的domain/ecpay/callback -d "test=1"

| 1. 檢查 `ItemName` | 移除任何類似系統指令的關鍵字，僅使用實際商品名稱 | | 2. 檢查 `TradeDesc` | 同上，交易描述不可包含命令列關鍵字 | | 3. 避免除錯殘留 | 測試時常會在欄位中放入 `echo test` 或 `curl localhost` 等字串，上線前務必清除 |

| 3. 避免除錯殘留 | 測試時常會在欄位中放入 `echo test` 或 `curl localhost` 等字串，上線前務必清除 |

**ATM / CVS / BARCODE 付款無退款 API**，必須登入[綠界廠商後台](https://vendor.ecpay.com.tw)手動處理退款。

當 API 回傳異常時，用 curl 手動發送請求隔離問題：

# AIO 測試（CheckMacValue 需手動計算） curl -X POST https://payment-stage.ecpay.com.tw/Cashier/QueryTradeInfo/V5 \

curl -X POST https://payment-stage.ecpay.com.tw/Cashier/QueryTradeInfo/V5 \

# 站內付 2.0 測試（AES 加密後的 JSON） curl -X POST https://ecpg-stage.ecpay.com.tw/Merchant/GetTokenbyTrade \

curl -X POST https://ecpg-stage.ecpay.com.tw/Merchant/GetTokenbyTrade \

若 curl 可以成功但程式碼失敗，問題在你的 HTTP client 設定（如 Content-Type、TLS、timeout）。

curl -v --connect-timeout 10 https://payment.ecpay.com.tw

聯絡方式： - 一般技術支援信箱：techsupport@ecpay.com.tw（ECPay 技術支援部門，適用一般 API 串接問題） - Skill 問題回報：[GitHub Issues](https://github.com/ECPay/ECPay-API-Skill/issues)

- 一般技術支援信箱：techsupport@ecpay.com.tw（ECPay 技術支援部門，適用一般 API 串接問題） - Skill 問題回報：[GitHub Issues](https://github.com/ECPay/ECPay-API-Skill/issues) - 開發者文件：https://developers.ecpay.com.tw

- Skill 問題回報：[GitHub Issues](https://github.com/ECPay/ECPay-API-Skill/issues)

- 開發者文件：https://developers.ecpay.com.tw

$response = $sdk->post([...], 'https://ecpg-stage.ecpay.com.tw/...');

HASH_KEY    = 'pwFHCqoQZGmho4w6' HASH_IV     = 'EkRm7iFT261dpevs' ECPG_URL    = 'https://ecpg-stage.ecpay.com.tw'

ECPG_URL    = 'https://ecpg-stage.ecpay.com.tw'

ct     = base64.b64decode(b64)

'MerchantTradeNo': trade_no,         'TotalAmount': 100,         'ReturnURL': 'https://example.com',

'TotalAmount': 100,         'ReturnURL': 'https://example.com',         'TradeDesc': 'selfcheck',

'ReturnURL': 'https://example.com',

'CardInfo': {         // 'Redeem': 省略此選填欄位（傳字串 "N"/"Y" 會導致 5100011 錯誤）         'OrderResultURL': 'https://example.com',

// 'Redeem': 省略此選填欄位（傳字串 "N"/"Y" 會導致 5100011 錯誤）         'OrderResultURL': 'https://example.com',     },

'OrderResultURL': 'https://example.com',

endpoints = [     ('GetTokenbyTrade / CreatePayment', ECPG_URL, '正確：ecpg-stage'),     ('QueryTrade / DoAction',           'https://ecpayment-stage.ecpay.com.tw', '正確：ecpayment-stage'),

('GetTokenbyTrade / CreatePayment', ECPG_URL, '正確：ecpg-stage'),     ('QueryTrade / DoAction',           'https://ecpayment-stage.ecpay.com.tw', '正確：ecpayment-stage'), ]

('QueryTrade / DoAction',           'https://ecpayment-stage.ecpay.com.tw', '正確：ecpayment-stage'),

# 先確認本地伺服器在 localhost:5000 運行 # 模擬綠界送出的 ReturnURL JSON POST（Data 欄位需是真實 AES 加密值） curl -X POST http://localhost:5000/ecpay/callback \

# 模擬綠界送出的 ReturnURL JSON POST（Data 欄位需是真實 AES 加密值） curl -X POST http://localhost:5000/ecpay/callback \   -H "Content-Type: application/json" \

curl -X POST http://localhost:5000/ecpay/callback \

print(base64.b64encode(c.encrypt(pad(plain.encode(), 16))).decode()) " # 將輸出填入上方 curl 的 Data 欄位，然後執行 curl

" # 將輸出填入上方 curl 的 Data 欄位，然後執行 curl # 預期：你的 handler 印出「✅ 付款成功」並回應純文字 1|OK

# 將輸出填入上方 curl 的 Data 欄位，然後執行 curl

- [ ] **1. 測試→正式 URL 已全數切換**：所有 API 端點已從 `-stage` 切換到正式域名。站內付 2.0 注意**雙 Domain 都要切**（`ecpg-stage` → `ecpg`，`ecpayment-stage` → `ecpayment`），只切一個是最常見的上線漏洞 — **若未切換：API 打到測試環境，所有交易為模擬交易，不產生真實資金流動** - [ ] **2. HashKey/HashIV 已替換為正式環境值**：Mercha

- [ ] **2. HashKey/HashIV 已替換為正式環境值**：MerchantID、HashKey、HashIV 全部改為正式帳號（從[綠界商店後台](https://vendor.ecpay.com.tw)取得）— **若未替換：測試帳號的 HashKey 與正式帳號不同，所有 CheckMacValue / AES 驗證永遠失敗，交易全部拒絕**

> ⚠<U+FE0F> **SNAPSHOT 2026-03** | PCI DSS 規範可能隨版本更新，正式上線前請參照 [PCI Security Standards Council](https://www.pcisecuritystandards.org/) 最新版本。

| 3 | 外層 JSON 需包含 `CheckMacValue`（公式同 ECTicket，非 AIO）| | 4 | **ECPay 通知格式**（你收到的）：JSON POST，Data 欄位為 AES 加密 JSON，外層含 ECTicket 式 CheckMacValue（與ECTicket相同協議）。**你必須回應**：純文字 `1\|OK`（⚠<U+FE0F> 與ECTicket不同——ECTicket回應需 AES 加密 JSON + CheckMacValue）| | 5

| 5 | API 端點：`https://ecpayment.ecpay.com.tw/`（測試環境：`https://ecpayment-stage.ecpay.com.tw/`）（詳見 `references/Payment/直播主收款網址串接技術文件.md`）|

- [ ] 離線發票有**前置作業**：需先登錄 POS 機台、申請字軌、取得配號，才能離線開票（見下方「POS 前置設定流程」） - [ ] 依法規，發票開立後 **48 小時內**必須上傳至財政部；逾時須向國稅局說明 - [ ] ⚠<U+FE0F> 首次串接必讀：`references/Invoice/離線電子發票API技術文件.md` → **準備事項 / 介接注意事項**（`web_fetch` https://developers.ecpay.com.tw/13768.md）

- [ ] ⚠<U+FE0F> 首次串接必讀：`references/Invoice/離線電子發票API技術文件.md` → **準備事項 / 介接注意事項**（`web_fetch` https://developers.ecpay.com.tw/13768.md）

| 認證 | AES-128-CBC 加密 Data 欄位 — 詳見 [guides/14-aes-encryption.md](./14-aes-encryption.md) | | Revision | `1.0.0` | | 測試環境 | `https://einvoice-stage.ecpay.com.tw` |

| Revision | `1.0.0` | | 測試環境 | `https://einvoice-stage.ecpay.com.tw` | | 正式環境 | `https://einvoice.ecpay.com.tw` |

| 測試環境 | `https://einvoice-stage.ecpay.com.tw` |

| 正式環境 | `https://einvoice.ecpay.com.tw` |

[Credential-related source omitted]

], ]; $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/GetOfflineInvoiceWordSetting');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/GetOfflineInvoiceWordSetting');

], ]; $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/OfflineIssue');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/OfflineIssue');

], ]; $response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/OfflineInvalid');

$response = $postService->post($input, 'https://einvoice-stage.ecpay.com.tw/B2CInvoice/OfflineInvalid');

- **詳細規格**：`web_fetch` https://developers.ecpay.com.tw/45974.md

- **詳細規格**：`web_fetch` https://developers.ecpay.com.tw/13793.md

| 章節 | 說明 | URL | |------|------|-----| | 使用流程圖說明 | 離線發票完整作業流程示意 | https://developers.ecpay.com.tw/13758.md |

|------|------|-----| | 使用流程圖說明 | 離線發票完整作業流程示意 | https://developers.ecpay.com.tw/13758.md | | 準備事項 / 測試介接資訊 | ⚠<U+FE0F> **離線發票專用測試帳號**（MerchantID 3085340） | https://developers.ecpay.com.tw/13763.md |

| 使用流程圖說明 | 離線發票完整作業流程示意 | https://developers.ecpay.com.tw/13758.md |

| 準備事項 / 測試介接資訊 | ⚠<U+FE0F> **離線發票專用測試帳號**（MerchantID 3085340） | https://developers.ecpay.com.tw/13763.md |

| 準備事項 / 介接注意事項 | ⚠<U+FE0F> **首次串接必讀**，POS 開發限制與注意事項 | https://developers.ecpay.com.tw/13768.md |

| 前置作業 / 查詢特店基本資料 | 查詢特店名稱與統一編號 | https://developers.ecpay.com.tw/13773.md |

| 前置作業 / 查詢財政部配號結果 | 確認財政部是否已核准字軌配號 | https://developers.ecpay.com.tw/13778.md |

| 前置作業 / 管理發票機台 | POS 機台登錄（新增/修改/刪除） | https://developers.ecpay.com.tw/13783.md |

| 前置作業 / 字軌與配號設定 | 向財政部申請字軌 | https://developers.ecpay.com.tw/13788.md |

| 前置作業 / 設定字軌號碼狀態 | 停用/暫停/啟用字軌 | https://developers.ecpay.com.tw/13793.md |

| 前置作業 / 取得字軌號碼區間 | 查詢可用字軌數字範圍（確認庫存用） | https://developers.ecpay.com.tw/13795.md |

| 前置作業 / 取得字軌號碼清單 | 含隨機碼、加密資料，實際開票用 | https://developers.ecpay.com.tw/15502.md |

| 發送通知 / 發送發票通知 | 補送開立發票通知給消費者 | https://developers.ecpay.com.tw/45974.md |

| 發票作業 / 上傳開立發票 | 上傳離線開立的發票至綠界 | https://developers.ecpay.com.tw/13823.md |

| 發票作業 / 上傳作廢發票 | 上傳作廢發票資料至綠界 | https://developers.ecpay.com.tw/13828.md |

| 發票查詢 / 查詢發票機台 | 查詢已登錄的 POS 機台清單 | https://developers.ecpay.com.tw/13833.md |

| 發票查詢 / 查詢字軌 | 查詢已申請的字軌資訊 | https://developers.ecpay.com.tw/13843.md |

| 附錄 / 錯誤代碼一覽表 | 離線發票錯誤碼查詢 | https://developers.ecpay.com.tw/13853.md |

| 附錄 / 電子發票列印格式說明 | ⚠<U+FE0F> **POS 列印格式規範（實體收銀機必讀）** | https://developers.ecpay.com.tw/31732.md |

| 附錄 / 參數加密方式說明 | AES-128-CBC 加密詳細說明 | https://developers.ecpay.com.tw/13863.md |

| Accept | `text/html` | | 認證方式 | CheckMacValue 欄位（SHA256 雜湊） | | 正式環境 | `https://payment.ecpay.com.tw` |

| 認證方式 | CheckMacValue 欄位（SHA256 雜湊） | | 正式環境 | `https://payment.ecpay.com.tw` | | 測試環境 | `https://payment-stage.ecpay.com.tw` |

| 正式環境 | `https://payment.ecpay.com.tw` |

| 測試環境 | `https://payment-stage.ecpay.com.tw` |

> ⚠<U+FE0F> B2C 發票的 `AllowanceByCollegiate` 是電子發票中唯一帶有 CheckMacValue 的 API。其 ReturnURL Callback 使用 Form POST + CheckMacValue（**MD5**，非 SHA256），格式同 AIO 金流但雜湊演算法不同。詳見 [guides/04](./04-invoice-b2c.md) 及[檢查碼機制](https://developers.ecpay.com.tw/38242.md

| Content-Type | `application/json` | | 認證方式 | AES-128-CBC 加密 Data 欄位 + CheckMacValue（SHA256） | | 正式環境 | `https://ecticket.ecpay.com.tw` |

| 認證方式 | AES-128-CBC 加密 Data 欄位 + CheckMacValue（SHA256） | | 正式環境 | `https://ecticket.ecpay.com.tw` | | 測試環境 | `https://ecticket-stage.ecpay.com.tw` |

| 正式環境 | `https://ecticket.ecpay.com.tw` |

| 測試環境 | `https://ecticket-stage.ecpay.com.tw` |

| Content-Type | `application/x-www-form-urlencoded` | | 認證方式 | CheckMacValue 欄位（**MD5** 雜湊，非 SHA256） | | 正式環境 | `https://logistics.ecpay.com.tw` |

| 認證方式 | CheckMacValue 欄位（**MD5** 雜湊，非 SHA256） | | 正式環境 | `https://logistics.ecpay.com.tw` | | 測試環境 | `https://logistics-stage.ecpay.com.tw` |

| 正式環境 | `https://logistics.ecpay.com.tw` |

| 測試環境 | `https://logistics-stage.ecpay.com.tw` |

> Base URL（測試）：`https://payment-stage.ecpay.com.tw`

> Base URL（正式）：`https://payment.ecpay.com.tw`

> Base URL（測試）：`https://vendor-stage.ecpay.com.tw`

> Base URL（正式）：`https://vendor.ecpay.com.tw`

> ecpg Base URL（測試）：`https://ecpg-stage.ecpay.com.tw`

> ecpayment Base URL（測試）：`https://ecpayment-stage.ecpay.com.tw`

> Base URL（測試）：`https://ecpayment-stage.ecpay.com.tw`

> Base URL（正式）：`https://ecpayment.ecpay.com.tw`

> Base URL（測試）：`https://einvoice-stage.ecpay.com.tw`

> Base URL（正式）：`https://einvoice.ecpay.com.tw`