使用Stripe实现订阅功能需监听invoice事件及存储账单信息吗

一、使用Customer Portal是否还需要存储账单信息 #

使用Customer Portal确实可以大幅减少你需要本地存储的账单类数据，所有原始账单明细、缴费记录、发票资源都默认存储在Stripe侧，用户可以直接在Customer Portal自助查看、下载，你完全不需要把这类账单全量字段同步到自有数据库。
但你仍然需要存储少量和用户权限强关联的核心数据，不然无法实现自有系统的付费权限校验逻辑。

二、Webhook需要监听的事件清单 #

必选监听事件（覆盖基础订阅功能，不需要处理账单逻辑） #

• product.created、product.updated、price.created、price.updated：用于同步商品和定价数据到本地，避免每次展示套餐都调用Stripe接口，降低接口延迟和调用失败风险
• checkout.session.completed：用户首次完成订阅付款的回调，用于绑定你的本地用户ID和对应Stripe客户ID、订阅ID，完成首次权限开通
• customer.subscription.created、customer.subscription.updated、customer.subscription.deleted：订阅状态变更的核心回调，不管是用户在Customer Portal修改套餐、取消订阅、欠费停服还是自动续期，都会触发该类事件，你只需要同步订阅的状态、生效时间、到期时间到本地即可完成权限更新，不需要处理invoice相关逻辑

可选监听事件（仅特殊需求下需要） #

invoice相关的事件只有你需要自定义账单相关逻辑时才需要监听，比如给用户发送自定义模板的缴费提醒、内部自研营收统计系统等，否则完全可以不监听。Stripe会默认处理账单发送、欠费提醒、Customer Portal账单同步等逻辑。
你参考的示例仓库没有监听invoice类事件，就是因为它仅实现基础的订阅权限控制逻辑，刚好符合你减少账单存储的需求。

三、需要存储到自有数据库的最小数据集 #

你完全可以做到不存储任何纯账单类数据，仅需要存储以下核心字段：

• 本地用户ID与Stripe客户ID的映射关系：调用Customer Portal、后续查询用户订阅信息都需要该映射
• 订阅核心字段：订阅ID、订阅状态、订阅生效时间、订阅到期时间、关联的价格ID：用于付费功能的权限校验
• 可选存储：商品名称、定价金额：用于页面快速展示用户当前套餐，避免频繁调用Stripe接口

不需要存储的内容包括但不限于：账单ID、账单金额、缴费记录、发票地址等纯账单类数据，这类数据需要使用时可以实时调用Stripe接口获取，或者引导用户直接到Customer Portal查看。

内容的提问来源于stack exchange，提问作者fred jones