newebpaylisted

# 藍新金流整合指南 你的任務是幫助用戶設定藍新金流(NewebPay)環境並引導至適當的串接功能。 ## 用戶需求分析 用戶���入: `$ARGUMENTS` 根據用戶需求，判斷下一步： - 若包含「串接」「checkout」「建立交易」「MPG」→ 引導使用 `/newebpay-checkout` - 若包含「查詢」「query」「訂單狀態」→ 引導使用 `/newebpay-query` - 若包含「退款」「refund」「取消」→ 引導使用 `/newebpay-refund` - 若無特定指定 → 提供以下環境設定引導 ## 環境設定檢�� 詢問用戶以下問題： 1. **專案框架**：你使用什麼框架？ - PHP (Laravel / 原生 PHP / 其他) - Node.js (Express / NestJS / 原生 / 其他) - Python (Django / Flask / FastAPI / 其他) - 其他 2. **環境狀態**：是否已有藍新金流商店帳號？ - 是，已有測試環境帳號 - 是，已有正式環境帳號 - 否，需要申請 ## 環境變數設定 引導用戶建立環境變數： ```bash NEWEBPAY_MERCHANT_ID=MS12345678 NEWEBPAY_HASH_KEY=your_hash_key NEWEBPAY_HASH_IV=your_hash_iv NEWEBPAY_ENV=test # test 或 production ``` **指導用戶:** 1. 在專案根目錄建立或編輯 `.env` 檔案 2. 加入上述環境變數 3. 確保 `.env` 已加入 `.gitignore` ## 下一步 完成環境設定後，根據用戶需求引導： | 需求 | Skill | 說明 | |------|-------|------| | 建立支付頁面 | `/newebpay-checkout` | MPG 幕前支付串接 | | 查詢交易狀態 | `/newebpay-query` | 交易查詢 API | | 處理退款 | `/newebpay-refund` | 信用卡/電子錢包退款 | ## 環境資訊 | 環境 | API Base URL | |------|--------------| | 測試 | `https://ccore.newebpay.com` | | 正式 | `https://core.newebpay.com` | ## 支援的支付方式 - **信用卡**: 一次付清、分期付款、紅利折抵 - **行動支付**: Apple Pay、Google Pay、Samsung Pay - **電子錢包**: LINE Pay、台灣Pay、TWQR - **ATM**: WebATM、ATM轉帳 - **超商**: 代碼繳費、條碼繳費 ## 重要注意事項 1. HashKey 和 HashIV 必須保密，不可暴露在前端 2. 時間戳記容許誤差 ±120 秒 3. 訂單編號不可重複，限 30 字元 4. ReturnURL/NotifyURL 只接受 80/443 Port