Stripe Handler

Use this skill when you need to implement payment logic using Stripe, specifically for use cases that are NOT standard SaaS subscription plans or standard Credit packages (which are handled by plans-handler and credits-handler respectively).

When to use

• Implementing "Buy One-time Product" flows (e.g., Courses, Digital Goods).
• Creating custom "Service" payments.
• Handling checkout.session.completed for custom metadata.
• Customizing src/app/api/webhooks/stripe/route.ts for non-standard events.
• Offloading heavy webhook processing to background tasks (via Inngest).

Process

1. Identify Payment Type

Before writing code, determine the nature of the payment:

• Is it a Subscription Plan? -> Use plans-handler.
• Is it a Credit Package? -> Use credits-handler.
• Is it a Custom One-time or Recurring Product? -> Continue with this skill.