SuperAPI AI 工具集

webhook-implementation

编程与开发

查看项目

更新于 10-15 16:51

技能介绍

用途:为项目实现或修复 Stripe webhook 处理器,覆盖签名验证、事件路由、幂等设计和可重试处理。会先匹配项目技术栈,或询问用户采用哪种形态(Next.js 路由、Express、Supabase 边缘函数)。

必备要点:签名验证需使用原始请求体,不能先做 JSON 解析;调用 stripe.webhooks.constructEvent(body, sig, secret);用 event.id 做幂等去重(保存已处理的 ID);快速返回 200,耗时工作异步执行;只处理已订阅的事件,其余优雅忽略。

订阅型 SaaS 的核心事件与处理动作:checkout.session.completed 开通访问权限并保存 customer/订阅 ID;customer.subscription.updated 同步套餐与状态;customer.subscription.deleted 撤销访问;invoice.payment_failed 触发催款邮件或横幅;invoice.paid 确认续费。

处理模式(伪代码):event = constructEvent(rawBody, sig, secret);若 alreadyProcessed(event.id) 则返回 200;按 event.type 分支处理;标记 markProcessed(event.id);返回 200。

验证方式:使用 Stripe CLI 的 stripe listen / stripe trigger,或部署后检查 webhook-reliability。

限制:资料未提供具体定价、平台范围或额外功能说明。