代理推廣

路徑：/admin/merchants/promo  |  快捷鍵：5 → ]  |  選單位置：商戶管理 → 代理推廣

站點限定

此功能僅在特定站點啟用，需與管理員接洽啟用。

代理推廣功能提供推廣碼與建站申請管理。代理商可透過推廣連結提交建站申請，系統管理員在此頁面審核申請並進行一鍵建站。

頁面頂部

項目	說明
統計期間	「本月代收」「本月代付」「本月系統費」三欄的統計區間，附今天／昨天／本週／本月快捷按鈕；預設為本月（1 號至今天）
狀態篩選	可篩選：全部 / PENDING / RECEIVED / COMPLETED / 營運中 / 已關站 / REJECTED
查詢	依目前的統計期間與狀態重新載入申請列表與本站列的數字
管理推廣連結	開啟推廣連結管理視窗，按鈕上的數字為目前的連結條數（見下方）。它不是篩選條件，因此以分隔線與左邊的篩選項隔開

「統計期間」只影響上述三欄。系統餘額不隨它變動 —— 那是帳上當下的預付款餘額，不是區間統計，欄位標題旁有提示說明。費率欄顯示的也一律是目前生效的費率，不是所選期間當時的費率。

管理推廣連結

一個站點可以建立多條推廣連結，各自記錄不同的抽佣費率，供不同代理或通路使用，方便日後追溯每條通路當初談定的條件。

欄位	說明
標示	這條連結給誰用（僅後台可見，例如通路名稱）
費率	這條通路談定的抽佣費率，單位為千分之；留空代表不指定。僅作為後台記錄，不會顯示給代理商
推廣連結	完整網址，可一鍵複製後交給代理商
申請數	透過這條連結送出的建站申請筆數
啟用	關閉後該連結失效，但已產生的申請記錄仍可追溯
操作	刪除連結

修改標示或費率後離開輸入框即自動儲存。

已有申請的連結只能停用，不能刪除

連結一旦有申請關聯就無法刪除（刪除按鈕會停用），否則那些申請單會查不到當初報給對方的費率。不想再使用時請改為停用。

申請列表

欄位	說明
ID	申請流水號
站名	代理商填寫的站名
Telegram 聯繫方式	代理商的 Telegram 聯繫資訊
說明	申請備註說明
狀態	申請狀態標籤（PENDING / RECEIVED / COMPLETED / 營運中 / 已關站 / REJECTED）
網域	前台網域與後端網域（.net）。前台顯示的是實際買到的頂級域 —— .com 買不到時會是 .cc 或 .org（見前台網域買不到 .com 時）
代收費率	代收手續費比例（分子/分母格式）
代付費率	代付手續費比例（分子/分母格式）
本月代收	該承租站點本月的代收總額，下方小字為依代收費率計算的應收費用
本月代付	該承租站點本月的代付總額，下方小字為依代付費率計算的應收費用
本月系統費	本月實際抽佣 / 保底費用。分子為代收費用 + 代付費用，分母為該站的每月保底
系統餘額	該承租站點的預付款餘額，餘額為負時以紅字顯示；下方為「扣費後」試算與加值、異動紀錄按鈕
備註	管理員備註
建立時間	申請提交時間
操作	狀態更新按鈕

「本月代收」「本月代付」預設的統計區間為台灣時間當月 1 號 00:00 起至下月 1 號 00:00，可用頁面頂部的「統計期間」改成任意區間：代收計入付款成功與已結算的訂單（以付款時間認列），代付計入成功的代付訂單。尚未建站完成、或暫時連不上該承租站點時顯示 -（不是 0），避免把「查不到」誤看成零交易。

若某個承租站點的版本較舊、還不支援指定期間，該列的代收欄會出現「非所選期間」標記 —— 表示那一格顯示的仍是當月數字，不是你選的那段期間。等該站點更新後標記就會消失。

金額格式與系統餘額一致：有啟用金額小數的站點顯示到小數第二位，未啟用的站點顯示整數；應收費用同樣依此精度四捨五入。

扣費後餘額

系統餘額下方的「扣費後」是目前餘額 − 該期間實際計收的系統費，用來一眼看出這段期間結算完之後這個站點還剩多少預付款，不必自己心算。

情況	顯示
試算為正	灰色小字，代表預付款足夠
試算為負	紅字加粗並帶警示圖示，代表結算後會欠費，需要請對方加值（加值按鈕就在同一格）
沒有帳單資料、也沒設保底	不顯示這一行（該列的系統費欄本身就是 -）
該站點標示「非所選期間」	不顯示這一行 —— 系統費不是所選期間算出來的，扣出來的數字口徑不明

