You need to enable JavaScript to run this app. Stripe结合Laravel Cashier如何实现订阅升降级及避免重复订阅?
优惠活动
大模型
产品
解决方案
定价
更多

Stripe结合Laravel Cashier如何实现订阅升降级及避免重复订阅?

重复订阅拦截实现

现有代码未接入Laravel Cashier的订阅状态校验能力,可从后端接口层、Stripe服务端兜底两层做拦截:

  • 接口前置校验:在创建Checkout会话的逻辑入口,先查询用户所有有效订阅状态
    $validSubscriptions = $user->subscriptions()
        ->where('stripe_status', '!=', 'canceled')
        ->where(fn($q) => $q->whereNull('ends_at')->orWhere('ends_at', '>', now()))
        ->get();
    
    校验规则可根据业务需求灵活配置:
    • 如果业务要求用户全局只能持有一个生效订阅,只要$validSubscriptions集合非空,直接中断请求返回错误提示,禁止创建新的Checkout会话
    • 如果仅需要限制同套餐重复订阅,就遍历集合判断当前请求传入的stripe_price_id是否与已有订阅的price_id匹配,匹配则直接返回错误
  • Stripe侧兜底校验:仅靠接口层校验无法完全避免恶意绕过请求,需要在订阅创建的webhook回调中做二次校验:当收到Stripe推送的订阅创建成功事件时,再次核对用户的有效订阅数量,若超过业务规则允许的上限,主动调用Stripe接口取消新生成的订阅,触发全额退款,从服务端层面堵上漏洞。
    不要仅依赖前端按钮置灰做重复订阅拦截,所有校验逻辑必须落在后端代码层。
套餐升降级实现

不需要走重新创建Checkout会话的流程,直接利用Stripe原生的订阅变更能力即可:

  • 前置配置:确保所有套餐对应的stripe_price_id与本地套餐表做持久化关联,不要每次请求动态生成新的Price实例
  • 核心变更逻辑:调用Laravel Cashier封装的订阅切换方法,无需手动拼接Stripe接口参数
    // 获取用户当前的默认有效订阅
    $currentSubscription = $user->subscription('default');
    // 传入目标套餐对应的price_id,自动完成补差价、按比例折算剩余周期费用的计算
    $currentSubscription->swap($targetPriceId);
    
  • 自定义配置:
    • 若需要升降级操作即时触发账单扣费,直接使用swap方法即可,Stripe会自动生成对应账单从用户绑定的支付方式扣款
    • 若需要升降级操作在当前订阅周期结束后自动生效,可将变更操作的目标price_id写入订阅的元数据,配合定时任务在当前订阅到期的webhook触发时执行切换逻辑,避免中途触发扣费影响用户体验
  • 注意事项:
    • Stripe原生的订阅切换逻辑仅支持同计费周期(比如月付换月付)的价格变更,跨周期(月付换年付)的变更需要先终止当前订阅,再重新创建新的订阅实例
    • 所有订阅变更操作完成后,必须同步更新本地数据库的订阅状态字段,避免本地与Stripe侧的状态不一致导致的业务异常

内容的提问来源于stack exchange,提问作者Vince Carter

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.06 16:57:03