stripe-integration-expert
Production-grade Stripe integrations: subscriptions with trials and proration, one-time payments, usage-based billing, checkout sessions, idempotent webhook handlers, customer portal, and invoicing. Covers Next.js, Express, and Django patterns. Use when integrating Stripe for the first time, debugging webhook reliability issues, migrating from a different payment provider, or adding usage-based billing to an existing subscription product.
Profile →npx skills add alirezarezvani/claude-skills --skill stripe-integration-expert --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Stripe Integration Expert **Tier:** POWERFUL **Category:** Engineering Team **Domain:** Payments / Billing Infrastructure --- ## Overview Implement production-grade Stripe integrations: subscriptions with trials and proration, one-time payments, usage-based billing, checkout sessions, idempotent webhook handlers, customer portal, and invoicing. Covers Next.js, Express, and Django patterns. --- ## Core Capabilities - Subscription lifecycle management (create, upgrade, downgrade, cancel, pause) - Trial handling and conversion tracking - Proration calculation and credit application - Usage-based billing with metered pricing - Idempotent webhook handlers with signature verification - Customer portal integration - Invoice generation and PDF access - Full Stripe CLI local testing setup --- ## When to Use - Adding subscription billing to any web app - Implementing plan upgrades/downgrades with proration - Building usage-based or seat-based billing - Debugging webhook delivery failures - Migrating from one billing model to another --- ## Subscription Lifecycle State Machine ``` FREE_TRIAL ──paid──► ACTIVE ──cancel──► CANCEL_PENDING ──period_end──► CANCELED │ │ │ │ downgrade reactivate │
- Overview
- Core Capabilities
- When to Use
- Subscription Lifecycle State Machine
- DB subscription status values:
- Stripe Client Setup
- Checkout Session (Next.js App Router)
- Subscription Upgrade/Downgrade
- Complete Webhook Handler (Idempotent)
- Usage-Based Billing
- Customer Portal
- Testing with Stripe CLI
- Feature Gating Helper
- Common Pitfalls
Install Stripe CLI brew install stripe/stripe-cli/stripe Login stripe login Forward webhooks to local dev stripe listen --forward-to localhost:3000/api/webhooks/stripe Trigger specific events for testing stripe trigger checkout.session.completed stripe trigger customer.subscription.updated stripe trigger invoice.payment_failed
What does the stripe-integration-expert skill do?
Production-grade Stripe integrations: subscriptions with trials and proration, one-time payments, usage-based billing, checkout sessions, idempotent webhook handlers, customer portal, and invoicing. Covers Next.js, Express, and Django patterns. Use when integrating Stripe for the first time, debugging webhook reliability issues, migrating from a different payment provider, or adding usage-based billing to an existing subscription product.
How do I install it?
Run `npx skills add alirezarezvani/claude-skills --skill stripe-integration-expert --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From alirezarezvani/claude-skills, a repository with 23,791 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.