Stripe Laravel下按仓储用量实现自定义月度计费的方案咨询
基于Laravel+Stripe的动态月度仓储计费实现方案
你可以直接使用Stripe自带的**计量型订阅(Metered Billing)**能力实现动态计费,不需要完全自定义计费逻辑,配合Laravel官方的Cashier扩展即可快速落地,具体实现方案如下:
实现步骤
方案1:按计费维度拆分计量价格(推荐)
对应你给出的两个计费因子,直接在Stripe配置两个独立的计量价格,每月上报实际用量后Stripe自动核算费用:
- Stripe后台配置
- 创建产品:名称可设为「月度仓储履约服务」,计费周期选「月」
- 给该产品添加2个计量型价格:
- 价格1:单价3.75美元,计量维度为「履约ftes数量」,计价方式选「按实际用量结算」
- 价格2:单价12美元,计量维度为「订单总体积(立方英尺)」,计价方式选「按实际用量结算」
- 保存两个价格的ID,后续Laravel代码中会用到
- 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()); - 安装扩展:
- 月度用量上报
用Laravel任务调度在每月结算前批量统计用户当月实际用量,上报到Stripe即可:
上报完成后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' );
方案2:自定义发票项(适合后续计费规则频繁调整的场景)
如果不想在Stripe后台配置多个价格,可以直接把所有计费逻辑放在业务代码中实现,每月结算前给订阅发票添加自定义费用项即可:
- Stripe后台创建一个0美元的固定月度价格,作为订阅的基础价格
- 给用户开通订阅时绑定该0美元价格
- 每月结算前自行计算当月总费用,添加到订阅发票中:
Stripe月度结算时会自动收取该自定义费用项的金额,无需其他配置。$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}立方英尺" ]);
适配开发库推荐
优先使用Laravel官方的Cashier扩展,该扩展由Stripe官方参与维护,完全适配Stripe所有订阅、发票能力,不需要额外引入第三方库,避免后续兼容问题。
内容的提问来源于stack exchange,提问作者Abby
相关产品推荐
相关产品推荐

