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：未登录逛市场看到的是真数据吗？
市场显示真实挂单；未登录时不会显示任何假会员或假余额。数据加载失败会诚实显示空状态或错误，不会用假数据补位。