Payment Webhook Recipe Pack for Stripe (TypeScript)
Copy-paste TypeScript handlers for the checkout and subscription webhook events most SaaS apps need, with signature checks, idempotency and tests.
Economics
- Pricing example
- $39 one-time (team licence $99)
- Daily math
- 1 sale every 2 days x $39 = about $20/day.
- Target if you hit the daily math
- Target: $550 - $900 / month if the daily math is hit
Audience and urgency
Audience: Indie hackers and small dev teams adding paid plans to Next.js, Express or serverless apps.
Urgency: Webhook handling is where billing bugs hide: missed events, events processed twice, and customers who paid but did not get access. Developers re-learn the same event flow on every project.
MVP scope
- ✓ Handlers for checkout.session.completed, customer.subscription.created/updated/deleted, invoice.paid and invoice.payment_failed
- ✓ Signature verification and an idempotency-table pattern (Postgres/Supabase and SQLite versions)
- ✓ Adapters for Next.js route handlers, Express and a generic serverless function
- ✓ Test fixtures plus a local replay guide using the Stripe CLI
- ✓ README with an event-flow diagram and an upgrade/downgrade/cancel checklist
Omitted features
- - Do NOT build a hosted billing service
- - Do NOT copy Stripe's documentation text; link to the official docs
- - Do NOT try to cover every event type in v1
Suggested stack
- Frontend
- Docs site: Astro Starlight or a simple Next.js page
- Backend or API
- TypeScript handlers + Vitest tests
- Payments
- Lemon Squeezy or a Stripe Payment Link with download delivery
- Hosting
- Private GitHub repo invite or zip download; docs on Vercel
Repository metadata
- Blueprint ID
payment-webhook-recipes-ts- Category ID
code_asset_pack- Monetization ID
one_time
Day-one distribution
Channels
- X (Twitter) dev community: short threads on common webhook bugs
- Reddit r/nextjs and r/SaaS
- dev.to or Hashnode tutorial that gives one handler away free
Reddit strategy
Publish a free 'subscription webhook events checklist' and one complete handler; the pack contains the rest plus tests.
Cold outreach or directory hook
Submit to boilerplate and starter-kit directories, and offer a discount code to newsletter writers who cover Next.js.
Search keywords
stripe webhook nextjs example, stripe subscription webhook typescript, stripe webhook idempotency
One-shot master prompt
Create a TypeScript code pack named "Payment Webhook Recipes" with a docs site. Core requirements: 1. A framework-agnostic core module: verifySignature(rawBody, header, secret), an idempotency guard backed by a processed_events table (SQL migrations for Postgres and SQLite), and a typed event router. 2. Handlers for checkout.session.completed, customer.subscription.created, customer.subscription.updated, customer.subscription.deleted, invoice.paid and invoice.payment_failed that update a users/subscriptions table and are safe to run twice. 3. Thin adapters for Next.js App Router route handlers, Express, and a generic serverless handler (raw body handling documented for each). 4. Vitest tests with JSON fixtures for each event, plus a README section on replaying events locally with the Stripe CLI. 5. A small Astro or Next.js docs site with copy buttons, an event-flow diagram, and a checklist for upgrades, downgrades, cancellations and failed payments. Link to official docs instead of copying them.
Comparable products
Published 2026-10-08.