stripe-supabase-webhooks

Synchronize Stripe webhook events to Supabase in Next.js App Router.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/rrh1441/firstserveseattle --skill stripe-supabase-webhooks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: stripe-supabase-webhooks
Source: https://github.com/rrh1441/firstserveseattle/tree/main/.claude/skills/stripe-supabase-webhooks
Command: npx skills add https://github.com/rrh1441/firstserveseattle --skill stripe-supabase-webhooks

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill provides patterns for implementing Stripe webhook handlers in Next.js App Router applications that sync subscription state to Supabase. It covers signature verification, event dispatching, intelligent upsert strategies, and transactional email integration.

Core Features & Use Cases

  • Webhook signature verification and secure event handling for Stripe webhooks.
  • Cascading upsert strategy to reliably sync subscriber data to Supabase across signed-up and pre-signup users.
  • Optional transactional emails on important events (welcome, payment failure, cancellations).
  • Clear route-handler patterns and testing guidance for local development.

Quick Start

Set up the Stripe webhook route at app/api/stripe-webhook/route.ts and verify it with Stripe CLI in your local environment.

Frequently Asked Questions about stripe-supabase-webhooks

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

FAQPage Schema
How do I sync Stripe webhook subscription events to Supabase in Next.js?

Syncing Stripe webhook subscription events to Supabase in Next.js requires a route handler at app/api/stripe-webhook/route.ts that verifies signatures and applies cascading upsert logic to update subscriber data across lifecycle changes.

What is a cascading upsert strategy for Stripe webhooks?

A cascading upsert strategy for Stripe webhooks reliably syncs subscriber data to Supabase by updating existing records or inserting new ones, correctly handling both signed-up and pre-signup users during event processing.

Do I need to verify Stripe webhook signatures when using Supabase?

Verifying Stripe webhook signatures is required when using Supabase to ensure secure event handling and prevent unauthorized requests from updating your subscriber database state.

Can I send transactional emails based on Stripe subscription events in Next.js?

You can send transactional emails based on Stripe subscription events in Next.js by triggering email notifications during the event-driven flow for occurrences like welcome messages, payment failures, and cancellations.

How do I test Stripe webhooks locally with Next.js and Supabase?

Testing Stripe webhooks locally with Next.js and Supabase involves setting up the route at app/api/stripe-webhook/route.ts and using Stripe CLI to forward and verify events in your local environment.

What environment variables do I need for Stripe and Supabase webhook integration?

Stripe and Supabase webhook integration requires environment variables configured for both services to authenticate requests and securely connect the Next.js route handler to your database and payment provider.