For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /zh/docs/web/billing.md (or send Accept: text/markdown).
支付与订阅
Stripe 结账、套餐管理与 entitlement 边界。
选择并测试您的支付服务
计费处理付款。访问权限作为权利单独存储。完成持久帐户设置，然后在正在运行的 Web 应用程序中打开 /billing 以查看计划界面。通过 BILLING_PROVIDER=local，您正在探索当地行为而不是收集真金白银。
选择一个受支持的支付提供商，按照其设置指南进行操作，创建您自己的测试产品和价格，并将指定的服务器设置复制到 apps/web/.env.local. 中，保存并重新启动 Web 服务器。使用该提供商的沙箱指令完成一项签出，然后在提供商的 Webhook 到达后检查工作区的访问状态。 Webhook 是提供商向您的服务器发送的有关付款事件的签名消息。
仅成功页面并不能解锁功能。如果结帐完成但访问仍处于非活动状态，请在重复付款之前检查提供商的 Webhook 传送和服务器的事件处理。测试取消和过期访问也是如此。手机购买使用单独的 RevenueCat/商店设置，而不是此 Web 结帐。
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 边界之后。