NEXUS 使用流程說明書
一份白話、完整的操作指南，涵蓋 使用者端、P2P 商城核心、管理端、廠商端 與 Telegram Bot 五大端。 每個角色該在哪個畫面、按哪個按鈕、填什麼欄位、會發生什麼事，這裡都說清楚。 看不懂專業術語沒關係，每段都附白話翻譯。
系統總覽與五大端
NEXUS 是一個「人對人（P2P）」的數位商品交易平台。簡單說：賣家把商品掛上架（出價賣），買家下單買，買家轉帳後賣家確認收款，平台把關到帳後完成交易。 平台從成交中賺取分紅與手續費，並支援外部廠商透過 API 自動下充值/出金單。整套系統由下面五個端組成。
使用者端
買家與賣家的交易前台（市場、掛單、訂單、錢包）。
P2P 商城核心
撮合、定價、分紅、訂單生命週期等交易規則。
管理端
後台：審核到帳、KYC、爭議、會員與通道控制。
廠商端
外部合作商後台 + API：建充值/出金單、領佣金。
Telegram Bot
主動通知撮合/付款/分紅，賣家可確認收款。
五大端如何串在一起？
廠商端則是另一個入口：外部廠商用 API 直接下「充值單（等同買家 Bid）」或「出金單（等同賣家 Ask）」， 掛進同一個 P2P 市場與一般會員撮合，平台再從費差（fee spread）抽成。
正式網址一覽
| 端 | 正式網址 | 使用者 | 登入方式 |
|---|---|---|---|
| 使用者端 / P2P 前台 | 由平台提供 | 買家、賣家會員 | 信箱 + 密碼 |
| 管理端後台 | 由平台提供 | 平台管理員、客服 | 帳號 + 密碼（依角色權限） |
| 廠商端後台 | 由平台提供 | 外部合作廠商 | 信箱 + 密碼（首登一次性密碼） |
| Telegram Bot | 平台官方 Bot | 已綁定的會員 | 前台產生綁定連結 |
名詞與規則速查
看流程前先搞懂這幾個關鍵字，後面就會很順。
Bid（買單）vs Ask（賣單）
Ask = 賣單：賣家把商品上架等人買（出金方向）。
Bid = 買單：買家出價求購（充值方向）。
廠商對照 廠商充值單＝Bid、出金單＝Ask。方向千萬別搞反。
本金 vs 分紅（最重要）
本金 = 單張面額 × 張數，例如 NT$100 × 10 張 = NT$1,000。
買家只付本金這個整數金額，不會被加收。
分紅 = 本金 × 分紅率（約 1.5%），由平台「另外撥」給賣家，不從買家身上多收。
雙錢包：主錢包 / 分紅錢包
主錢包：交易本金進出，可申請提現（依平台規則收手續費）。
分紅錢包：成交累積的分紅利潤，每 7 天可提領一次（有冷卻期）。
KYC 實名驗證
上傳身分證正反面 + 手持自拍，由後台審核。平台可設定「是否強制 KYC 才能交易」。
訂單狀態一覽
一筆訂單從成立到結束，會走過這些狀態（旁邊顏色與後台/前台顯示一致）：
| 狀態 | 白話意思 | 此時在等誰 |
|---|---|---|
| 撮合中 | 系統正在把買賣雙方配對 | 系統 |
| 待支付 | 已配對，買家還沒轉帳 | 買家轉帳 |
| 待確認到帳 | 買家已回報付款，等平台核帳放行 | 賣家回報＋平台確認 |
| 已完成 | 平台確認到帳，交易結束、撥分紅 | —（結案） |
| 爭議中 | 買或賣家對交易有異議，待平台仲裁 | 平台仲裁 |
| 已取消 | 逾時未付款或爭議駁回而取消 | —（結案） |
只有平台管理端（需專屬權限）或系統自動對帳能把訂單確認到帳、正式放行撥款。 賣家就算在 Telegram 或免登入頁按「我已收款」，也只是回報、不會放行。這道閘是為了保護資金安全。
自動撮合（雙邊）
買單與賣單進入市場後，系統會依面額額度自動配對。賣家可在會員設定開啟「自動撮合」， 讓系統主動把符合的買單分配進來。為了公平與防止重複扣庫存，撮合採原子鎖（先搶到的人才成交），並設有「單次可成交筆數上限」。
使用者端（交易前台）
會員在 平台前台 上完成所有交易動作。先看頁面地圖，再分「買家」「賣家」走一遍。
頁面地圖
| 頁面 | 路徑 | 做什麼 | 需登入 |
|---|---|---|---|
| 市場首頁 | /market | 瀏覽賣單／買單市場、搜尋商品、可直接建立買單 | 否 |
| 商品詳情 | /product/:id | 看單筆掛單細節、輸入張數、下單 | 下單需登入 |
| 登入／註冊 | /login・/register | 信箱密碼登入；註冊可填邀請碼 | — |
| 會員中心 | /member | 總覽、銀行帳戶管理、KYC 狀態、庫存統計 | 是 |
| KYC 驗證 | /kyc | 上傳證件與自拍、填身分資料 | 是 |
| 上架商品（快速） | /inventory | 選庫存→選面額→選張數→選銀行→上架 | 是 |
| 掛單（完整） | /quick-listing | 完整掛單表單、面額檔位、帳戶額度 | 是 |
| 訂單列表/詳情 | /orders | 買賣雙向訂單、上傳付款截圖、確認收款、提爭議 | 是 |
| 錢包與分紅 | /wallet | 主錢包＋分紅錢包、交易明細、提現/提領 | 是 |
| 免登入訂單頁 | /order-view/:token | 用連結看訂單、上傳截圖、賣家確認收款、提爭議 | 否 |
| 快速再掛單 | /relist/:token | 賣出後用連結快速掛下一批（免登入） | 否 |
| AI 客服 | /support | 對話式客服，問 KYC/付款/訂單/爭議 | 是 |
| 新手教學 | /guide | 分步驟流程與常見問題 | 否 |
🧾 買家：完整購買流程
/register 填信箱、顯示名稱、密碼（可填邀請碼）即自動登入；或在 /login 登入。/market 切換「賣單市場」、用商品名／分類搜尋。卡片會顯示本金（面額×張數）與分紅（本金×1.5%）。/product/:id，輸入購買張數（≤ 可售張數），系統算好應付金額＝本金，按「下單」建立訂單。/orders 看到該筆賣家的銀行帳號、戶名與備註碼。用銀行 App 轉帳，金額＝本金，備註務必填訂單指定的備註碼（用來自動對帳），並在期限內完成。/inventory 再掛單轉售，成交後可賺取分紅，進入「買→賣」循環。🏷️ 賣家：完整掛單流程
賣家前置準備
- 完成 KYC（
/kyc）：審核通過才能順利交易。 - 新增收款銀行帳戶（
/member）：填銀行、帳號、戶名並完成驗證；可設定每個帳戶的收款額度上限，超過就不能再用該帳戶掛單。
/inventory，系統列出你的庫存商品，挑要上架的批次。/orders 或免登入訂單頁看到截圖。核對金額、收款帳號、備註碼是否正確，按「確認收款」。/relist/:token，免登入就能用剛賣出的面額快速掛下一批（張數預設 1）。🪪 KYC 身分驗證
要填／要傳什麼
- 真實姓名、身分證號
- 證件發行城市、發行日期
- 身分證正面照
- 身分證背面照
- 手持證件的自拍照（臉與證件都要清楚）
狀態怎麼看
未送審 尚未提交
審核中 已送出，等平台審
已通過 可正常交易
已駁回 需依退件原因重傳
💰 錢包與分紅
| 錢包 | 錢從哪來 | 能做什麼 | 提領規則 |
|---|---|---|---|
| 主錢包 | 交易本金（賣出收到的金額） | 再掛單、申請提現 | 可申請提現，依平台規則收手續費並審核 |
| 分紅錢包 | 每筆成交的分紅利潤 | 累積利潤 | 每 7 天可提領一次（冷卻期） |
在 /wallet 可看餘額、篩選交易明細（全部／分紅／主錢包），並送出提現或分紅提領申請。提現會送到後台審核後再打款。
⚖️ 爭議與免登入訂單頁
誰能提爭議、何時提
買家與賣家都能提。只要訂單還沒走到結案（已完成／已取消）就能發起。常見情況：買家已付款卻收不到、賣家收到可疑截圖、金額不符等。
怎麼提
在 /orders 或免登入頁點「提交爭議」，填寫爭議原因與說明、可附證據。送出後訂單轉 爭議中，由平台介入仲裁。
/order-view/:token 的用途：買家可把這個連結分享給賣家，賣家不用登入就能查看訂單、看付款截圖、確認收款、甚至提交爭議。連結帶有簽名 token，安全可驗證身分。P2P 商城核心：交易機制與生命週期
這一章把「市場背後的規則」講清楚——撮合怎麼配對、價格與分紅怎麼算、一筆訂單完整走過哪些關卡、爭議駁回會發生什麼。理解這些，前面的買賣流程就會更踏實。
1. 撮合：買賣怎麼配對
- 賣單（Ask）與買單（Bid）都進同一個市場池。
- 系統依面額額度自動配對，買方以被動接單方式分配（先搶到鎖的人成交，避免兩個人同時吃到同一張庫存）。
- 支援雙邊自動撮合：賣家可開「自動撮合」，由系統主動派單；並設有「單次可成交筆數上限」避免一次被吃光。
- 外部廠商透過 API 下的單，也進同一個池一起撮合。
2. 定價與分紅（兩個獨立的比率）
3. 訂單生命週期（一條主線）
旁支狀態：逾時未付款 → 已取消；任一方發起爭議 → 爭議中（見下）。
4. 爭議駁回 = 取消交易（重要語意）
✅ 爭議「通過 / 人工確認到帳」
平台認定買家確實已付款 → 確認到帳、訂單完成、撥分紅。後台這顆按鈕現在叫「人工確認到帳」。
🚫 爭議「駁回」
平台認定交易不成立 → 取消這筆交易，並只釋放這筆訂單鎖住的庫存還給賣家（不影響其他訂單）。
5. 並發與資金安全的底層保證
- 不超賣：庫存以原子鎖扣減，併發下單也只會有先搶到的人成交。
- 不雙扣分紅：分紅撥付有唯一鍵去重，同一筆訂單不會重複撥。
- 放行唯一閘：只有後台權限或自動對帳能確認到帳，賣家回報不放行。
- 守恆：庫存與分紅以「可用 + 鎖定」守恆驗證，已通過正式站並發壓測。
管理端後台
後台網址 由平台提供，用帳號密碼登入，依角色權限顯示可用選單。以下是「NEXUS 管理」分類下的主要功能。
後台功能選單
| 選單 | 做什麼 |
|---|---|
| 使用教學 | 客服／值班的流程指南與檢查清單 |
| 會員管理 | 查會員、啟用／停用帳號、覆蓋個別會員的分紅佣金設定 |
| 平台設定 | 是否強制 KYC、推薦佣金率、自動撮合限額、自動審核規則、AI 供應商設定 |
| KYC 審核 | 審核會員證件與自拍，通過或駁回 |
| 訂單總覽 | 查所有訂單、付款截圖與 AI 風險分數；付款審核入口 |
| 訂單審核區 | 財務對帳後快速單筆確認到帳（有領取鎖工作台） |
| 爭議訂單區 | 處理買賣家發起的爭議：人工確認到帳 / 駁回（取消） |
| 商品分類 | 維護可交易商品、分類、面額檔位與 SKU |
| 支援銀行 | 維護平台允許綁定的銀行清單 |
| 會員收款帳戶 | 檢視／啟用／停用會員綁定的銀行帳戶與額度 |
| 外部通道控制 | 管理廠商充值／出金通道：啟用、暫停、降速、限流、營運時段、費率 |
| 廠商申請審核 | 審核廠商加盟：核准（發 API 金鑰、設費率/IP 白名單）或駁回 |
| 推薦與佣金 | 會員推薦關係、廠商代理樹、佣金事件與廠商提現審核 |
✅ 訂單審核到帳流程
🪪 KYC 審核流程
- 進「KYC 審核」，預設看 審核中 的會員。
- 點「查看」開側欄，比對會員身分資料與三張照片（正面／背面／自拍）。
- 無誤按「通過」；有問題按「駁回」並填原因。
- 只有「審核中」能操作；已通過／已駁回僅供查看。系統會記下審核人員。
⚖️ 爭議訂單處理
① 人工確認到帳（原「解決」鈕）：認定買家已付 → 訂單完成、撥分紅。
② 駁回：認定不成立 → 取消交易、只釋放該訂單的庫存鎖還給賣家。
⚙️ 會員・分紅・通道管理
分紅佣金設定
在「平台設定」設全域規則（平台分紅率、會員體量費率、三層推薦分潤、冷卻天數）。在「會員管理 → 佣金設定」可逐個會員覆蓋；留空＝沿用全域（不封頂，VIP 可高於全域）。
外部通道控制
針對每個廠商，分別設定充值／出金通道狀態：啟用 / 暫停新單 / 風控降速 / 停用，並可調限流、營運時段、費率。出現風險時可即時降速或暫停。
廠商端後台
外部合作廠商在 由平台提供 申請加盟、登入後台、建立充值／出金單、查佣金與提領，並可用 API 自動串接。
頁面地圖
| 頁面 | 路徑 | 做什麼 |
|---|---|---|
| 加盟申請 | /#/apply | 填公司名、聯絡信箱、推薦碼（選填）送審 |
| 登入 | /#/login | 信箱＋密碼；首登用一次性密碼，會強制改密碼 |
| 儀表板 | /#/dashboard | 佣金餘額、通道狀態、限流上限、推薦碼、API Key（遮蔽）、費率 |
| 建立訂單 | /#/order/create | 建充值單（Bid）或出金單（Ask），預覽手續費與撥款週期 |
| 訂單管理 | /#/orders | 「我的掛單」（未成交）與「成交訂單」（已完成/爭議） |
| 佣金與手續費 | /#/commission | 佣金餘額、平台費率（唯讀）、佣金流水 |
| 佣金提領 | /#/withdrawal | 申請提領（金額即鎖定，駁回自動退回） |
| 帳號設定 | /#/account-settings | 修改密碼（至少 8 字） |
| API 文檔 | /#/api-docs | 簽名規則、必要參數、Bid/Ask 定義、錯誤碼說明 |
廠商：加盟到接單流程
/#/apply 填公司名、聯絡信箱（日後當帳號）、推薦碼。送出後等平台審核。佣金（費差 fee spread）怎麼算
每筆訂單的手續費依平台為該廠商設定的費率計算：
手續費 = 報價 × fee_rate + fee_fixed
若 手續費 < fee_min → 取 fee_min
若 手續費 > fee_max → 取 fee_max（fee_max=0 表示不設上限）充值與出金可各設不同費率與撥款週期（如 T+3 含假日 / T+2 不含假日）。佣金流水包含：commission_in（入帳）、withdrawal_lock（提領鎖定）、withdrawal_paid（已打款）、withdrawal_refund（駁回退回）。
API 串接（廠商自動下單）
除了在後台手動建單，廠商也可透過平台提供的 API，從自家系統自動建立充值（Bid）/出金（Ask）單，掛進同一個市場與一般會員撮合。
- 安全機制：API 採請求簽名 ＋ IP 白名單雙重保護，並有時效與防重放控制。
- 限流：每個廠商有每分鐘／每日的呼叫上限，風控時會自動降速。
- 通道狀態：通道可能因營運時段、暫停或風控而拒單，回應會帶明確的狀態說明。
Telegram Bot：通知與綁定
綁定後，平台會在關鍵事件主動推訊息給你（撮合、付款、完成、分紅），賣家也能直接從 Telegram 進到收款確認頁。
第一步：綁定帳號
/start <綁定碼>。會收到哪些通知
| 事件 | 誰收到 | 內容 |
|---|---|---|
| 撮合成功 | 買家賣家 | 買家：請去轉帳（附訂單與收款資訊連結）；賣家：等待買家付款 |
| 買家已付款 | 賣家 | 請查帳，附「查看交易明細與付款截圖」按鈕 |
| 交易完成 | 買家賣家 | 買家：交易成功；賣家：交易完成＋「再次掛單」連結 |
| 收到分紅 | 賣家 | 分紅已撥入分紅錢包，附金額 |
賣家：在 Telegram 確認收款
收到「買家已付款」通知後，賣家有兩種方式確認：
- 點按鈕進免登入頁：看買家上傳的付款截圖，核對後按「已確認收款」。
- 直接點「我已收款」按鈕（舊版相容）。
管理選單（常駐鍵盤）
💰 我的帳戶 /me
查主錢包與分紅錢包餘額（提領仍到網站操作）。
📋 我的掛單 /listings
列出上架中的賣單（商品、面額、剩餘張數、售價，最多 8 筆）。
網址總表・常見問題
網址總表
| 用途 | 網址 |
|---|---|
| 會員交易前台（P2P 商城） | 由平台提供 |
| 管理端後台 | 由平台提供 |
| 廠商端登入 | 由平台提供 |
| 廠商加盟申請 | 由平台提供 |
| Telegram Bot | 由前台「綁定 Telegram」產生連結 |
常見問題（FAQ）
Q：買家到底要付多少錢？
付「本金 = 單張面額 × 張數」這個整數金額。分紅是平台另外撥給賣家的，不會向買家加收。
Q：賣家在 Telegram 按了「我已收款」，怎麼還沒拿到錢？
那只是回報。要等平台後台或自動對帳「確認到帳」放行後，訂單才完成、分紅才入帳。這是保護雙方的把關步驟。
Q：分紅多久能領一次？
分紅錢包有 7 天冷卻期，每 7 天可提領一次；主錢包則可申請提現（後台審核後打款）。
Q：爭議「駁回」會怎樣？
等於取消這筆交易，並把這筆訂單鎖住的庫存還給賣家，賣家可重新掛單。未完成不撥分紅。
Q：廠商串 API 一直被擋？
先確認方向（Bid/Ask）沒搞反、簽名與時間戳正確、來源 IP 在白名單內，且通道在營運時段、未被暫停或風控限流。
Q：未登入逛市場看到的是真資料嗎？
市場顯示真實掛單；未登入時不會顯示任何假會員或假餘額。資料載入失敗會誠實顯示空狀態或錯誤，不會用假資料補位。