💎 OHIYOYO 綠界特店申請指引

📌 目前狀態

兩站已用 綠界測試商戶 完整串通（建單→付款頁→入帳→扣點閉環已驗證）。申請正式特店後，依下方第四節換置正式金鑰即可上線收款。

一、申請前準備

• 收款帳戶：一般銀行帳戶即可（綠界會做帳戶驗證）。
• 金流費率（參考）：信用卡約 2.45%–2.75%／筆，另有 ATM、超商代收等低費率管道；以綠界實際報價單為準。
• 需一組負責人手機門號（收驗證簡訊）與常用 Email（收特店通知）。

二、申請流程（約 15–20 分鐘）

1. 開啟綠界官網：https://www.ecpay.com.tw → 右上「免費申請」／「成為特店」。
2. 選擇「個人」或「公司/商號」，填寫基本資料（名稱、統一編號／身份證字號、聯絡資訊、收款帳戶）。
3. 上傳證件影像（身份證正反面／登記證明）＋帳戶影本。
4. 完成手機簡訊與 Email 驗證。
5. 送出申請後，綠界審核約 1–3 個工作天，結果以 Email 通知。
6. 審核通過後登入 ECPay 廠商後台（https://vendor.ecpay.com.tw），即取得正式特店身分。

三、取得串接金鑰（正式）

1. 登入 ECPay 廠商後台 → 左側「系統開發管理」→「廠商基本資料」。
2. 在「金鑰」區塊取得三項參數：MerchantID（7 位數字）、HashKey（32 字元）、HashIV（16 字元）。
3. 設定「IP／網域白名單」，把兩站加入付款結果通知白名單：
   https://ohiyoyo.pages.dev
https://ohiyoyo-one.pages.dev
https://ohiyoyo-api.ohiyoyo.workers.dev
4. 付款頁正式網址：https://payment.ecpay.com.tw/Cashier/AioCheckOut/V6（已內建於後端程式）。

四、換置正式金鑰（程式不用改）

在本機專案目錄執行（Cloudflare Worker secret）：

cd D:\光幀AI-圖生影片\deploy
npx wrangler secret put ECPAY_MERCHANT_ID    # 正式 MerchantID
npx wrangler secret put ECPAY_HASH_KEY       # 正式 HashKey
npx wrangler secret put ECPAY_HASH_IV        # 正式 HashIV
npx wrangler secret put ECPAY_PAY_URL        # https://payment.ecpay.com.tw/Cashier/AioCheckOut/V6
npx wrangler deploy

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

五、上線前檢查清單

• 正式金鑰已設定，舊測試金鑰已移除
• 付款頁 URL 為正式 payment.ecpay.com.tw（非 payment-stage）
• 綠界後台已設定付款結果通知網域白名單
• 用真實信用卡刷一筆最小方案（如 NT$519），確認付款後回站 ?paid=ok 且點數自動入帳
• 未付款／取消流程點數不增加
• 點數用到 0 時生成入口跳出「點數不足，請先儲值」並開啟儲值中心

六、收費規則（兩站現行）

• 每次生成扣 1 點；新用戶註冊送 10 點 體驗。
• 點數永不失效；付款由綠界處理（信用卡／ATM／超商代收）。

七、稅務提醒

• 綠界每期結算開立手續費發票；販售收入屬營業所得，個人請併入年度所得申報。
• 點數屬「預收款」性質，建議在網站條款註明退費窗口。