积分商城
积分商城允许用户使用积分兑换后台配置的商品。当前支持卡密、会员续费和求片次数三类商品。
开启商城
后台入口：配置中心 -> 积分与签到。
启用商城前，请依次确认：
- 已开启
积分系统。 - 已开启
积分商城。 - 如需在用户中心显示入口，已开启
用户端显示商城入口。
积分商城 控制商品浏览和购买；关闭后，用户不能再查看商品或购买。用户端显示商城入口 只控制导航是否显示，不会删除商品或历史订单。商城关闭时，用户仍可从已有订单页面查看自己的历史订单。
管理商品
后台入口：运营 -> 积分商城。运营 -> 商城订单 用于查看所有订单和已交付内容。
新建商品时需要填写名称、所需积分、排序和商品类型。商品可先保存为未上架状态，准备完成后再上架；下架后不能被用户继续购买。
商品图片为可选项，支持 jpg、png、webp，单个文件最大 5MB。商品说明支持富文本和图片，可用于补充兑换规则、使用期限或交付说明。
已有关联订单或卡密库存的商品不能删除，建议改为下架以保留历史记录。
商品类型
| 类型 | 配置内容 | 交付方式 | 库存来源 |
|---|---|---|---|
| 卡密商品 | 不需要额外商品配置 | 用户购买后在订单详情查看卡密 | 导入已有卡密 |
| 直接续费 | 续费天数 | 购买后立即为当前用户续费 | 商品中填写可售库存 |
| 可用求片次数 | 发放次数 | 购买后立即增加当前用户的求片次数 | 商品中填写可售库存 |
非卡密商品的库存为可售份数；库存为 0 时用户端会显示售罄。卡密商品的库存由已导入且未交付的卡密数量计算，不能直接填写库存数。
导入卡密库存
在对应的卡密商品中选择 卡密库存，可按已有批次号导入系统卡密，或逐行粘贴卡密。单次最多粘贴或按批次导入 1000 条卡密，服务端会按每 100 条分批处理。
按批次导入时，系统卡密必须已启用、从未使用且未过期；卡密类型和最大可用次数不限制。逐行粘贴时会优先关联同编码的系统卡密；系统中不存在时会作为外部卡密保存。商城库存已有编码会逐条跳过，同次其他卡密继续导入，后台会显示每项跳过原因。用户购买后，卡密会随订单交付。
用户购买
用户中心和 Telegram Mini App 都使用同一套商城、库存和订单数据。
用户可在商城中查看已上架商品，进入详情确认后购买。购买需要同时满足：
- 积分系统和商城均已开启；
- 商品仍处于上架状态；
- 商品库存充足；
- 当前用户积分不少于商品价格。
购买成功后会立即扣减相应积分，并创建订单。卡密在订单详情中展示；直接续费和求片次数会立即生效。网络中断后重新提交同一笔购买不会重复扣积分或重复交付。
订单与售后核对
用户订单
用户可在商城页点击 我的订单 查看自己的订单，并进入订单详情核对商品、所用积分、完成时间和交付内容。
管理员订单
管理员可在 运营 -> 商城订单 按订单号、商品、购买账号和下单时间筛选。查看订单详情时可以核对交付的卡密、续费结果或求片次数。
积分商城不会提供退款或回滚操作。需要处理异常订单时，请先核对订单详情、积分流水和实际交付结果，再按现有积分管理、会员管理或求片管理流程处理。
常见情况
用户看不到商城入口
检查 积分系统、积分商城 和 用户端显示商城入口 三个开关。前两个开关必须开启；入口开关关闭时，导航中不会显示商城。
商品显示售罄
非卡密商品需要增加商品库存；卡密商品需要在对应商品的 卡密库存 中导入更多符合条件的卡密。
卡密无法导入或兑换
按批次导入时，系统卡密必须启用、从未使用且未过期；卡密类型和最大可用次数不受限制。商城库存已有编码会逐条跳过，同次其他卡密继续导入，后台会显示每项跳过原因。系统卡密在购买时仍会校验启用、未使用和未过期状态；未匹配系统卡密的粘贴内容会作为外部卡密发放。