Stripe Webhooks

Handles Stripe webhook verification and event processing with official SDK wrappers for Node and Python. Ships with complete examples for Express, Next.js, and FastAPI that show the full handler setup, not just verification snippets. The core pattern is simple: pass raw body and signature header to constructEvent, catch SignatureVerificationError, then switch on event type. Includes a table of common events like payment_intent.succeeded and customer.subscription.deleted. Built by Hookdeck, so it naturally pairs with their webhook-handler-patterns skill for idempotency and retry logic. If you're wiring up Stripe payments or subscriptions and need to stop guessing why signature verification fails, this gives you the working code.

skills.sh installs: 601
GitHub stars: 100
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add hookdeck/webhook-skills --skill stripe-webhooks --agent claude-code

Installs into .claude/skills of the current project.

Files

Stripe Webhooks

When to Use This Skill

Setting up Stripe webhook handlers
Debugging signature verification failures
Understanding Stripe event types and payloads
Handling payment, subscription, or invoice events

Verification (core)

Stripe ships official SDK helpers that verify the Stripe-Signature header (HMAC-SHA256 over timestamp.body) and parse the event in one call. Pass the raw request body — don't JSON.parse first.

Node:

const stripe = require('stripe')(process.env.STRIPE_SECRET_KEY);

const event = stripe.webhooks.constructEvent(
  rawBody,                                  // Buffer or string of the raw HTTP body
  req.headers['stripe-signature'],
  process.env.STRIPE_WEBHOOK_SECRET         // whsec_… from the webhook endpoint settings
);
// Throws Stripe.errors.SignatureVerificationError on tampering or stale timestamp

Python: