← 網站製作

從購物車到真的收到款項

形象網站可以完全不啟用金流。有商品才開啟商品管理。可選綠界託管結帳，或設定 TapPay 本站安全刷卡。留白不保存卡號。

1. 申請收款帳號

到綠界官網申請符合你實際身分及營業內容的收款服務。可申請的方案、文件、費率與審核結果由綠界決定。取得 MerchantID、HashKey、HashIV 後，只填入伺服器環境變數，不要貼在網頁、GitHub 或提示詞。

2. 先使用測試環境

依官方測試資料設定測試特店。測試信用卡不會收到真實款項。本站必須有可供綠界通知的公開 HTTPS 網址；localhost 無法接到綠界通知。

ECPAY_MODE=sandbox
ECPAY_MERCHANT_ID=測試特店編號
ECPAY_HASH_KEY=測試 HashKey
ECPAY_HASH_IV=測試 HashIV
COMMERCE_PUBLIC_ORIGIN=https://你的金流網站網域
COMMERCE_DB_PATH=/持久化磁碟/commerce.sqlite

這些由建置者在後端設定。商品管理可先在本機使用；本機 preview.py 不是可直接公開的商店後台。靜態 HTML／GitHub Pages 也無法執行金流後端。正式架設需使用持續可用的後端與資料庫，並保護商品和訂單管理登入。

3. 建立商品並驗收

  1. 輸入名稱、新台幣整數單價與可售庫存，儲存商品。
  2. 開啟購物車，選擇數量。送單時後端會依商品資料重新計價。
  3. 完成測試結帳，確認訂單收到經過簽章驗證的付款通知。回到網站本身不代表付款成功。
  4. 確認重複通知不會重複扣庫存；失敗、返回、取消與庫存不足都有正確狀態。
  5. 後台模擬通知不會被當成實際付款。測試模式成功會清楚標成「測試付款成功」。

4. 正式切換與交付

綠界核准後，換成你自己的正式特店資料及 ECPAY_MODE=live；使用公開測試特店無法切換正式模式。先完成一筆你授權的小額交易與退款對帳，再交付客戶使用。未完成這個驗收，不能宣稱金流已正式接通。

交付應包括網域與憑證、管理者帳號、持久化資料庫、備份還原、交易紀錄、金鑰輪替方式、付款與取消說明，以及平台交易費用與主機費用。一次性建置不代表第三方服務終身免費。

訂單與庫存如何處理

建立訂單會保留庫存。付款未完成時保留待確認狀態，管理者先到綠界查核，再取消並釋放庫存。取消後延遲收到款項會進入人工查核，不自動出貨。已付款訂單可在設定正式信用卡查詢資料後，於管理頁明確申請退款；已接受或結果不明的請求需查核後結案，不能直接重送或刪除本機紀錄。退款也不會自動回補庫存。

退款、物流與發票啟用

三項服務各有商家資格與秘密設定。正式信用卡退款需商家檢查碼，而且綠界沒有可用的退款 sandbox；切勿把程式測試當成真實退刷驗收。物流需寄件人資訊及公開通知網址；電子發票需獨立金鑰、字軌與配號。技術設定請依專案 commerce/DEPLOY.md，由建置者在主機秘密管理中完成，不要把金鑰貼進網站。

目前範圍

支援單一商家、單一商品規格、信用卡託管結帳、購物車、伺服器計價、庫存保留、簽章通知、訂單查詢與取消。可保存收件與發票資料、由服務端計算固定宅配費、登記實際交付。已提供正式信用卡退款／查詢、一般含稅B2C電子發票開立／查詢，以及綠界黑貓常溫不代收款的宅配建單／查詢／貨態通知。這些都需獨立商家設定與外部驗收；建單不等於已出貨，退款接受不等於已入帳。公司發票需手機載具。發票作廢／折讓、逆物流、超商取貨、定期訂閱與多商家分帳未實作，退款後發票需至綠界另行處理。

官方依據：建立訂單、檢查碼、付款通知。

想留在自己的網站刷卡？

可以。本站已加入 TapPay 官方安全欄位，開通並設定後，買家可在本頁填卡；卡號與安全碼不經過留白伺服器。銀行若要求3D驗證，仍會跳到驗證頁再返回。Portaly不是必須使用的服務。

  1. 到 TapPay 官網申請帳號、收單商家及網站網域；資格、費率由金流審核。
  2. 向寄信服務取得 SMTP 主機、帳號、密鑰及寄件信箱，完成寄件網域驗證。
  3. 由建置者在後端專案執行下方設定工具。密鑰採隱藏輸入，只存專案外的私有檔案，不要貼進聊天室。
  4. 部署公開HTTPS後，載入設定並啟動網站與背景工作者。
  5. 先用自己的營運信箱收驗收信，再做 sandbox 測試；最後由你親自完成正式小額付款及退款驗收。
python -m commerce.service_setup
python -m commerce.service_setup --check
python -m commerce.service_setup --test-mail 你的營運信箱
python -m commerce.worker

工作者需在主機持續執行，負責寄信、付款反查與追蹤資料清理。SMTP尚未設定時，買家登入與交付信不能使用；TapPay尚未設定時不會出現刷卡欄位。TapPay退款需先在官方後台操作，本網站會查詢並停止退款訂單下載。

廣告來源與購買轉換

宣傳商店時，可在連結加入 &utm_source=instagram&utm_medium=social&utm_campaign=launch。活動代碼使用英數、底線或連字號，不放姓名、Email等個資。只有買家主動同意後才記錄；管理頁可查看近30天造訪、訂單、正式成交及轉換率。取消同意會移除本次追蹤關聯，不影響購買。此功能不會把客戶資訊傳給Meta或Google。