08 · 常见问题 FAQ

控制台与安装

Q:控制台空白,提示找不到前端文件

确认使用完整 .uniqq 插件包,而不是只复制 DLL;确认插件目录包含 Web/index.html;安装或修复 Microsoft Edge WebView2 Runtime,然后重启 UniQQ。

Q:页面能打开,但保存后配置没变化

修改后需要点击右上角“保存配置”。若仍无效,查看运行日志和数据目录写入权限,不要在只读目录运行。

商品与库存

Q:后台有两个商品,群里序号为什么变化了

群内序号按“当前群可见、已上架、有库存”的商品动态生成。商品下架、缺货、排序或适用群变化都会重新编号。让用户每次先发送购买触发词查看最新列表。

Q:有卡密却提示缺货

筛选对应商品,确认卡密状态是“未售出”,不是已售出、已作废或被订单锁定;同时确认商品上架且允许当前群购买。

Q:导入卡密数量比行数少

空行和重复项会被过滤。检查是否重复导入、行首尾有空格,或把多条内容粘贴到同一行。

支付宝

Q:支付宝响应验签失败

控制台“支付宝公钥”字段需要支付宝平台提供的公钥,不是你生成的应用公钥。还要确认正式/沙箱环境没有混用,RSA2 私钥与开放平台上传的应用公钥配套,公钥复制完整。

Q:同样的参数在 WordPress 可以用,在插件里不行

先比较两边实际使用的字段含义。部分 WordPress 主题会把字段命名得不准确,或内部自动读取证书。核对它保存的是支付宝公钥还是应用公钥、是否使用证书模式、网关和 AppId 是否同一环境、服务器公网 IP 是否在白名单。UniQQ 运行机器和网站服务器的公网出口 IP 可能不同。

Q:二维码生成了,为什么不能发货

二维码只代表预下单成功。必须等支付宝确认交易成功,并通过响应/查单验签和金额一致性校验,插件才会出库。

易支付

Q:易支付下单报「MD5签名错误」

先核对网关地址、商户 ID(PID)和商户密钥是否与易支付商户后台完全一致,PID 抄错会先报「pid错误,未找到对应商家」。参数无误仍报签名错误时,把插件更新到 0.0.17 及以上——z-pay 等网关的 mprotect(担保时效)参数只传参、不参与签名,旧版本把该参数算进了签名串。

Q:点链接能付款,扫码却报「INVALID_REQUEST 请求重入时,参数与首次请求不一致」

旧版本使用 submit.php 页面跳转长链,手机 QQ/微信内置浏览器二次打开时会对中文参数重新编码,网关比对“首次请求参数”不一致即拒绝。0.0.18 起插件统一走网关预下单短链,付款链接与二维码内容完全一致,更新插件即可解决。

Q:付款后订单一直待支付

确认插件会主动查单(每 8 秒一次);在易支付商户后台核对订单号与实收金额;检查插件与网关后台的商户 ID 是否同一环境;查看运行日志中查单返回的具体错误。

微信支付

Q:为什么 WordPress 只填三项,插件以前却要证书和公钥

WordPress 页面使用的是微信支付 API v2,本插件以前只实现 API v3。现在可以在“微信官方支付”中选择“简易 API v2”,只需 AppID、商户号和 API 密钥(v2),不需要证书。WordPress 会自动用网站域名生成通知地址;UniQQ 桌面插件没有公网域名,因此仍需手动填写公网 HTTPS 通知地址。

Q:API 密钥(v2)和 API v3 Key 是同一个吗

不是。两者在微信支付商户平台“API 安全”中分别设置,不能混用。简易 API v2 填 32 位 API 密钥(v2),高级 API v3 才填写 API v3 Key。

Q:微信支付为什么只有二维码,没有普通网页链接

Native 支付通常返回 weixin:// 协议内容,它用于生成二维码,不是标准 HTTP 网页。用户需要用微信扫码。其他渠道返回 HTTP/HTTPS 地址时,机器人会显示可点击链接。

Q:微信下单提示通知地址错误

通知地址必须是公网可访问的 HTTPS 地址,证书有效,不能使用 localhost、局域网 IP 或普通 HTTP。

邮箱与发货

Q:SMTP 登录失败

确认邮箱已开启 SMTP;填写的是授权码而不是网页登录密码;主机、端口和安全模式配套;账号没有触发异地登录或安全限制。

Q:邮件标题变成商品说明

检查邮箱设置中的“主题模板”。发件昵称、主题模板、正文模板是三个独立字段。商品说明只应通过正文变量出现。保存后发送测试邮件验证。

Q:发货消息只显示「发货附加话术」,卡密、商品说明、使用教程和售后说明都没有

发货消息内容完全由「发货设置 → 发货消息模板」决定,商品「发货附加话术」是渲染后自动追加的。模板被清空(例如被云端同步覆盖)时就只剩附加话术。0.1.0 起插件加载配置时会自动恢复默认模板,更新插件并重启即可;也可以在发货设置中手动粘贴模板,确保包含 {卡密内容}、{商品说明}、{使用教程}、{售后说明} 等变量。若个别段落仍为空,检查商品编辑页对应字段是否已填写。

Q:临时会话消息显示「该消息类型暂不支持查看」

旧版本发送的消息格式与部分 QQ 客户端不兼容,0.0.15 起发货消息已改为纯文本发送,更新插件即可。

Q:用户没加机器人好友,怎么发卡密

让用户在下单时填写邮箱,插件会优先邮件发货。没有邮箱或邮件失败时,再尝试私聊和群临时会话;全部失败才在群内提醒联系管理员。不要在群内直接公开卡密。

Q:支付成功后群里没有提示

检查“欢迎语与群组”中该群的支付成功提示开关,确认订单确实通过验签并进入已支付状态,再看运行日志是否有群消息发送失败。

Q:二维码没有被撤回

确认该群开启自动撤回,机器人有撤回自身消息能力,并且消息仍在平台允许的撤回时间内。撤回失败不影响支付确认和发货,日志会记录原因。

指令与群组

Q:发送“购买”没有回复

依次检查全局售卡开关、当前群开关、购买触发词、商品上架状态、库存和适用群。修改指令后要保存配置。

Q:自定义触发词后旧指令还能用吗

以保存后的触发词列表为准。需要兼容旧词时,把新旧词都保留并用逗号分隔。

Q:用户能关闭别人的订单吗

普通用户只能操作属于自己的待支付订单。管理员权限由系统设置中的管理员 QQ 决定。

订单与售后

Q:用户付款了但订单一直待支付

点击主动查单,在商户后台核对订单号和金额,查看日志中的验签、时间、网络和权限错误。不要只凭截图直接确认到账。

Q:补发会不会再扣一张卡

不会。补发应复用订单原来已分配的卡密,不重复扣减库存。

Q:误点确认到账怎么办

立即核对订单和商户后台。如果实际未收款但已经出库,应先停止该订单后续操作、记录已发出的卡密并按业务规则作废或冻结,然后检查管理员权限,避免再次误操作。

仍然无法解决时要准备什么

请整理以下信息再排查:

  • 插件版本与 UniQQ 版本;

  • 发生时间;

  • 订单号;

  • 使用渠道;

  • 订单状态;

  • 运行日志完整错误;

  • 商户后台是否有该订单及其金额。

隐藏私钥、KEY、授权码、完整卡密和完整邮箱后再提供截图。官网:https://blog.zxiaolin.com

共 11 篇 ZL-售卡插件 / 常见问题FQA 0 字 0 行 zhangxiaolin
创建 2026-09-23T09:10:35.089244310Z 更新 2026-09-29T04:19:27.209269247Z