統一金流整合指南
你的任務是幫助用戶設定統一金流(PAYUNi)環境並引導至適當的串接功能。
用戶需求分析
用戶輸入: $ARGUMENTS
根據用戶需求，判斷下一步：
-
若包含「串接」「checkout」「建立交易」「UPP」→ 引導使用 /payuni-checkout
-
若包含「查詢」「query」「訂單狀態」→ 引導使用 /payuni-query
-
若包含「webhook」「回調」「通知」→ 引導使用 /payuni-webhook
-
若無特定指定 → 提供以下環境設定引導
環境設定檢查
詢問用戶以下問題：
專案框架：你使用什麼框架？
-
PHP (Laravel / 原生 PHP / 其他)
-
Node.js (Express / Next.js / NestJS / 其他)
-
Python (Django / Flask / FastAPI / 其他)
-
其他
環境狀態：是否已有統一金流商店帳號？
-
是，已有測試環境帳號
-
是，已有正式環境帳號
-
否，需要申請
環境變數設定
引導用戶建立環境變數：
PAYUNI_MERCHANT_ID=你的商店代號 PAYUNI_HASH_KEY=你的HashKey PAYUNI_HASH_IV=你的HashIV PAYUNI_TEST_MODE=true # test 模式，正式環境設為 false
指導用戶:
-
在專案根目錄建立或編輯 .env 檔案
-
加入上述環境變數
-
確保 .env 已加入 .gitignore
下一步
完成環境設定後，根據用戶需求引導：
需求 Skill 說明
建立支付頁面 /payuni-checkout
UPP 幕前支付串接
查詢交易狀態 /payuni-query
交易查詢 API
處理 Webhook /payuni-webhook
接收付款通知
環境資訊
環境 API Base URL
測試 https://sandbox-api.payuni.com.tw
支援的支付方式
-
信用卡: 一次付清、分期付款
-
行動支付: LINE Pay、Apple Pay、Google Pay
-
ATM: WebATM、ATM 轉帳
-
超商: 代碼繳費、條碼繳費
重要注意事項
-
HashKey 和 HashIV 必須保密，不可暴露在前端
-
PAYUNi 使用 AES-256-CBC 加密
-
訂單編號不可重複
-
NotifyURL/ReturnURL 必須是 HTTPS（正式環境）
-
Webhook 需驗證簽名防止偽造
與其他金流比較
特性 PAYUNi 藍新 綠界
加密方式 AES-256-CBC AES-256-CBC AES-128-CBC
簽章方式 SHA256 (HashInfo) SHA256 (TradeSha) SHA256 (CheckMacValue)
API 版本 統一版本 Version 參數 Version 參數