stripe-webhooks

What problem does it solve?

Stripe webhooks are the backbone of payment integrations, enabling your application to react to events like successful payments and subscriptions. This Skill provides a secure, guided approach to receiving, validating, and handling those webhook events in popular runtimes.

Core Features & Use Cases

• Signature verification: Validate Stripe webhook payloads using the Stripe SDK or a manual verification flow.
• Event handling: Process common events such as payment_intent.succeeded, payment_intent.payment_failed, invoice.paid, and customer.subscription.*.
• Environment setup: Guidance for local development and production, including STRIPE_WEBHOOK_SECRET and STRIPE_SECRET_KEY management.
• Multi-runtime examples: Ready-to-adapt patterns for Express (Node.js), Next.js, and FastAPI to get you started quickly.

Quick Start

Set STRIPE_SECRET_KEY and STRIPE_WEBHOOK_SECRET in your environment, run the sample Express/Next.js/FastAPI webhook, and use the Stripe CLI or Hookdeck to forward test events to your endpoint. Ensure your webhook endpoint uses a raw body (for Node/Express) or the equivalent in your framework, and verify the Stripe-Signature header against your secret.