订阅生命周期

订阅不是"付钱就完了"——试用、激活、续费、升降级、取消、过期，每一步都有对应的状态和处理逻辑。Pay4SaaS 把这整套生命周期都管理好了。

状态流转

                      ┌─────────┐
                      │ pending │  ← 发起结账
                      └────┬────┘
                           │
                ┌──────────┴──────────┐
                ▼                     ▼
          ┌──────────┐          ┌──────────┐
          │ trialing │──付款──▶│  active  │◀── 续费成功 / 恢复订阅
          └──────────┘          └────┬─────┘
                                     │
                 ┌───────────┬───────┼───────┬───────────┐
                 ▼           ▼       ▼       ▼           ▼
           ┌───────────┐ ┌────────┐ ┌──────┐ ┌────────┐
           │ canceling │ │ paused │ │expired│ │past_due│→ 按 expired 处理
           └─────┬─────┘ └────────┘ └──────┘ └────────┘
                 │
                 │ 到期
                 ▼
           ┌──────────┐
           │ canceled │
           └──────────┘

各状态说明

状态	说明	用户能否使用服务
`pending`	已发起结账，等待支付	否
`trialing`	试用期中	是（无限订阅模式下可用）
`active`	已付费，正常使用	是
`canceling`	用户已取消，但当前周期未到期	是（到期前仍可使用）
`canceled`	已取消且已到期	否
`expired`	已过期（付款失败或自然到期）	否
`paused`	支付平台暂停了订阅，防止平台侧已停止扣款但用户仍能使用	否
`past_due`	付款逾期，系统直接按过期处理	否

试用期

配置试用期后（见定价模式），用户首次订阅时可以免费试用。

关键规则：

每个用户只能试用一次，系统通过 trial_start 字段追踪
已试用过的用户再次订阅时，系统自动使用无试用版本的商品 ID
试用期间，无限订阅模式下用户可以正常使用服务
配额订阅模式下，没有试用这一回事，但你可以给用户送积分体验。
试用期结束后自动扣款，扣款成功则转为 active

升级与降级

系统通过比较实际价格来判断升级还是降级：新价格 > 当前价格 = 升级，反之 = 降级。

升级（立即生效）

新计划立即生效
支付方式自动按比例计算差价（prorated）
配额订阅模式下，配额按新计划重置

降级（下个周期生效）

当前周期不变，保留原计划权益
系统写入 pending_plan_type 和 pending_plan_billing_cycle
下次续费 Webhook 到达时，自动应用降级
配额订阅模式下，当前周期保留原配额

前端可以通过 status.details 查看待生效的降级信息：

const { status } = useAccess()

if (status.details.pendingPlanType) {
  console.log(`下个周期将切换为: ${status.details.pendingPlanType}`)
  console.log(`生效时间: ${status.details.pendingPlanEffectiveAt}`)
}