本文从概念层面详细说明如何为独立网站接入 Stripe 订阅,重点解释各组件的关系、交互方式、信息传递方式以及数据保存位置。不涉及代码和具体实现细节。


1. 什么是 Stripe 订阅?

Stripe 订阅是一种周期性自动扣款机制。用户选择付费计划后,系统按约定周期(每月/每年)自动从支付方式扣款,并持续提供服务权限。

适合:SaaS、会员站、付费社区、课程订阅等。

核心分工:

  • Stripe:支付处理、发票、失败重试、合规、卡信息存储
  • 你的网站:产品展示、用户账号、权限控制、业务逻辑

2. 核心组件及关系

组件 职责 数据保存位置 与其他组件的关系
Stripe Dashboard 定义产品、价格、查看交易、配置 Webhook Stripe 云端 与所有组件交互的配置中心
Product / Price 你卖的东西和收费方案 Stripe 被 Checkout 和 Subscription 引用
Customer Stripe 中的客户记录 Stripe 与你网站的用户账号关联
Subscription 客户与价格的持续关系 Stripe 决定用户是否有权限的核心对象
Payment Method 信用卡等支付方式 Stripe(加密) 不直接暴露给你的网站
Invoice 每次扣款的账单 Stripe 用户可查看,你可对账
你的网站前端 展示计划、引导用户订阅 你的服务器 调用后端创建支付会话
你的网站后端 创建 Checkout、接收 Webhook、更新状态 你的服务器 与 Stripe 和数据库交互
你的数据库 存储用户账号与订阅状态对应关系 你的数据库 权限控制的依据
Webhook Stripe 主动通知状态变化 临时传递 从 Stripe 到你的后端
Customer Portal 用户自助管理页面 Stripe 托管 用户操作后通过 Webhook 同步

关系总结:

  • Stripe 是支付与订阅状态的权威来源
  • 你的数据库是业务权限的权威来源
  • Webhook 是两者之间的桥梁

3. 信息传递方式

3.1 用户发起订阅

  1. 用户在前端选择计划
  2. 前端通知后端:“我要订阅这个价格”
  3. 后端向 Stripe 创建 Checkout Session(携带价格 ID 和用户信息)
  4. Stripe 返回一个支付页面链接
  5. 前端把用户重定向到 Stripe 支付页面
  6. 用户在 Stripe 页面完成支付
  7. Stripe 重定向回你的网站(成功/取消页面)

传递方式:HTTP 请求(前端↔后端↔Stripe) + 浏览器重定向

3.2 状态同步(最重要)

支付成功后,Stripe 会主动通过 Webhook 通知你的后端:

常见事件:

  • checkout.session.completed:支付会话完成
  • customer.subscription.created:订阅创建
  • customer.subscription.updated:订阅变更(升级、取消等)
  • customer.subscription.deleted:订阅删除/到期
  • invoice.payment_succeeded:续费成功
  • invoice.payment_failed:续费失败

传递方式:Stripe → HTTP POST 到你的后端端点(带签名验证)

后端收到通知后,更新数据库中的用户订阅状态。

3.3 用户自助管理

  1. 用户在你的网站点击“管理订阅”
  2. 后端向 Stripe 创建 Customer Portal 会话
  3. 用户跳转到 Stripe 托管的门户页面
  4. 用户取消、更新卡、切换计划
  5. Stripe 再次通过 Webhook 通知你的后端
  6. 后端更新本地状态

4. 数据保存位置

数据 保存在哪 说明
产品、价格 Stripe 你在 Dashboard 定义
卡号、CVV 等敏感信息 Stripe(加密) 你的网站永不接触
Customer ID、Subscription ID Stripe + 你的数据库 数据库存关联关系
订阅状态(active/canceled/past_due 等) Stripe(权威)+ 你的数据库(同步副本) 以 Webhook 同步的数据库为准做权限判断
用户账号、登录信息 你的数据库 你的业务数据
发票、支付历史 Stripe 用户可在 Portal 查看
权限判断结果 你的网站运行时 根据数据库状态实时计算

关键原则:从不在自己的数据库里存储卡号。只存储 Stripe 的 Customer ID 和 Subscription ID,以及同步后的状态。


5. 完整交互流程(概念视角)

用户
  │
  ▼
[你的前端]  ——选择计划——►  [你的后端]
                              │
                              ▼ 创建 Session
                           [Stripe]
                              │
                              ▼ 返回支付链接
[你的前端]  ◄——重定向——────────────│
  │
  ▼
[用户在 Stripe 页面支付]
  │
  ▼
[Stripe]  ——创建 Customer + Subscription——►  [Webhook]
                                              │
                                              ▼
                                       [你的后端]
                                              │
                                              ▼ 更新状态
                                       [你的数据库]
                                              │
                                              ▼
                                       [你的网站根据状态控制权限]

6. 你需要重点处理的关键问题

  1. 关联用户账号与 Stripe Customer
    必须能根据 Webhook 里的 Customer ID 找到你的用户。

  2. 以 Webhook 为准,不以跳转为准
    用户跳转回来可能失败,状态更新必须依赖 Webhook。

  3. 明确取消策略

    • 取消后立即失效?
    • 还是当前周期结束后失效?
  4. 支付失败处理
    Stripe 会自动重试,你的网站需要根据 past_due 等状态决定是否限制访问。

  5. 权限模型
    什么状态算“有效订阅”?如何处理试用期、宽限期?


7. 推荐路径(由简到繁)

最简方案(推荐大多数独立网站):

  • 使用 Stripe Checkout 发起订阅
  • 使用 Customer Portal 做自助管理
  • 通过 Webhook 同步状态到你的数据库
  • 你的网站只负责展示计划 + 根据状态控制权限

优点:开发量小、合规压力低、用户体验由 Stripe 保证。


8. 注意事项

  • 先用测试模式跑通完整流程,再切到正式模式。
  • 从不存储卡号。
  • 定期对账,确保本地状态与 Stripe 一致。
  • 考虑税务、优惠券、年付折扣、试用期等配置(可在 Stripe 后台完成)。
  • 支付失败时及时通知用户更新支付方式。

9. 总结

接入 Stripe 订阅的本质是完成以下闭环:

  1. 在 Stripe 定义产品和价格
  2. 引导用户通过 Stripe Checkout 完成订阅
  3. 通过 Webhook 把订阅状态同步到你的数据库
  4. 根据数据库中的状态控制用户权限
  5. 提供 Customer Portal 让用户自助管理订阅生命周期

Stripe 承担支付处理、合规、发票、失败重试等复杂工作。
你的核心任务是:把 Stripe 的订阅状态与你网站的用户权限正确连接起来。

理解组件关系、信息传递方式和数据保存位置后,再进入具体开发会清晰很多。