订阅与卡密
订阅是什么
订阅表示某个客户在一段时间内拥有某个套餐。
当客户拥有订阅后，相关功能和额度才会生效。
订阅链模型
柚卡把同一客户、同一套餐组（group）下的套餐视为一条订阅链。
统一规则如下：
- 同一套餐组同一时刻最多只有一个生效套餐
- 相同套餐组的购买行为会修改同一条时间链
- 不同套餐组的套餐彼此独立，可以同时生效
- 没有过期时间的订阅会在接口里表现为
validTo=null，这类订阅必须位于链尾
这意味着“基础版、专业版、企业版”如果属于同一套餐组，它们是互斥关系；而“主套餐”和“加购包”通常应放在不同套餐组。
续费、升级、降级
同组内的常见行为如下：
- 同套餐续费：直接延长当前订阅
- 有限时升级：当前套餐立即结束，剩余价值按“旧套餐面值 / 新套餐面值”折算成新套餐时长
- 有限时降级购买：不会立刻生效，而是排到当前链尾
- 永久套餐升级到限时高级：高级期内临时覆盖，到期后自动恢复原永久套餐
- 永久高级后再买同组低级：系统会拒绝，避免无意义的冲突链
免费套餐
免费套餐通常用于基础权限兜底。
系统会自动为客户分配项目下的免费套餐，但同一 group 下只允许存在一个免费套餐。
如果客户已有同组永久免费基础计划，再购买同组限时高级计划：
- 高级计划立即生效
- 基础计划在高级期内被覆盖
- 高级计划到期后，基础计划自动恢复
卡密是什么
卡密是开通套餐的一种方式。客户兑换卡密后，平台会把对应套餐开通给目标客户。
适合：
- 软件授权
- 线下售卖后线上开通
- 活动发码
- 渠道分发
卡密兑换后会发生什么
一次成功兑换通常会带来两个结果：
- 目标客户被确认或自动创建
- 对应套餐被开通或续期
卡密兑换不会绕过续费规则。兑换得到的套餐和直接调用激活接口遵循完全相同的订阅链逻辑。
自动创建客户
如果项目允许自动创建客户，兑换接口可以在客户不存在时自动建客并完成开通。
这类场景很适合：
- 客户第一次使用产品时输入激活码
- 渠道发码后用户自行完成激活
接入建议
- 如果你的业务已经有稳定用户体系，推荐显式传入客户标识
- 如果你的激活流程希望更简单，可以启用自动建客
- 同一销售层级的套餐建议放在同一个套餐组
- 附加包、赠送包、独立模块建议拆到不同套餐组
- 兑换成功后，建议立即刷新客户的本地授权状态