使用Next.js与Appwrite对接Stripe订阅时的Webhook端点配置问题

一、Webhook端点配置 #

• 在Stripe后台配置Webhook时，端点地址需填写你的Appwrite Function执行URL，格式为：https://appwrite.test.rs/v1/functions/[你的函数ID]/executions
• 替换[你的函数ID]为你在Appwrite控制台创建的订阅函数实际ID
• 同时在Stripe后台勾选需要监听的订阅相关事件，比如customer.subscription.created、invoice.paid、customer.subscription.deleted等

二、签名验证错误的解决 #

你遇到的StripeSignatureVerificationError错误，核心原因是直接调用/webhook路径时未携带Stripe专属的stripe-signature请求头：

• 该请求头是Stripe官方发送Webhook时自动生成并携带的，手动调用或非Stripe发起的请求不会包含此头，因此触发验证失败
• 不要手动调用该Webhook端点，应通过Stripe后台的事件触发，或使用Stripe CLI模拟发送Webhook请求测试（Stripe CLI会自动添加正确的签名头）
• 确保Appwrite Function的环境变量中已正确配置STRIPE_WEBHOOK_SECRET，这个密钥需从Stripe后台的Webhook设置中获取

内容的提问来源于stack exchange，提问作者devFl