Stripe Subscription Handler
Drop-in Node.js module for Stripe billing, webhooks, and customer portal flows. Everything you need to launch subscription billing — without writing it from scratch.
Drop-in Node.js module for Stripe billing, webhooks, and customer portal flows. Everything you need to launch subscription billing — without writing it from scratch.
What is Stripe Subscription Handler?
Building Stripe subscriptions from scratch is deceptively complex. Between webhook signature verification, idempotency keys, failed payment retries, proration handling, and customer portal redirects — even experienced developers spend days getting it right. The Stripe Subscription Handler is a single, battle-tested Node.js module that encapsulates all of that complexity. Drop it into any Node.js, Express, or Next.js project and wire up fully functioning subscription billing in a single afternoon. Every function is fully typed with TypeScript, documented with inline comments, and includes unit-test stubs so you can confidently ship to production.
Everything in the package.
Subscription CRUD Module
Create, update, pause, resume, and cancel subscriptions with a clean async API. Handles Stripe customer creation automatically.
Webhook Handler
Express middleware that verifies Stripe webhook signatures, parses all subscription lifecycle events, and routes them to typed handler functions.
Customer Portal Integration
One-function call to generate a Stripe Billing Portal session URL — let customers manage their own plans, invoices, and payment methods.
Failed Payment Retry Logic
Pre-wired dunning logic that handles invoice.payment_failed events, updates user status in your database, and sends retry nudges.
Proration & Plan Upgrades
Correctly handles mid-cycle plan changes with Stripe proration — upgrade, downgrade, and plan-switch flows included.
TypeScript Types
Every function, event payload, and return type is fully typed. Works out of the box with strict TypeScript — no `any` anywhere.
Environment Config Template
.env.example with every required Stripe key, plus validation logic to catch missing config at startup before it hits production.
README + Integration Guide
Step-by-step setup guide for Express and Next.js API routes, plus a Stripe Dashboard checklist so nothing gets missed.
Built for production, not demos.
Idempotency-Safe API Calls
Every Stripe API call uses idempotency keys derived from your internal IDs — safe to retry on network failures without duplicate charges.
Multi-Plan Support
Works with any Stripe price ID. Pass your plan IDs as config — no hardcoding required. Supports monthly, annual, and metered billing.
Webhook Signature Verification
Cryptographic verification of every incoming webhook using your Stripe endpoint secret. Rejects spoofed events before they touch your database.
Database-Agnostic Hooks
Lifecycle hooks (onSubscriptionCreated, onPaymentFailed, etc.) are plain async callbacks — wire them to Postgres, MongoDB, or any ORM.
Trial Period Support
Configure free trial days per plan. Automatically transitions to paid on trial_will_end events with configurable advance notice.
Coupon & Discount Handling
Apply promotion codes and coupons at checkout or on an existing subscription. Validates codes against Stripe before applying.
Who is this for?
Developers, indie hackers, and product teams who want to skip the boilerplate and ship faster.
SaaS Founders Building Their First Billing System
Skip the Stripe docs rabbit hole. Drop in this module, set your price IDs, and have working subscriptions on your staging environment the same day.
Agencies Adding Billing to Client Projects
Reusable across any Node.js project. Configure once per client, hand off with documentation, and never explain Stripe webhooks to a client again.
Product Teams Replacing DIY Billing
If your current billing code is a tangle of switch statements and commented-out webhook handlers, this is a clean swap. Typed, tested, maintainable.
Indie Hackers Shipping Fast
No time to read the Stripe docs in full? This module covers 95% of subscription billing use cases. Ship your product, worry about edge cases later.
Technologies used.
Runtime
Stripe SDK
Compatible With
Testing
Common questions.
Does this work with Next.js App Router?
Yes. The webhook handler is framework-agnostic — it takes a raw request body and signature header. The README includes a Next.js route handler example for both Pages Router and App Router.
Do I need to set up a Stripe account first?
Yes — you'll need a Stripe account with at least one Product and Price created. The README includes a checklist of what to set up in the Stripe Dashboard before wiring this in.
Does it support one-time payments?
This module is focused on subscription billing (recurring payments). One-time checkout is a simpler flow and not included, but the README links to the relevant Stripe docs.
Is this production-ready or just a tutorial?
It's production-ready. Idempotency keys, webhook verification, error handling, and TypeScript types are all included. 1,240+ developers are using it in live products.
Can I use this in a commercial project?
Yes. MIT license — use it in any project, commercial or otherwise, with no attribution required.
Need something custom-built?
Need Stripe billing wired into a specific tech stack, extended with metered billing, seat-based pricing, or a custom admin dashboard to manage subscriptions? Our engineers have built billing infrastructure for 50+ SaaS products. Tell us what you're building and we'll scope a custom implementation.
Ready to ship faster?
Buy Stripe Subscription Handler today and go from zero to production in hours — not weeks.
Setup and implementation
Review prerequisites, installation steps, and configuration before integrating this product.
Read the setup documentation