綠界科技 ECPay

目標:做一個本機優先的 ECPay 金流整合測試台，模擬建立訂單、付款回傳、退款與對帳，不取代正式金流服務。 技術棧建議:Python FastAPI + SQLite + Jinja2/原生 JavaScript，使用 Adapter 設計同時支援本機 Mock 與 ECPay Sandbox API。 需求: - 建立訂單資料表，保存訂單編號、商品、金額、新台幣幣別、狀態與建立時間 - 產生 ECPay Checkout 所需欄位與檢查碼，將測試表單送往 Sandbox - 提供本機 Mock 付款頁，可選擇成功、失敗、逾時與取消結果 - 實作付款結果回傳端點，驗證 CheckMacValue 後更新訂單狀態 - 實作前端 ReturnURL 與後端 OrderResultURL 的處理流程 - Webhook 必須具備冪等性，同一筆回傳重送不可重複更新或重複記帳 - 支援退款申請、退款狀態與退款原因欄位，正式退款預設關閉 - 管理頁可依日期、訂單狀態與訂單編號搜尋交易 - 顯示交易明細、付款方式、回傳原文與檢查碼驗證結果 - 匯出訂單、付款事件與退款紀錄為 CSV 與 JSON - 提供每日交易彙總與已付款、退款、失敗金額的對帳報表 - 所有 API 金鑰與商店代號從環境變數讀取，畫面不得顯示完整密鑰 明確不做(out of scope):不自行處理真實信用卡資料、不繞過 ECPay 介接、不實作正式代收款資格、不保存卡號或安全碼、不保證正式環境合規、不支援多商店權限。 README 要求:說明本機 Mock 與 ECPay Sandbox 的差異、環境變數、Sandbox 設定、Webhook 測試方式、訂單狀態機、資料庫備份匯出與正式上線前的合規檢查清單。