用途:在代码库之外完成 Stripe 相关配置,包括 Dashboard 设置、各部署环境变量与 Webhook 端点。
主要能力:引导创建产品与价格(按月、按年)并记录 price ID;创建指向生产 URL 的 Webhook 端点,使用规范域名(如 www,Stripe 不跟随重定向),启用所需事件并复制签名密钥;如使用 Customer Portal 可配置允许的操作与品牌。随后在所有部署目标设置环境变量,例如本地 .env.local 中的 STRIPE_SECRET_KEY、STRIPE_WEBHOOK_SECRET、NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY、NEXT_PUBLIC_STRIPE_PRICE_ID;Convex 使用 npx convex env set(生产加 --prod),如 npx convex env set STRIPE_SECRET_KEY "sk_test_...";Vercel 使用 vercel env add STRIPE_SECRET_KEY production 等。
用法:按流程先在 Dashboard(或尽量用 Stripe CLI)创建产品、价格、Webhook 与门户,再逐个部署目标写入环境变量,接着校验一致性:本地与 Convex dev 用测试密钥,Convex prod 与 Vercel prod 用实时密钥。可用 verify-env-parity.sh 或手工比对。关键一步是验证 Webhook URL 不重定向,可执行 curl -s -o /dev/null -w "%{http_code}" -I -X POST "https://your-domain.com/api/stripe/webhook",结果应为 4xx 或 5xx,不能是 3xx。
适用场景:为 Next.js + Convex + Vercel 一类项目接入 Stripe 支付与 Webhook 时,统一配置多环境。
限制与常见错误:资料未提供具体平台限制、价格或效果说明;需注意只在 dev 设置变量而忘记 prod、域名用了非 www 而应用在 www、密钥含尾部空白(用 printf '%s' 而非 echo)、生产用测试密钥或开发用实时密钥等。最终产出为已配置项清单。