stripe-webhook

Add Stripe webhook event handlers with idempotency via Drizzle ORM transactions.

Updated Feb 10, 2026
One-click install
npx skills add https://github.com/wordshepherd/colophony --skill stripe-webhook
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: stripe-webhook
Source: https://github.com/wordshepherd/colophony/tree/main/.claude/skills/stripe-webhook
Command: npx skills add https://github.com/wordshepherd/colophony --skill stripe-webhook

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the secure and reliable integration of new Stripe webhook event handlers into your application, ensuring data integrity and preventing duplicate processing.

Core Features & Use Cases

  • Idempotent Handler Creation: Automatically implements a robust idempotency pattern using database transactions to prevent double-processing of webhook events.
  • Service Integration: Adds new event handlers to your API's webhook route and creates corresponding methods in your payments service.
  • Test Generation: Scaffolds unit tests for the new webhook handler to ensure correctness and idempotency.
  • Use Case: When Stripe releases a new event type, like customer.subscription.trial_will_end, this Skill can quickly generate the necessary code to handle it, update your database, and ensure it's tested and safe to deploy.

Quick Start

Use the stripe-webhook skill to add a handler for the 'invoice.paid' event type.

Frequently Asked Questions about stripe-webhook

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I handle Stripe webhooks and prevent duplicate processing?

To handle Stripe webhooks and prevent duplicate processing, implement an idempotency pattern using database transactions. This ensures reliable event processing by checking if an event was already processed before executing new operations.

What is idempotency in Stripe webhook event handlers?

Idempotency in Stripe webhook event handlers prevents double-processing of the same event. By using database transactions via Drizzle ORM, it ensures repeated webhook deliveries do not trigger duplicate data operations.

How do I add a new Stripe webhook event handler to a Fastify route?

To add a new Stripe webhook event handler to a Fastify route, generate the handler code, integrate it into the existing webhook route, and create a corresponding method in the payments service to manage the specific event type.

Can I use Drizzle ORM for Stripe webhook database transactions?

Yes, you can use Drizzle ORM for Stripe webhook database transactions. It provides the transactional support needed to implement idempotent handlers, ensuring data consistency when processing new webhook event types.

How do I test Stripe webhook idempotency in my payments service?

To test Stripe webhook idempotency in your payments service, scaffold unit tests for the new webhook handler. This verifies the handler's correctness and ensures duplicate event deliveries do not produce duplicate database operations.