You need to enable JavaScript to run this app. Stripe Laravel下按仓储用量实现自定义月度计费的方案咨询
优惠活动
大模型
产品
解决方案
定价
更多

Stripe Laravel下按仓储用量实现自定义月度计费的方案咨询

基于Laravel+Stripe的动态月度仓储计费实现方案

你可以直接使用Stripe自带的**计量型订阅(Metered Billing)**能力实现动态计费,不需要完全自定义计费逻辑,配合Laravel官方的Cashier扩展即可快速落地,具体实现方案如下:


实现步骤

方案1:按计费维度拆分计量价格(推荐)

对应你给出的两个计费因子,直接在Stripe配置两个独立的计量价格,每月上报实际用量后Stripe自动核算费用:

  1. Stripe后台配置
    • 创建产品:名称可设为「月度仓储履约服务」,计费周期选「月」
    • 给该产品添加2个计量型价格:
      • 价格1:单价3.75美元,计量维度为「履约ftes数量」,计价方式选「按实际用量结算」
      • 价格2:单价12美元,计量维度为「订单总体积(立方英尺)」,计价方式选「按实际用量结算」
    • 保存两个价格的ID,后续Laravel代码中会用到
  2. Laravel端配置
    直接使用Laravel官方维护的Cashier扩展对接Stripe,无需第三方库:
    • 安装扩展:composer require laravel/cashier
    • 按照扩展要求配置Stripe密钥、Webhook回调等基础参数
    • 给用户开通订阅时绑定两个计量价格,示例代码:
    $user->newSubscription('warehouse_service', [
        'price_xxxxxx', // 替换为3.75美元对应的价格ID
        'price_yyyyyy'  // 替换为12美元对应的价格ID
    ])->create($user->defaultPaymentMethod());
    
  3. 月度用量上报
    用Laravel任务调度在每月结算前批量统计用户当月实际用量,上报到Stripe即可:
    // 统计用户当月ftes总数
    $monthlyFtes = $user->ftes()->whereMonth('created_at', now()->month)->count();
    // 计算当月总订单体积
    $monthlyVolume = $monthlyFtes * $singleFtesVolume; // 按业务规则获取单个ftes体积
    
    // 上报ftes用量
    $user->subscription('warehouse_service')->reportUsage(
        quantity: $monthlyFtes,
        price: 'price_xxxxxx'
    );
    // 上报体积用量
    $user->subscription('warehouse_service')->reportUsage(
        quantity: $monthlyVolume,
        price: 'price_yyyyyy'
    );
    
    上报完成后Stripe会自动核算当月总费用,生成账单并发起自动扣款。

方案2:自定义发票项(适合后续计费规则频繁调整的场景)

如果不想在Stripe后台配置多个价格,可以直接把所有计费逻辑放在业务代码中实现,每月结算前给订阅发票添加自定义费用项即可:

  1. Stripe后台创建一个0美元的固定月度价格,作为订阅的基础价格
  2. 给用户开通订阅时绑定该0美元价格
  3. 每月结算前自行计算当月总费用,添加到订阅发票中:
    $monthlyFtes = $user->ftes()->whereMonth('created_at', now()->month)->count();
    $monthlyVolume = $monthlyFtes * $singleFtesVolume;
    // 计算总费用,注意Stripe以最小货币单位(美分)计价,所以要乘以100
    $totalAmount = (3.75 * $monthlyFtes + 12 * $monthlyVolume) * 100;
    
    // 添加自定义费用项到当月订阅发票
    $user->subscription('warehouse_service')->createInvoiceItem([
        'amount' => $totalAmount,
        'currency' => 'usd',
        'description' => "{$monthlyFtes}件履约服务 总容积{$monthlyVolume}立方英尺"
    ]);
    
    Stripe月度结算时会自动收取该自定义费用项的金额,无需其他配置。

适配开发库推荐

优先使用Laravel官方的Cashier扩展,该扩展由Stripe官方参与维护,完全适配Stripe所有订阅、发票能力,不需要额外引入第三方库,避免后续兼容问题。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.14 19:06:03