> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 支付与订阅

Stripe 结账、套餐管理与 entitlement 边界。

## 选择并测试您的支付服务

计费处理付款。访问权限作为权利单独存储。完成持久帐户设置，然后在正在运行的 Web 应用程序中打开 /billing 以查看计划界面。通过 BILLING_PROVIDER=local，您正在探索当地行为而不是收集真金白银。

选择一个受支持的支付提供商，按照其设置指南进行操作，创建您自己的测试产品和价格，并将指定的服务器设置复制到 apps/web/.env.local. 中，保存并重新启动 Web 服务器。使用该提供商的沙箱指令完成一项签出，然后在提供商的 Webhook 到达后检查工作区的访问状态。 Webhook 是提供商向您的服务器发送的有关付款事件的签名消息。

仅成功页面并不能解锁功能。如果结帐完成但访问仍处于非活动状态，请在重复付款之前检查提供商的 Webhook 传送和服务器的事件处理。测试取消和过期访问也是如此。手机购买使用单独的 RevenueCat/商店设置，而不是此 Web 结帐。

[选择计费适配器及其设置](https://supastack.dev/zh/docs/modules/billing-configuration.md)

[自行设定产品和价格](https://supastack.dev/zh/docs/web/project-structure.md)

[在测试环境中设置Stripe](https://supastack.dev/zh/docs/web/setup-payments.md)


## Web 计费

Web应用程序支持您使用BILLING_PROVIDER选择的计费提供商；条纹是一种选择。打开/计费网络计划和订阅管理。按照所选提供商的指南，在匹配的测试或实时环境中设置其仅服务器凭据、产品或价格 ID 以及 Webhook 验证设置。


## 通过权限授权

结账跳转不是访问已激活的证据。服务端持有的权限决定工作区能否使用付费能力。即使界面已经隐藏了该动作，也要在动作边界检查这个权限。


## 验证生命周期

用沙箱事件验证激活、更新、取消与 webhook 处理。保证重复事件安全，并确保失效的权限会阻止付费操作。原生移动购买仍是单独的 RevenueCat 集成边界。


## 安装与配置

套餐目录位于 src/product-plans.ts,驱动 /billing 界面和 /choose-plan 入门步骤。计费在服务器端配置:BILLING_PROVIDER=stripe、STRIPE_SECRET_KEY、每个套餐和周期的 price id,以及 STRIPE_WEBHOOK_SECRET。Lemon Squeezy 可作为替代适配器。

按席位计费的套餐使用可编辑的席位步进器（src/seat-count.ts），席位数量会随结账会话一起传递，使计费席位数与工作区保持一致。套餐还可以在 src/product-plans.ts 中声明 meteredUsage，由每小时运行的 billing.usage-report 任务将 usage_counter 增量上报至 Stripe 计费计量器；同时工作区所有者可在“设置 → 用量”（src/usage-meters.ts 中的 USAGE_METERS）中设置每月 AI 预算与各计量器的硬性上限。

```
Checkout: POST /api/billing/checkout
Portal:   POST /api/billing/portal
Webhook:  POST /api/billing/webhook  (signature-verified)
```


## 实现流程

结账重定向只是一个待定的意图 —— 当签名的 webhook 到达并且服务器拥有的 entitlement 更新时,访问权限才会改变。即使界面已经隐藏了付费操作,也要用服务器边界的 entitlement 检查(entitlement-gate.tsx / entitlement-check.ts)对其进行门禁。

客户门户管理套餐变更、取消和支付方式。让订阅状态对工作区成员可读,并将原生移动端购买放在单独的 RevenueCat 边界之后。


## 下一篇

[数据库与迁移](https://supastack.dev/zh/docs/web/database.md)