SuperAPI AI 工具集

integrating-stripe-webhooks

通用与其它

查看项目

更新于 10-16 00:30

技能介绍

用途:在实现 Stripe Webhook 端点时,解决签名验证失败、原始请求体不可用、订阅周期字段缺失、路由 404 及 URL 编码等问题。

主要能力:给出各框架获取原始请求体的方案,强调先取原始字节再调用 constructEvent 验证签名;说明订阅周期字段位于 subscription.items.data[0] 而非根对象;指出 Webhook 路由需注册在 API 前缀内;提示动态参数需用 encodeURIComponent() 编码。

使用方式:Fastify 在注册路由前用 addContentTypeParser 以 buffer 解析并保存 rawBody;Express 在 express.json() 之前用 express.raw({ type: 'application/json' }) 定义 Webhook 路由;FastAPI 用 await request.body() 而非 .json()。本地测试可安装 Stripe CLI,执行 stripe listen --forward-to localhost:3000/api/v1/webhooks/stripe,并用 stripe trigger customer.subscription.created 等触发事件。

适用场景:新建或调试 Stripe Webhook 端点、处理订阅事件、排查签名与路由问题。

限制:不适用于一般 Stripe API 集成、前端 Stripe Elements 或 Checkout Session 创建;具体框架版本与部署环境差异需自行验证,资料未提供收费与平台信息。