金币市场（GoldMark）使用文档

作者：kuakeba.cn | 版本：1.0.0 | 适用于 Zsens Admin 3.0+（PHP 8.2+）

一、插件简介

用户间金币交易平台：

• 卖家挂单出售个人账户金币（社区 Coin 体系），金币立即冻结托管
• 买家经支付中心（paymentt）人民币在线购买，付款后金币自动到账
• 卖家获得人民币余额，可申请提现（后台审核打款）
• 市场页含统计条（在售挂单 / 当前最低价 / 累计售出 / 我的金币 / 余额）、挂单卡片网格、最近成交侧栏
• 支持平台手续费比例、价格区间、单笔数量限制等配置

二、环境要求

三、安装步骤

1. 将 GoldMark 目录放入 plugins/ 下
2. 进入后台 应用中心，找到「金币市场」，点击 安装

  - 自动创建 4 张数据表（见下文）

  - 自动复制静态资源到 public/static/GoldMark/

  - 自动注册后台菜单「金币市场」及社区顶部导航入口

1. 进入 应用中心 → 金币市场 → 配置 调整交易规则
2. 前台访问 /goldmark（或点击社区导航「金币市场」）即可使用

卸载插件时会删除数据表、静态资源、菜单与导航。

四、配置项说明

后台 应用中心 → 金币市场 → 配置：

五、前台使用

1. 市场页 /goldmark

• 统计条：在售挂单数与金币总量、当前最低价（元/千金币）、累计售出、我的金币、我的人民币余额
• 全部 / 我的：切换浏览全部在售挂单或仅自己的挂单（含锁定中）
• 排序：单价从低到高 / 单价从高到低 / 最新发布
• 卡片信息：卖家头像昵称、社区号、挂出时间、金币数量、每千金币价、单个价、总价；最低单价挂单显示「全场最低」徽章
• 右侧「最近成交」：点击展开最近 20 条成交记录

2. 出售金币

点击「出售金币」→ 输入出售数量与每千金币售价 → 弹窗实时预览总价与手续费后实收 → 确认挂单。

• 挂单成功后金币立即从账户冻结扣除（金币流水：市场挂单冻结）
• 取消挂单后金币自动退回（金币流水：市场取消退回）

3. 购买金币

点击卡片「立即购买」→ 确认 → 系统锁定该挂单并创建支付订单 → 跳转支付中心收银台付款。

• 付款成功后金币自动到账（金币流水：市场购入金币），进入购买结果页
• 支付超时未完成的挂单会自动释放回在售状态
• 不能购买自己的挂单

4. 我的记录 /goldmark/records

四个标签页：

5. 余额提现 /goldmark/withdraw

填写提现金额、收款账号（支付宝/微信）、真实姓名、备注 → 提交后余额先行冻结扣除 → 后台审核：

• 打款：管理员线下转账后标记「已打款」
• 拒绝：余额自动退回账户

六、后台管理

菜单：金币市场（后台左侧）

七、交易流程与状态机

卖家挂单 ──冻结金币──▶ 在售 ──买家下单──▶ 锁定中 ──支付成功──▶ 已售
                        │                     │
                        ├─取消/强制下架        ├─支付超时/失败
                        ▼                     ▼
                     已取消(退金币)         回滚在售(交易关闭)

提现：申请(扣余额) ─▶ 待审核 ─▶ 已打款
                          └──▶ 已拒绝(退余额)

八、数据表

九、接口说明

前台接口均返回 {code, msg, data} JSON（页面接口除外）：

十、常见问题

Q：挂单后金币去哪了？

挂单时金币从卖家账户冻结扣除，托管在挂单中；售出时直接转给买家，取消/下架时退回卖家。全程可在会员中心金币流水查看。

Q：买家付款后金币没到账？

支付中心通过 onPaymenttFulfill 钩子发货，正常即时到账；若为异步回调渠道（微信/支付宝），到账以回调为准。后台「支付中心 → 支付订单」可手动补发。

Q：交易卡住（一直锁定中）？

支付订单超过 1 小时未支付会被关闭，市场页加载时自动释放挂单回在售；也可在后台「挂单管理」强制下架。

Q：如何收取平台手续费？

在插件配置中设置「平台手续费（%）」，成交时自动从卖家所得中扣除（卖家实收 = 成交金额 − 手续费）。

Q：提现怎么打款？

目前为线下打款模式：用户提交申请后，管理员在后台「提现审核」查看收款账号，线下转账后点击「打款」完成。