用途:根据项目技术栈构建 Stripe 支付流程,帮助在托管结账、嵌入式自定义界面与订阅模式之间做出选择。
方案对应:最快、托管的方案用 Stripe Checkout(checkout.sessions.create);嵌入式自定义 UI 用 Payment Element + PaymentIntent/SetupIntent;周期扣费使用 subscription 模式。
Checkout Session 要点:mode 设为 subscription;line_items 用 price 加 quantity;使用 customer 或 customer_email(复用已有客户以避免重复创建);配置 success_url 与 cancel_url;启用 allow_promotion_codes: true;在 subscription_data metadata 中写入 user_id;若使用 Stripe Tax 则启用 automatic_tax。
关键规则:先查已有 stripe_customer_id 复用客户;套餐变更用 subscriptions.update(按比例计费),不要创建第二个订阅;在 metadata 里传 user_id 供 webhook 开通使用;服务端校验价格,对 price ID 采用白名单。
验证方式:用 stripe_implementation_planner(MCP)做架构规划;用测试卡测试;通过 webhook-implementation 确认。
限制:资料未说明具体费用、价格、支持平台与完整代码示例,这些暂未提供。