SuperAPI AI 工具集

stripe

通用与其它

查看项目

更新于 10-16 03:41

技能介绍

用途:对 Stripe 集成做完整生命周期管理——审计现状、修复所有问题、验证结账流程端到端可用。每次运行都执行完整循环,没有部分模式。

主要能力: 环境检查:先运行 ~/.claude/skills/stripe/scripts/detect-environment.sh 对比应用的 STRIPE_SECRET_KEY 账户与 CLI profile,避免 CLI 创建的资源应用看不到。可修正 profile(stripe -p sandbox / stripe -p production)或调整 .env.local。 审计:使用 stripe-auditor 子代理并行分析配置(各部署环境变量、跨平台一致性)、Webhook 健康(endpoint 注册、URL 非 3xx、pending_webhooks=0)、订阅逻辑(试用、访问控制、幂等)、安全(无硬编码密钥、密钥不写日志)、商业模式合规、订阅管理 UX。可运行 ~/.claude/skills/stripe/scripts/stripe_audit.sh。先查 Stripe 文档确认当前最佳实践。 计划与执行:按严重程度分级(阻断结账、安全问题、UX 缺失),配置问题直接修,代码问题交给 Codex 处理并做类型检查与测试。 验证:检查环境变量、curl Webhook URL、用测试卡 4242 4242 4242 4242 走结账并核对订阅与数据库状态、检查 stripe events 的 pending_webhooks、验证设置页与 Stripe Portal。

必要用法与命令(保持原样): git checkout -b fix/stripe-$(date +%Y%m%d) bunx convex env set --prod CONVEX_WEBHOOK_TOKEN "..." vercel env add CONVEX_WEBHOOK_TOKEN production codex exec --full-auto "..." --output-last-message /tmp/codex-fix.md stripe events list --limit 5 | jq '.data[] | {id, type, pending_webhooks}'

关键不变量:CONVEX_WEBHOOK_TOKEN 必须在 Next 运行时与 Convex 环境一致(token parity),否则支付成功但权限不开放。仅配置改动可不建分支,代码改动需建分支。

商业模式约束:单一价格档、升级时保留试用(传 trial_end)、无 freemium(试用过期即无访问)。

适用场景与限制:默认栈为 Next.js + TypeScript + Convex + Vercel + Clerk,其他栈概念相同但框架细节需适配。该资料为技能说明,未提供收费、价格或效果数据。