滑鼠移到該行會顯示算式，例如「系統餘額 50,000 − 系統費 30,000（以保底計收）」。算式裡的計收方式要留意：保底是「每月」的金額，若你把統計期間改成非整月（例如只看昨天），一天的抽佣幾乎不可能超過月保底，系統費就會判為以保底計收，扣出來的是整月保底。要看真實的月結餘，統計期間請維持在「本月」。

本站列也照樣顯示：本站的系統餘額固定為 0（服務提供方不需向自己預付款），因此只要有系統費，扣費後就一定是負數。規則對每一列都一樣沒有例外 —— 一列有一列沒有，反而會讓人以為功能出了問題。

本月系統費與保底費用

月費的計費方式是抽佣與保底取高者，因此「本月系統費」欄把兩個數字並列：

位置	內容
分子	本月實際抽佣 —— 代收費用與代付費用相加，也就是依費率算出來的金額
分母	該站的每月保底費用

實際生效的那一邊會以顏色與粗體凸顯，另一邊淡化，下方並附上文字說明：

顯示	意思
左側凸顯 ＋「以抽佣計收」	本月抽佣已達（或超過）保底，按抽佣金額計收
右側凸顯 ＋「以保底計收」	本月抽佣不足保底，按保底金額計收

尚無帳單資料或尚未設定保底時，對應的位置顯示 -；沒有帳單資料時不會標示計收方式（無從比較，不可誤看成以保底計收）。點擊欄位標題旁的驚嘆號圖示可查看完整的計費說明。

本站列與列表底色

列表第一列固定為本站（當前站點自己），以不同底色標示並帶有「本站」標籤，方便與各承租站點的當月數字並排比較。本站列不是一筆建站申請，因此：

• 不受狀態篩選與分頁影響，永遠顯示在最上方
• 顯示站名、狀態、網域、本月代收／本月代付與系統餘額，其餘欄位一律顯示 -（本站不需向自己收費，故不顯示應收費用）
• 狀態固定顯示營運中：本站就是正在運作中的站台，不像承租站點會經歷收訂與建站流程
• 申請時間顯示的是站台開通時間（本站沒有申請單，取系統初始化第一批資料的建立時間）
• 網域為本站正在使用中的位址：後台取當前瀏覽的網址、後端取後台實際呼叫的 API 位址
• 系統餘額固定顯示 0：本站是服務提供方，不需要向自己預付款。下方的「扣費後」仍照樣顯示（見上方「扣費後餘額」），因此本站列的試算等於系統費的負數

表格上方會顯示目前的申請筆數區間（例如「顯示 1–19，共 19 筆」），本站列是固定的第一列、不計入筆數。點擊旁邊的 列表底色說明 可查看底色對照：

底色	說明
藍底	本站（當前站點，固定顯示於第一列）
無底色	承租站點的建站申請

設定本站費用（費率一次性，保底可調整）

本站列的操作欄有一個 設定本站費用 按鈕（齒輪圖示），可填入本站的代收費率、代付費率（皆為「分子／分母」格式，例如 2 / 1000 表示千分之二）與保底費用。

此操作不可逆

三個欄位一次送出即永久鎖定：操作欄的按鈕會消失，之後無論從後台或 API 都無法再修改，日後如需調整只能由工程師直接修改資料庫。請務必確認數值無誤後再送出。

項目	說明
顯示條件	僅在尚未設定且具備申請管理權限時出現；設定後操作欄顯示 -
填寫規則	費率的分子須為 0 以上的整數、分母須為 1 以上的整數；費率 0（免費）是合法設定
保底必填	三個欄位都要填 —— 整組設定只有一次機會，留空的話日後無法再從後台補設。不想設保底請填 0
設定後	費率與本月系統費的分母改為顯示設定值，不再提供任何修改入口
操作紀錄	設定動作會寫入操作歷程，可在「操作歷程」頁面以「設定本站費率」查詢

保底費用（與費率同一個設定畫面）

保底費用每站各自設定（各站合約條件不同），沒有獨立的操作按鈕 —— 就填在設定費率的同一個畫面裡：

對象	設定位置	可否修改
本站	本站列操作欄的 設定本站費用（齒輪圖示）	與費率一起一次性鎖定，設定後不可修改
承租站點	收訂 / 編輯 / 編輯費率 的視窗，費率欄位下方	可隨時透過同一個視窗調整

項目	說明
填寫規則	0 以上的數字；填 0 代表不設保底、純抽佣
承租站點留空	代表不異動，會保留原本已設定的金額（要取消保底請填 0）
設定後	「本月系統費」欄的分母改為顯示該金額

