You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Stripe是否提供针对usage record的webhook事件通知?

回答

Stripe 针对 usage record(用量记录)定价模型提供了覆盖计费全流程的 webhook 推送,核心异步场景的通知能力是完整的。

首先要明确一个边界:单条 usage record 的创建、更新是业务方主动调用 Stripe API 完成的同步操作,Stripe 不会针对每一次单条用量上报单独推送 webhook。这类操作本身是你主动发起的,直接拿接口同步返回的结果处理后续业务即可,完全不需要依赖异步通知。

所有和用量计费相关的异步节点,都有对应的 webhook 事件可供监听,最常用的核心事件包括:

  • invoice.created
    订阅到达账单周期节点时,Stripe 会自动汇总周期内所有上报的 usage record、按定价规则核算用量生成待支付账单,完成这个动作后就会推送该事件。事件携带的账单对象包含完整的用量明细、分档单价核算结果、周期累计总用量、待扣费总金额,可直接用于内部账单对账、用量数据同步。
  • subscription_item.threshold_reached
    如果你给用量定价配置了用量告警阈值(比如设置单周期累计用量超过1000单位时触发提醒),当周期内累计上报的 usage record 达到预设阈值时就会触发该事件,适合做用户用量超额提醒、服务额度管控类逻辑。
  • 账单状态流转类事件
    用量账单生成后的扣费、状态变更流程和普通订阅场景的 webhook 逻辑完全兼容,你可以按需监听invoice.payment_succeeded(用量费用扣费成功)、invoice.payment_failed(用量费用扣费失败)、customer.subscription.updated(订阅因扣费异常、周期切换发生状态变更)等事件,覆盖从账单生成到扣费完成的全节点通知。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.29 16:12:28