SuperAPI AI 工具集

stripe-payments

通用与其它

查看项目

更新于 10-15 23:31

技能介绍

用途:为 Web 应用添加 Stripe 支付能力,覆盖一次性付款、订阅、Webhook、客户门户等常见模式,并提供可运行代码,无需 MCP 服务器。

主要能力与 API 选择:接受一次性付款用 Checkout Sessions(Stripe 托管支付页,复杂度低);在自有 UI 内嵌支付表单用 Payment Element + Payment Intents(中);循环计费用 Checkout Sessions 的 subscription 模式;保存卡用 Setup Intents;平台/市场分账用 Stripe Connect(高);让客户自助管理账单用 Customer Portal。默认建议从 Checkout Sessions 起步。

使用方式:安装 npm install stripe @stripe/stripe-js。密钥从 https://dashboard.stripe.com/apikeys 获取,测试密钥以 sk_test_、pk_test_ 开头,生产以 sk_live_、pk_live_ 开头。Cloudflare Workers 用 npx wrangler secret put STRIPE_SECRET_KEY 与 npx wrangler secret put STRIPE_WEBHOOK_SECRET 存为机密;本地开发写入 .dev.vars。服务端用 new Stripe(...) 初始化。创建 Checkout Session 时设置 mode、line_items、success_url、cancel_url;订阅用 mode: 'subscription',可加 subscription_data.trial_period_days 设试用。Webhook 必须校验签名,Workers 环境用 constructEventAsync(Web Crypto),不能用同步 constructEvent。本地用 stripe listen --forward-to http://localhost:8787/api/webhooks/stripe 转发,生产在 Dashboard 注册。客户门户通过 stripe.billingPortal.sessions.create 创建会话。定价页可调用 stripe.prices.list 读取产品或直接硬编码 price ID。

适用场景:SaaS 订阅、一次性收款、需要自助账单管理的产品。

限制与注意:金额以分为单位(2900 = $29.00);Webhook 失败 Stripe 最多重试 3 天,应尽快返回 200;订阅状态不要缓存;Checkout 跳转用 window.location.href 而非 fetch;回访用户用 customer 而非 customer_email。资料未提供具体收费与价格信息。