狀態流程

PENDING → RECEIVED → COMPLETED → 營運中 ⇄ 已關站
    ↓
 REJECTED

狀態	說明
PENDING	新提交的申請，待管理員收訂
RECEIVED	已收訂，管理員已確認並填寫網域與費率資訊
COMPLETED	建站完成，系統已自動建立站點
營運中	站台已上線接單
已關站	終止合作，站台停止營運（可再恢復營運）
REJECTED	已駁回

開始接單會自動轉為營運中

建站完成的站點只要出現任何一張成功的代收或代付訂單，就會自動轉為「營運中」，不需要人工去改。系統在每次開啟本頁查詢帳單時順手更新，所以進來看一眼報表就會同步。

判斷依據是該站是否曾有訂單（不限當月），因此「上個月開張、這個月還沒有單」的站點也會正確轉換。已關站的站點即使還有訂單也不會被自動轉回營運中 —— 關站與否是人工的商務決定。

建站完成、營運中、已關站合稱「已建站」

這三個狀態代表站台實際存在過，因此行為相同：可查月帳單與費用流水、可編輯費率，且一律不可刪除申請（刪掉會連同計費與建站紀錄一起消失，站名也會被誤判成可重複使用）。

操作按鈕

按鈕	顯示條件	說明
收訂	PENDING	標記為已收訂，需填寫網域與費率
編輯	RECEIVED	修改已收訂的網域與費率資訊
建站	RECEIVED 且在開發環境	執行一鍵建站，自動化部署新站點。線上看不到這顆按鈕，見下方說明
駁回	PENDING	駁回申請
編輯費率	已建站	修改該站的費率與保底費用，狀態維持不變
標記為營運中	COMPLETED	站台上線接單後改為營運中
標記為已關站	營運中	終止合作、站台停止營運
恢復營運	已關站	把已關站的站點改回營運中（誤點可救）
費用流水	所有站點（含本站列）	開啟整月的費用流水日曆
刪除	尚未建站	刪除申請（需 2FA 驗證碼）；已建站的申請不提供此按鈕

已移除的兩顆按鈕

「建站紀錄」與「同步主站設定」兩個入口已移除。同步主站設定原本就是一鍵建站時自動完成的 一個步驟，那個步驟一個字都沒動，新建的站點照樣會自動設好。

切換營運中／已關站只會變更狀態，不會動到已設定的費率與保底。

收訂操作

點擊「收訂」按鈕開啟表單：

欄位	說明
網域	填寫網域前綴，後台預設用 .com、後端用 .net。若 .com 已被別人註冊，建站時會依 .com → .cc → .org 找一個可用的，並詢問是否改買；實際買到的會顯示在列表的「網域」欄
代收費率	分子/分母格式，如 3/1000 表示千分之三
代付費率	分子/分母格式
備註	管理員備註（選填）

一鍵建站

只能在開發環境執行

建站的第一步就是實際購買網域（要花錢、買了退不掉），而那顆按鈕就排在操作欄裡， 跟編輯費率、標記營運中那些擺在一起，很容易誤觸。因此線上環境不顯示建站按鈕， 需要建站時請工程師在開發環境執行。

不受影響的部分：已建站的站點在線上一切照舊。

收訂後可執行一鍵建站，系統會自動化執行以下步驟：

1. 購買網域並設定 DNS 記錄
2. 建立前端與後端服務（自動部署至雲端平台）
3. 設定站點環境變數（SITE_NAME、資料庫連線等）
4. 自動生成站點 favicon（依站名產生圖示）
5. 初始化種子資料（預設管理員帳號、角色權限、系統設定）
6. 綁定自訂網域並啟用 SSL

建站過程以步驟進度條即時顯示，每個步驟標示完成／進行中／失敗狀態。 在沒有原始碼的環境會自動略過的步驟標成灰色減號（不是紅色叉叉）—— 那不是失敗， 不需要按重試。

開始／暫停／繼續

• 從沒開始過的申請只顯示 「確認開始建站」
• 開始過之後改為 「暫停建站」 與 「繼續建站」 兩顆，各自依當下狀態決定能不能按
• 按下暫停會等目前這個步驟跑完才停下來（買網域、租伺服器做到一半被切斷會留下 付了錢卻沒記錄的資源），畫面會顯示提示，不是沒反應
• 「繼續建站」從下一個未完成的步驟接續，已完成的步驟不會重做
• 關掉視窗會停止輪詢；重新打開時若還在跑，會自動接回進度
• 正在跑或正在暫停時再按開始不會有第二輪 —— 跑兩輪就是網域與伺服器各買一次

前台網域買不到 .com 時

