payment-provider-router

Route verified Stripe webhook events to typed downstream handlers by event type.

1|Updated May 6, 2026
One-click install
npx skills add https://github.com/jacob-balslev/skill-graph --skill payment-provider-router
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: payment-provider-router
Source: https://github.com/jacob-balslev/skill-graph/tree/main/examples/projects/saas-stripe-postgres/skills/payment-provider-router
Command: npx skills add https://github.com/jacob-balslev/skill-graph --skill payment-provider-router

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It eliminates the risk and overhead of manually deciding which business logic to run for each incoming payment webhook event, ensuring the correct downstream handler executes.

Core Features & Use Cases

  • Typed payment event dispatch: Routes Stripe events by event type to narrowly-scoped handlers for specific subtypes.
  • Safety-first unknown handling: Logs unhandled event types and returns success to prevent Stripe retry storms.
  • Clear operational boundaries: Enforces that signature verification and database writes happen in separate skills/handlers, while this router only decides routing.

Quick Start

Use the payment-provider-router skill to dispatch a verified Stripe webhook event to the correct downstream handler based on its event type.

Frequently Asked Questions about payment-provider-router

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

FAQPage Schema
How do I route Stripe webhook events to specific handlers based on event type?

Stripe webhook events can be routed using a typed routing table that maps event types to narrowly-scoped downstream handlers for specific subtypes like checkout completion or subscription deletion.

What happens if my Stripe webhook router receives an unknown or unhandled event type?

Unknown event types trigger a safety-first fallback that logs the unhandled event and returns a success response to Stripe, preventing webhook retry storms while maintaining operational stability.

How do I prevent Stripe retry storms when adding new payment webhook event types?

Preventing Stripe retry storms requires an unknown-event fallback in your webhook routing logic that logs unhandled event types and returns a success status, satisfying Stripe's delivery expectations.

Does this webhook routing logic handle Stripe signature verification and database writes?

No, this routing logic enforces clear operational boundaries by only deciding routing; signature verification and database writes must happen in separate skills or handlers before and after invocation.

Can I isolate handler errors when dispatching Stripe payment events to different workflows?

Yes, the webhook dispatch logic requires handler error isolation to ensure that a failure in a specific downstream handler, such as invoice payment failure dunning, does not crash the entire routing process.

What is the best way to structure payment webhook dispatch for multiple Stripe subscription workflows?

The best way to structure payment webhook dispatch is using a typed routing table to map specific Stripe subscription events, like cancellation or deletion, to narrowly-scoped downstream handlers.