Payment

• Checkout 路由：app/api/linepay/checkout/route.ts
• Confirm 路由：app/api/linepay/confirm/route.ts
• 功能：LINE 支付發起與確認流程
• 集成：LINE 支付服務庫 (lib/linepay.ts)

結帳流程

文件：app/pricing/checkout/page.tsx

支援功能：

• 多付款方式選擇（PayPal、Stripe、LINE Pay）
• 實時訂單預覽與金額計算
• 交易流程管理（pending → processing → completed/failed）
• 錯誤處理與用戶提示

開發檢查清單

• 新增支付方式時，確保 webhook endpoint 已註冊
• Webhook 簽名驗證應該優先執行（防止假冒請求）
• 交易狀態變更應該原子操作（避免 double charge）
• 退款流程應該記錄完整日誌
• 測試各支付閘道的沙箱環境
• 定價資料初始化（scripts/init-pricing-data.mjs）
• 定價資料合併（scripts/merge-pricing-data.mjs）
• 環境變數確認：PAYPAL_CLIENT_ID、STRIPE_SECRET_KEY、LINEPAY_API_KEY 等

Commit 模板

使用 Conventional Commits 類型：

• feat(payment): 新增支付功能
• fix(payment): 修正支付流程或 webhook 錯誤
• chore(payment): 支付相關配置/依賴更新
• refactor(payment): 支付代碼重構

Commit 範例：

feat(payment): add LINE Pay integration with checkout and confirm flows

- 新增 LINE Pay API 整合（checkout/confirm routes）
- 實作 LINE Pay 服務庫 (lib/linepay.ts)
- 更新結帳頁面支援 LINE Pay 選項
- 補充定價資料初始化和合併腳本

相關環境變數：LINEPAY_API_KEY, LINEPAY_MERCHANT_ID

PR 描述建議

• Summary：一句話說明新增/修正的支付功能
• Testing：沙箱環境測試結果（金額、退款、webhook 驗證等）
• Security：確認 webhook 簽名驗證已實現
• Breaking Changes：是否影響現有交易流程

相關文件結構

app/api/
├── paypal/
│   ├── webhook/route.ts
│   └── capture-order/route.ts
├── stripe/
│   ├── webhook/route.ts
│   └── ... (其他 Stripe 路由)
└── linepay/
    ├── checkout/route.ts
    └── confirm/route.ts

app/pricing/
└── checkout/page.tsx

lib/
├── linepay.ts            # LINE Pay 服務庫
└── types/                # 支付相關類型定義

scripts/
├── init-pricing-data.mjs    # 定價資料初始化
└── merge-pricing-data.mjs   # 定價資料合併

環境驗證 (Environment Validation)

1. 必要環境變數 (Required Environment Variables)

• .env.local 必須包含 PAYPAL_CLIENT_ID / PAYPAL_CLIENT_SECRET
• .env.local 必須包含 STRIPE_SECRET_KEY / STRIPE_WEBHOOK_SECRET
• .env.local 必須包含 LINEPAY_API_KEY / LINEPAY_MERCHANT_ID

2. 必要驗證檔案 (Required Validation Files)

• scripts/init-pricing-data.mjs (定價資料初始化)
• lib/linepay.ts (支付邏輯實作)

3. 執行驗證指令 (Validation Command)

• 目前以手動驗證沙箱環境為主