前台網域預設用 .com。若 .com 已被別人註冊，系統會依序找 .cc → .org， 找到可用的就停下來跳出確認視窗問你要不要改買：

• 視窗會同時說明「xxx.com 已被他人註冊」與「要改買哪一個」
• 確認後會立即購買，取消則不產生任何費用
• 待確認的步驟標成琥珀色問號（不是紅色叉叉）—— 那不是失敗，直接按重試沒有用， 必須從確認視窗選定要買哪一個
• .com／.cc／.org 三個都被註冊走時才中止建站，並要求改用其他站點名稱
• 實際買到的頂級域會顯示在列表的「網域」欄，不會再一律顯示成 .com
• 後端網域（.net）不走這個候選鏈：那是內部 API 專用，沒有品牌考量

費用流水日曆

操作欄的 「費用流水」 會開啟該站點整個月的日曆檢視，一眼看完費用集中在哪幾天、 哪幾天完全沒有流水。本站列與所有承租站點（含已關站的）都看得到 —— 已關站的站點 仍然要查得到歷史費用。

每一格直接顯示四個金額，不必點開：

顯示	說明
代收	當日代收總額
代收費	依代收費率算出的當日費用（縮排、主色）
代付	當日代付總額
代付費	依代付費率算出的當日費用（縮排、主色）

格子的底色是以當月最大單日費用做相對分級的五階熱度，所以不論站點大小都看得出分布。

格子放的是「當日抽佣」，不是系統費

系統費是「當月抽佣與保底取高者」，而保底是整個月的下限、攤不到某一天。 硬攤下去會讓格子加起來不等於月結金額，所以保底放在上方的摘要，與表格用完全相同的 「擇大」規則對帳。

摘要的月合計也不是把格子加起來的：分日取整再相加與先加總再取整會差幾分錢， 月合計一律以整個區間的總額重算，與列表的「本月系統費」是同一個數字。

尚不支援的站點

承租站點的版本較舊、還沒有這支查詢時，會顯示「尚不支援」提示而不是畫成一張空日曆 —— 空日曆看起來就是「這個月沒有費用」，兩者意思完全不同。

月帳單

代理推廣頁面提供從站月帳單查詢功能，可查看各從站的月度帳單資訊，包含當月流水、抽佣費用等。

系統餘額

承租站點以預付方式使用本系統：先充值到系統餘額，系統費用再由此扣除。餘額顯示於申請列表的「系統餘額」欄，並附兩個按鈕：

按鈕	說明
錢包圖示	開啟餘額異動視窗（需 promo.recharge 權限）
清單圖示	檢視該站點的餘額異動紀錄

餘額異動

點擊錢包圖示開啟異動視窗，需輸入 2FA 驗證碼（6 位 TOTP）：

欄位	說明
異動類型	加值（收到款項後入帳）／扣款（扣除當期系統費用）／人工校正（更正入帳錯誤）
異動金額	加值與扣款只接受正數，方向由類型決定；人工校正可輸入負數
備註	建議填寫結算期間，例如「2026-07 系統費用」

搭配上方的月帳單查詢當期應收費用後，再以「扣款」將該筆費用扣除。

餘額可為負

餘額不足時系統只提示不阻擋：畫面會以紅字標示欠費，但不會因此停用該站點或擋下任何操作。

餘額異動紀錄

每一筆進出都會留存紀錄，包含異動類型、金額、異動前後餘額、備註、操作者與時間，可供對帳與稽核。

承租站點的檢視方式

承租站點的營運方可在自己後台的儀表板頁面上方看到目前的系統餘額，餘額為負時會顯示欠費提示。此卡片只在承租站點出現，其他站點不會顯示。

同步主站設定

承租站點必須知道自己隸屬於哪個站台，才能查到系統餘額等由上層管理的資料。這項設定會在 一鍵建站時自動完成，是建站流程的其中一個步驟，不需要手動處理。

手動補寫的按鈕已移除

過去申請列表上有一顆「同步主站設定」按鈕，用來替機制上線前建立的舊站點補寫這項設定。 該按鈕已移除；建站流程裡的自動設定完全保留。

刪除申請

刪除申請需要輸入 2FA 驗證碼（6 位 TOTP），防止誤刪。已建站的申請（建站完成／營運中／已關站）不可刪除，畫面上也不會出現刪除按鈕。

權限

權限代碼	說明
promo.read	查看代理推廣頁面、月帳單與餘額異動紀錄
promo.update	收訂、編輯、建站、刪除申請與推廣連結管理
promo.recharge	系統餘額異動（加值／扣款／人工校正）。與 promo.update 分權，預設只給系統管理員