XXG发卡网高颜值、全自动的数字商品发卡平台 · 无感对接小小怪卡密系统付款即发货卡密从生成、上架、售出到退款全程自动流转项目简介XXG发卡网是一套面向数字商品的自动发货平台适合销售游戏点卡、影音会员、软件激活码、授权卡密等虚拟商品。买家下单付款后系统自动发卡卡密直接展示在订单页面并可通过邮件送达站长在管理后台即可完成商品、卡密、订单、买家、优惠券与系统配置的全部管理。它最大的特点是与小小怪卡密系统xxgkami-pro原生打通两边部署在同一台服务器或同一内网时在卡密系统中点一下「一键添加」即可完成对接。此后卡密的上架、同步、售出、退款、停用全部自动流转站长无需再手动搬运卡密。[!TIP]小小怪卡密系统负责卡密的生成、加密与验证XXG发卡网负责商品展示、收款与发货。两者搭配使用即可搭建一套从「制卡」到「卖卡」再到「验卡」的完整闭环。核心优势一键对接卡密系统同机或内网部署时卡密系统自动发现本站并下发对接ID与密钥不用复制粘贴任何配置。四重同步保障实时推送、每 3 秒定时同步、心跳触发同步、每 30 分钟全量对账新卡密几秒内自动上架。绝不重复售卖发货前先向卡密系统确认售出卡密已被他处使用时自动换卡同一张卡密只会卖给一位买家。自动配卡按「应用 规格」或自定义分类把卡密自动上架到指定商品一个商品可以配置多个分类。状态双向联动卡密系统暂停对接时自动停售、恢复后自动开售退款时可把卡密退回卡密系统重新上架。安全可靠全部通信使用 HMAC-SHA256 签名时间戳与随机串防重放并校验卡密系统的响应签名。不碰卡密本身对接只读取未使用的卡密并回传上架、售出信息不修改卡密内容不影响卡密的验证与激活。开箱即用首次启动自动建库建表并写入示例数据前后端分离桌面端与手机端均可流畅使用。无感对接小小怪卡密系统「无感」指的是对接一次之后站长几乎感知不到两套系统之间的存在。卡密在 小小怪卡密系统 里生成几秒后就出现在发卡网对应商品的库存里买家买走后卡密系统里立即显示「已被发卡网售出」。整个过程不需要人工上架、导出导入或核对。买家XXG发卡网小小怪卡密系统买家XXG发卡网小小怪卡密系统loop[按心跳间隔默认 60 秒]loop[每 3 秒]检测本地发卡网 / 一键添加自动下发对接ID与密钥1心跳上报发现新卡密时立即拉取2卡密上架、修改、停用时实时推送3增量拉取新卡密按分类自动上架到商品4下单并付款5回传售出失败自动换卡、重试6自动发货展示卡密7卡密被买家激活后同步状态8一键对接零配置发卡网提供标准的发现接口/.well-known/xxgkami-card-shop在卡密系统后台点击「检测本地发卡网」即可扫描到本站。选择本站后点击「一键添加」对接ID和对接密钥由卡密系统生成并自动下发发卡网收到后立即保存并开始心跳。后台「系统设置 - 卡密系统对接」每 3 秒刷新一次对接状态收到心跳时状态点会闪烁对接成功直接弹出提示无需刷新网页。两套系统部署在不同服务器时也支持手动填写对接地址、对接ID和密钥还可额外配置一个内网地址公网不通时自动切换。四重同步卡密秒级上架方式触发时机作用变更推送卡密系统中卡密上架、修改、暂停、删除、被使用时实时推送本地库存即时增删改事件去重重复推送不会重复入库定时同步每 3 秒增量拉取一次尚未获取过的卡密不依赖推送与心跳任何一方遗漏都能补上失败时逐步退避恢复后回到 3 秒心跳同步每次心跳发现卡密系统有新卡密时立即拉取与定时同步互为备份全量对账启动、对接成功、修改配置后以及每 30 分钟一次移除已下架、停用、删除的卡密保证两边库存一致定时同步在没有新卡密时不写数据库并在独立线程中执行网络缓慢也不会影响心跳。自动配卡按分类上架到不同商品来自卡密系统的卡密按「应用 规格」自动分类例如「我的软件 · 30天卡」手动导入的卡密按导入时填写的分类名称分类。为商品配置「自动配卡」分类后该分类的卡密包括之后从卡密系统同步来的会自动上架到该商品一个分类只配置给一个商品不同规格可以分别卖给不同商品。尚未配置商品的卡密进入「卡密池」可在商品的卡密面板中勾选添加或按数量一键添加也可以随时退回卡密池。售出回传杜绝超卖买家付款后发卡网先向卡密系统回传售出确认成功才发货卡密已被他处售出或已失效时自动换一张可用卡密。回传失败时使用同一订单号重试卡密系统按订单号幂等处理网络抖动不会造成重复售出最终失败时释放已锁定的卡密不会占住库存。后台可一键「核对卡密状态」查看已售卡密在卡密系统中是否已被买家激活、停用或删除。状态联动自动应对各种情况卡密系统关闭本店对接时发卡网自动暂停售卖来自卡密系统的卡密手动导入的卡密不受影响重新开启后自动恢复。卡密系统中删除本店后发卡网连续 3 次收到「对接ID不存在」会自动解除对接避免一直报错。订单退款时可选择回收卡密卡密系统来源的卡密会撤销售出回到卡密系统重新可售。后台侧栏与通知中心实时显示卡密系统离线、对接暂停、卡密失效等状态。对接安全双方所有请求使用 HMAC-SHA256 签名签名内容包含请求方法、路径、时间戳、随机串和请求体摘要。时间戳超过 ±300 秒的请求直接拒绝随机串 10 分钟内不可重复使用推送事件 30 天内去重。卡密系统的响应同样带签名发卡网校验通过后才信任返回的数据。一键对接只接受本机或内网来源且只在开启「允许一键对接」后的 10 分钟内有效对接成功后自动关闭。完整的接口协议、签名算法与错误码见 CARD_SHOP_INTEGRATION.md。功能一览商城前台模块说明首页与商品列表分类导航、商品搜索、实时成交动态、站点公告与常见问题商品详情价格、库存、销量、购买须知支持购买数量限制与优惠券下单与支付游客可直接下单填写联系方式与查询密码登录后可用余额支付支付页显示倒计时与收款二维码超时订单自动关闭自动发货付款后卡密立即展示在订单页并可一键复制配置邮箱后同时发送到买家邮箱订单查询通过订单号或联系方式加查询密码找回订单用户中心邮箱验证码注册、登录、我的订单、我的优惠券、余额与账号设置独立店铺页通过/s/店铺标识访问可自定义店铺名称、头像、简介与商品展示方式管理后台模块说明仪表盘经营数据统计、销售趋势图、分类销售占比、商品销量排行、库存告急、最新订单与卡密系统对接状态商品与分类封面图标与色调、价格与划线价、自动或人工发货、上下架、排序、实时预览每个商品可单独管理卡密与自动配卡卡密管理按商品、分类、状态筛选批量导入支持 TXT 文件、全局去重、锁定、导出、删除、上架到商品、退回卡密池分类与自动配卡统一配置手动同步与核对状态订单管理按状态、支付方式、时间筛选支持人工发货、关闭、退款可选回收卡密、备注优惠券固定金额或折扣、最低消费门槛、适用商品范围、有效期、发放总量与每人限用次数买家管理查看买家订单、调整余额记录流水、封禁账号系统设置站点信息与维护模式、店铺、支付、邮件可发测试邮件、卡密系统对接、图标库、安全验证码、登录失败限制、IP 白名单、登录有效期通知中心待发货订单、库存告急、卡密系统异常等实时提醒体验与设计桌面端与手机端分别适配手机端底部导航、全屏抽屉与单列布局桌面端侧栏与多列表格。浅色、深色与跟随系统三种主题。页面切换、数字滚动、卡片入场、扫码动画等细致的动效。商品封面使用 Iconify 图标Phosphor、Simple Icons、Material Design Icons 等 9 个图标库、约 4.5 万个图标可在后台按需启用无需上传图片即可做出统一美观的商品卡片。技术架构层技术前端Vue 3、Vite、Naive UI、Pinia、Vue Router、VueUse、ECharts、Iconify后端Spring Boot 4、Spring Data JPAHibernate 7、Jackson 3、Java 21 虚拟线程存储MySQL业务数据、Redis登录令牌、验证码、对接防重放与事件去重前后端分离统一的{ code, message, data }接口格式。首次启动自动建库建表并写入管理员、示例分类、商品、卡密、优惠券、公告与常见问题。卡密分配、售出与库存计算均在事务中完成并发下单不会超卖。xxgfaka ├── backend Spring Boot 后端端口 1505 │ └── src/main/java/.../backend │ ├── kami 小小怪卡密系统对接签名、心跳、同步、推送、一键对接 │ ├── service 业务逻辑商品、卡密分类、订单、库存、设置等 │ ├── web 前台、用户、后台接口 │ └── entity / repo 数据实体与仓库 ├── vue Vue 3 前端端口 1506 │ └── src │ ├── views/shop 商城前台 │ ├── views/user 用户中心 │ ├── views/admin 管理后台 │ └── components 公共组件 ├── docs 文档资源 └── CARD_SHOP_INTEGRATION.md 发卡网对接协议文档快速开始环境要求JDK 21、Maven 3.8、Node.js 18、MySQL 8、Redis 51. 克隆代码gitclone本仓库地址cdxxgfaka2. 配置数据库修改backend/src/main/resources/application.properties中的 MySQL 与 Redis 连接信息数据库xxg_faka会在首次启动时自动创建。3. 启动后端默认端口1505cdbackend mvn spring-boot:run4. 启动前端默认端口1506/api自动代理到后端cdvuenpminstallnpmrun dev5. 访问地址说明http://localhost:1506商城前台http://localhost:1506/admin管理后台初始管理员账号在application.properties的xxg.init.admin-username/xxg.init.admin-password中配置。[!WARNING]首次登录后台后请立即修改管理员密码上传到公开仓库前请把application.properties中的数据库密码替换为你自己的配置或改用环境变量。生产部署执行npm run build生成vue/dist静态文件交给 Nginx 托管后端执行mvn clean package -DskipTests打包为 JAR 运行并在 Nginx 中把/api反向代理到后端location /api { proxy_pass http://127.0.0.1:1505; }对接小小怪卡密系统的步骤先按 小小怪卡密系统部署指南 部署好卡密系统然后任选一种方式对接。方式一同一服务器或内网推荐一键对接在发卡网后台「系统设置 - 卡密系统对接」中保持「允许一键对接」开启。在卡密系统后台「发卡网对接」页面点击「检测本地发卡网」选择 XXG发卡网后点击「一键添加」。发卡网设置页自动显示「卡密系统在线」卡密开始自动同步。在「商品管理」中为商品配置自动配卡分类或在「卡密管理 - 分类与自动配卡」中为每个规格选择商品。方式二不同服务器手动对接在卡密系统中添加发卡网对接地址填写发卡网设置页显示的「本站对接地址」经网站域名转发的地址。把卡密系统生成的对接ID与密钥填入发卡网设置页并填写卡密系统接口地址保存后点击「检测连接」。后续步骤与一键对接相同。当前状态与规划商城前台、用户中心、独立店铺页管理后台全部模块余额支付、自动发货、邮件发货、优惠券无感对接小小怪卡密系统一键对接、四重同步、自动配卡、售出回传、退款回收支付宝、微信支付、USDT 真实支付通道[!NOTE]真实支付通道尚未接入当前默认开启「沙箱模式」扫码页的付款为模拟支付用于演示和测试完整流程。正式运营前请在后台关闭沙箱模式使用余额支付或接入真实支付通道。