TapPay

目標:做一個本機優先的金流整合測試台,模擬 TapPay 付款流程並集中管理訂單與 Webhook,不得處理真實卡號或正式交易。 技術棧建議:Python FastAPI + SQLite + 原生 HTML/CSS/JavaScript,以 Docker Compose 啟動本機服務。 需求: - 建立訂單資料表,記錄訂單編號、金額、幣別、商品摘要與建立時間 - 提供建立付款請求 API,回傳本機測試用付款頁網址 - 測試付款頁提供成功、失敗、取消與逾時四種結果 - 訂單狀態支援 created、pending、paid、failed、cancelled、refunded - 實作簽章產生與驗證模組,使用環境變數保存測試金鑰 - 提供 Webhook 接收端點,驗證簽章後更新訂單狀態 - Webhook 重送時必須具備冪等處理,避免重複更新或重複退款 - 管理頁可依訂單編號、狀態與日期篩選,查看完整事件紀錄 - 提供退款模擬 API,只允許已付款訂單進入 refunded 狀態 - 顯示交易事件時間軸與原始測試 payload,敏感欄位必須遮罩 - 支援訂單與事件資料匯出為 CSV 與 JSON - 在 README 清楚標示正式環境不得自行儲存卡號、CVV 或其他卡片敏感資料 明確不做(out of scope):真實信用卡收款、TapPay 正式金流繞接、卡號與 CVV 儲存、PCI DSS 認證、銀行清算、超商代碼產生、爭議款處理與正式環境部署。 README 要求:說明本工具只供沙盒測試、列出啟動與測試步驟、環境變數、Webhook 簽章規則、訂單狀態轉移、資料匯出方式與正式串接前的合規檢查清單。