Stripe Webhook Signature Verification Failed: No signatures found matching the expected signature for payload

VERIFIED WAYPOINT ⚡ Saves ~62,000 tokens ($0.22) Category: Payments & Webhooks

🎯 Target Goal & Friction

Goal: Verify Stripe Webhook signature in Next.js 15 App Router

Error Signature: Webhook signature verification failed: No signatures found matching the expected signature for payload

⚡ Direct Teleport Deep Link (0ms Navigation)

https://dashboard.stripe.com/test/webhooks →

Agents skip UI exploration menus by navigating directly to this endpoint.

Verified Code / Configuration Diff

@@ app/api/webhooks/stripe/route.ts @@
- const body = await req.json();
+ const rawBody = await req.text(); // MUST read as raw string
+ const sig = req.headers.get('stripe-signature')!;
+ const event = stripe.webhooks.constructEvent(rawBody, sig, process.env.STRIPE_WEBHOOK_SECRET!);

1-Line Instant CLI Fix

stripe listen --forward-to localhost:3000/api/webhooks/stripe

Root Cause & Explanation

Stripe crypto signature verification requires the exact unmodified raw byte string. Parsing `req.json()` mutates whitespace and fails verification.