🔷 OHIYOYO 藍新測試商戶申請指引

📌 目前狀態

藍新金流後端已串接完成並部署（建單 / Notify 入帳 / 結果頁），加密規格已與藍新測試閘道驗證互通。藍新 沒有公開固定的測試商戶，需在測試平台免費註冊一個「測試商店」（資料 30 天有效），拿到商戶專屬金鑰後交給助手設定，即可完成完整付款閉環測試。

一、註冊藍新測試平台（免費，約 5 分鐘）

1. 手機或電腦開啟測試平台：https://cwww.newebpay.com/
2. 點右上角「註冊」，填寫資料完成註冊（Email 收驗證信，測試資料自註冊日起有效 30 天）。
3. 登入後依平台導引「建立測試商店」。

二、啟用信用卡支付

1. 測試平台 → 會員中心 → 商店管理 / 商店資料設定 → 「詳細資料」。
2. 在「信用卡一次付清」欄位點「申請啟用」——測試環境會自動開通（正式環境才需審核）。
3. 預設已啟用 WebATM / ATM 轉帳 / 超商代碼 / 條碼繳費；信用卡需手動申請啟用。

三、取得串接金鑰

1. 測試平台 → 會員中心 → 商店管理 / 商店資料設定 → 「詳細資料」。
2. 在「API 串接金鑰」區塊複製三項參數：MerchantID（商店代號）、HashKey（32 字元）、HashIV（16 字元）。
3. 把這三項交給助手（可直接貼在對話），助手會設定為 Worker secret 並完成閉環測試。

四、設定金鑰（助手會做，也可自行確認）

cd D:\光幀AI-圖生影片\deploy
npx wrangler secret put NEWEBPAY_MERCHANT_ID   # 測試商店代號
npx wrangler secret put NEWEBPAY_HASH_KEY      # 32 字元 HashKey
npx wrangler secret put NEWEBPAY_HASH_IV       # 16 字元 HashIV
npx wrangler deploy

也可用 Cloudflare Web 介面：Workers → ohiyoyo-api → Settings → Variables and Secrets。

五、測試付款（閉環驗證）

• 閉環路徑：儲值中心選藍新 → 藍新付款頁 → 填測試卡 → 付款成功 → 後端驗證入帳 → 回站 ?paid=ok 且點數自動增加。
• 測試環境刷的是模擬授權，不會真的扣款。

六、正式環境（未來上線）

• 正式商戶申請：藍新官網 https://www.newebpay.com 註冊會員並建立商店（個人／公司皆可，無實體門市要求），信用卡需人工審核開通。
• 正式付款閘道：https://core.newebpay.com/MPG/mpg_gateway（後端已內建，換正式金鑰＋NEWEBPAY_PAY_URL 即可）。
• 藍新費率（參考）：信用卡約 2.3%–2.75%／筆，以藍新正式報價為準。