AI帮你把应用搭起来了,用户也来了,接下来该收钱了。这时候智能体通常会提议直接接 Stripe:建产品、做结账、写 webhook 端点、把订阅状态存进数据库、每个页面都加一道检查。这套做法能跑,但前提是这些零件彼此对得上。赶工出来的应用最经典的翻车方式,就是前端把付费按钮藏起来了,服务端路由却还敞着。
这里走的是 Payments 这条路,属于 Infrastructure 产品线,作者 Ciro Cesar Maciel。
一句话说清结构
一个项目持有若干网关;每个网关持有若干套餐;客户订阅某个套餐,就拿到与该套餐绑定的功能。应用从不问“这个用户订的是哪个套餐”,它问的是“这个用户有没有 advanced-reports 这项权限”。改套餐包含什么,不需要改代码。
周期性扣款发生在你自己的 Stripe 账户里:钱、发票、收据都在那边。Payments 负责组织套餐、跟随 Stripe 的事件追踪订阅状态,并告诉应用谁能做什么。
按步骤来
- 给智能体准备文档。https://myinfrastructure.click/products/payments/llms.txt贴给它。还没有账号?智能体会把账号和项目一起建好,你只需要读一下邮件里的验证码。
- 连 Stripe、建套餐。把 Stripe 密钥作为网关加进去。在 Payments 里创建一个套餐,Stripe 里也会同步创建(名称、价格、币种、按月或按年)。然后在 Features 下创建应用要检查的功能名,再把它们挂到套餐上。注意:Stripe 的测试密钥(sk_test_…)能连上,什么请求都回成功,但不会向任何人收钱。用“测试连接”可以看清这个网关处在哪个环境。
- webhook,一个都不能少。没有它,Stripe 那边扣了钱,这边没人知道:订阅永远不会出现,应用会一直把这个人当成未付费用户。自动配置会把地址注册到 Stripe。需要关注的事件有:结账完成、发票已付、支付失败、订阅更新、订阅删除。
- 智能体要写的代码。用 @ciromaciel/payments-react,一个 PaymentsProvider,带上项目的公钥、你自己稳定的 userId 和客户邮箱。然后是套餐列表(订阅者通过门户切换套餐,绝不走第二次结账)、带 fallback 的组件,以及管理卡片、发票和取消订阅的接口。
真正起保护作用的那道检查
浏览器里的东西,谁在浏览器里谁就能改。FeatureControl 和 useHasFeature 是给界面用的:隐藏、显示、引导升级。真正付费的内容本身——导出、报告、昂贵的那次调用——必须在服务端被拒绝。交付之前,后端去/sdk/v1/permissions查用户权限,这个接口返回是否存在有效订阅、以及哪些功能已解锁。
服务端那一行代码,就是付费墙和一个被藏起来的按钮之间的区别。
套餐变更
升级立即生效,Stripe 按比例收取差价。降级,或者从按年转按月,在已付费周期结束时生效。新套餐通过 webhook 送达,权限随之更新。
几句实话
- 你需要一个 Stripe 账户;Payments 不持有资金。
- 没有 MRR 或流失率,没有财务报表,没有优惠券,也没有自己的试用期:这些归 Stripe 管。
- 订阅只支持 Stripe。也支持一次性收款,走银行卡或 Pix(巴西)。
- 没有服务端 SDK:后端用项目的密钥调 HTTP API。
- 有一个 MCP 服务器,让智能体用你的浏览器登录状态读取项目、网关、套餐和订阅。
- Payments 的控制台目前是葡萄牙语。
热门跟贴