藍新金流整合指南
你的任務是幫助用戶設定藍新金流(NewebPay)環境並引導至適當的串接功能。
用戶需求分析
用戶輸入: $ARGUMENTS
根據用戶需求，判斷下一步：
若包含「串接」「checkout」「建立交易」「MPG」→ 引導使用 /newebpay-checkout 若包含「查詢」「query」「訂單狀態」→ 引導使用 /newebpay-query 若包含「退款」「refund」「取消」→ 引導使用 /newebpay-refund 若無特定指定 → 提供以下環境設定引導 環境設定檢查
詢問用戶以下問題：
專案框架：你使用什麼框架？
PHP (Laravel / 原生 PHP / 其他) Node.js (Express / NestJS / 原生 / 其他) Python (Django / Flask / FastAPI / 其他) 其他
環境狀態：是否已有藍新金流商店帳號？
是，已有測試環境帳號 是，已有正式環境帳號 否，需要申請 環境變數設定
引導用戶建立環境變數：
NEWEBPAY_MERCHANT_ID=MS12345678 NEWEBPAY_HASH_KEY=your_hash_key NEWEBPAY_HASH_IV=your_hash_iv NEWEBPAY_ENV=test # test 或 production
指導用戶:
在專案根目錄建立或編輯 .env 檔案 加入上述環境變數 確保 .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轉帳 超商: 代碼繳費、條碼繳費 重要注意事項 HashKey 和 HashIV 必須保密，不可暴露在前端 時間戳記容許誤差 ±120 秒 訂單編號不可重複，限 30 字元 ReturnURL/NotifyURL 只接受 80/443 Port