SuperAPI AI 工具集

stripe-integration

编程与开发

查看项目

更新于 10-16 06:18

技能介绍

用途:为使用 Firebase Cloud Functions v2、Next.js(App Router)、React、TypeScript、MUI v7 的项目提供 Stripe 支付集成指导,覆盖支付、订阅与 Webhook。

主要能力:安装 npm install stripe 与 npm install --save-dev @types/stripe;配置 NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY、STRIPE_SECRET_KEY、STRIPE_WEBHOOK_SECRET 等环境变量,并用 firebase functions:secrets:set 设置函数密钥;前端通过 @stripe/stripe-js 初始化,后端创建 Stripe 客户端并指定 apiVersion;编写 Firebase Cloud Functions v2 与 Next.js App Router 两种 Webhook 处理端点,强调使用原始请求体校验签名、立即返回 200 后异步处理事件。

使用方式:部署可用 firebase deploy --only functions:stripeWebhook;在 Stripe Dashboard 添加端点并复制签名密钥;本地用 stripe listen --forward-to http://localhost:3000/api/webhooks/stripe 转发并配合 stripe trigger 触发测试事件;也可通过 Stripe MCP 查询客户、创建产品等测试数据。文中还给出创建 Checkout Session、管理订阅的示例及 TypeScript 类型用法。

限制与注意:签名密钥本地与生产不同;校验前不得解析请求体;需处理重复事件、不依赖事件顺序;测试与正式模式密钥资源需分离。具体收费与价格资料暂未提供。