ZL-售卡系统 · 新手使用教程

官网:https://blog.zxiaolin.com 适用范围:UniQQ 群聊卡密自动售卖、支付宝/微信/易支付收款、邮箱与机器人自动发货


📚 教程目录

文件主要内容建议阅读对象
00-目录与快速上手.md插件介绍、完整流程、5 分钟快速上手所有人,先看这里
01-安装与首次配置.md安装、控制台、主人权限、群组开关、数据目录首次安装者
02-商品与卡密库存.md商品字段、定价、适用群、批量导入、库存状态商品管理员
03-支付渠道配置.md易支付、支付宝当面付、微信支付 API v2/v3支付配置人员
04-邮箱与自动发货.mdSMTP、发件昵称、模板、发货顺序与兜底发货配置人员
05-群内指令与运营.md用户/管理员指令、自定义触发词、欢迎语与群提示群管理员
06-订单售后与安全.md查单、补发、关闭订单、日志、备份和安全原则售后管理员
07-上线验收清单.md0.01 元真实测试、上线检查、日常巡检正式运营前必读
08-常见问题FAQ.md按错误现象排查支付、邮件、群消息与控制台遇到问题时
09-控制台页面详解.md后台每个页面、按钮、字段和推荐操作顺序控制台管理员
10-版本更新日志.md当前版本功能、修复记录和升级注意事项升级与维护人员

🌟 插件能做什么

ZL-售卡系统把“展示商品、创建订单、生成付款码、确认到账、扣减库存、发送卡密、通知群友”串成一条自动流程。

  • 🛒 群内商店:群友发送购买触发词即可看到商品、价格、库存、支付方式和下单格式。

  • 💳 三类支付渠道:易支付、支付宝当面付、微信支付 API v2/v3 Native。

  • 🌐 云端店铺:商品、卡密、订单与设置在插件与云端店铺间双向自动同步(0.0.8 起)。

  • 🔐 安全出库:只有渠道验签成功且支付金额一致,才会分配卡密。

  • 📧 邮箱优先发货:订单带邮箱时优先发邮件;群内订单无邮箱时直接通过群临时会话发货,买家无需加机器人好友。

  • 📣 支付状态提示:支付成功后在原群提示,但绝不在群内公开卡密。

  • 🧹 二维码自动撤回:支付成功、订单取消或过期后,尽力撤回群内付款码消息。

  • 🖥️ 可视化控制台:商品、库存、订单、支付、邮件、指令、群组、云端同步和日志集中管理。

🔄 一笔订单是怎样完成的

群友发送“购买”
    ↓
机器人展示当前群可购买商品
    ↓
群友发送“购买 1 支付宝 邮箱 user@example.com”
    ↓
插件创建待支付订单并生成二维码/支付链接
    ↓
支付渠道确认成功,插件验签并核对金额
    ↓
事务锁定一条未售出卡密,避免重复出库
    ↓
优先发到邮箱;群内订单无邮箱时直接群临时会话发货
    ↓
群内提示购买成功,撤回付款码,订单标记已发货

🚀 5 分钟快速上手

第 1 步:安装并打开控制台

  1. 将完整的 XiaoLin.ZLCardStorePlugin.uniqq 安装到 UniQQ。

  2. 启动或重启 UniQQ,在插件管理中启用“ZL-售卡系统”。

  3. 点击插件设置,打开控制台。

  4. 若提示找不到前端文件,确认使用的是完整插件包,并安装 Microsoft Edge WebView2 Runtime。

第 2 步:填写主人 QQ

进入“系统设置”,填写主人 QQ,确认全局开关已开启,然后点右上角“保存配置”。主人可执行全局开关和高权限订单操作。

第 3 步:创建 0.01 元测试商品

进入“商品管理”新增商品:

  • 商品名称:测试商品

  • 分类:测试

  • 售价:0.01 元

  • 库存预警:1

  • 使用教程:收到卡密后无需使用,仅用于支付联调

  • 售后说明:测试订单不提供正式权益

  • 状态:上架

然后进入“卡密库存”,导入两条测试卡密:

TEST-0001
TEST-0002

第 4 步:只配置一个支付渠道

第一次不要同时启用三个渠道。选择你已经签约并有完整参数的渠道,按 03-支付渠道配置.md 填写并保存。

支付宝最容易填错的是公钥:控制台需要“支付宝公钥”,不是你自己生成的“应用公钥”。

第 5 步:配置邮箱

进入“邮箱设置”,选择邮箱预设,填写 SMTP 用户名和授权码。依次执行:

  1. 保存配置;

  2. 测试连接;

  3. 填写测试收件人;

  4. 发送测试邮件;

  5. 确认发件昵称、邮件标题与正文都正确。

第 6 步:配置目标群

进入“欢迎语与群组”,添加或选择目标群:

  • 开启群售卡;

  • 按需开启欢迎语;

  • 开启支付成功群提示;

  • 开启订单结束后撤回二维码;

  • 测试阶段只允许显示测试商品。

第 7 步:完成真实验收

使用普通群成员账号发送:

购买
购买 1 支付宝 邮箱 你的邮箱@example.com

付款后确认以下结果:

  • 群里出现“支付成功/已发货”提示;

  • 原付款码消息被撤回;

  • 邮箱收到卡密、使用教程和售后说明;

  • 后台订单为“已发货”;

  • 库存减少 1,卡密不会重复发放;

  • 运行日志无持续 ERROR。

⚠️ 三条必须遵守的原则

  1. 不要跳过真实小额测试。 创建二维码成功不代表支付回调、查单、验签和发货全部正常。

  2. 不要手动确认来掩盖渠道配置错误。 先查商户后台和日志,确认订单号与金额一致。

  3. 不要泄露密钥。 应用私钥、商户 KEY、API v3 Key、证书私钥和邮箱授权码都不应截图发给别人。

下一篇:01-安装与首次配置.md

共 11 篇 ZL-售卡插件 / 目录与快速上手 0 字 0 行 zhangxiaolin
创建 2026-09-23T09:09:06.336557113Z 更新 2026-09-29T04:13:55.410121288Z