本文从概念层面详细说明如何为独立网站接入 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 用户发起订阅
- 用户在前端选择计划
- 前端通知后端:“我要订阅这个价格”
- 后端向 Stripe 创建 Checkout Session(携带价格 ID 和用户信息)
- Stripe 返回一个支付页面链接
- 前端把用户重定向到 Stripe 支付页面
- 用户在 Stripe 页面完成支付
- 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 用户自助管理
- 用户在你的网站点击“管理订阅”
- 后端向 Stripe 创建 Customer Portal 会话
- 用户跳转到 Stripe 托管的门户页面
- 用户取消、更新卡、切换计划
- Stripe 再次通过 Webhook 通知你的后端
- 后端更新本地状态
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. 你需要重点处理的关键问题
-
关联用户账号与 Stripe Customer
必须能根据 Webhook 里的 Customer ID 找到你的用户。 -
以 Webhook 为准,不以跳转为准
用户跳转回来可能失败,状态更新必须依赖 Webhook。 -
明确取消策略
- 取消后立即失效?
- 还是当前周期结束后失效?
-
支付失败处理
Stripe 会自动重试,你的网站需要根据past_due等状态决定是否限制访问。 -
权限模型
什么状态算“有效订阅”?如何处理试用期、宽限期?
7. 推荐路径(由简到繁)
最简方案(推荐大多数独立网站):
- 使用 Stripe Checkout 发起订阅
- 使用 Customer Portal 做自助管理
- 通过 Webhook 同步状态到你的数据库
- 你的网站只负责展示计划 + 根据状态控制权限
优点:开发量小、合规压力低、用户体验由 Stripe 保证。
8. 注意事项
- 先用测试模式跑通完整流程,再切到正式模式。
- 从不存储卡号。
- 定期对账,确保本地状态与 Stripe 一致。
- 考虑税务、优惠券、年付折扣、试用期等配置(可在 Stripe 后台完成)。
- 支付失败时及时通知用户更新支付方式。
9. 总结
接入 Stripe 订阅的本质是完成以下闭环:
- 在 Stripe 定义产品和价格
- 引导用户通过 Stripe Checkout 完成订阅
- 通过 Webhook 把订阅状态同步到你的数据库
- 根据数据库中的状态控制用户权限
- 提供 Customer Portal 让用户自助管理订阅生命周期
Stripe 承担支付处理、合规、发票、失败重试等复杂工作。
你的核心任务是:把 Stripe 的订阅状态与你网站的用户权限正确连接起来。
理解组件关系、信息传递方式和数据保存位置后,再进入具体开发会清晰很多。