stripe-best-practices
Guides Stripe integration decisions across API selection (Checkout Sessions vs PaymentIntents), Connect platform setup (Accounts v2, controller properties), billing/subscriptions, tax and registrations (Stripe Tax, automatic_tax, product tax codes), Treasury financial accounts, integration options (Checkout, Payment Element), migrating from deprecated Stripe APIs, and security best practices (API key management, restricted keys, webhooks, OAuth). Use when building, modifying, or reviewing any Stripe integration, including accepting payments, building marketplaces, integrating Stripe, processing payments, setting up subscriptions, collecting sales tax, VAT, or GST, creating connected accounts, or implementing secure key handling.
Install
git clone https://github.com/stripe/ai /tmp/ai && ln -s /tmp/ai/skills/stripe-best-practices ~/.claude/skills/stripe-best-practicesFrom README
Integration routing | Building… | Recommended API | Details | | --- | --- | --- | | One-time payments | Checkout Sessions | | | Custom payment form with embedded UI | Checkout Sessions + Payment Element | | | Saving a payment method for later | Intents | | | Connect platform or marketplace | Accounts v2 (/v2/core/accounts) | | | -based billing (new integration) | Metronome | | | Subscriptions or recurring billing | Billing APIs + Checkout Sessions | | | Sales tax, VAT, or GST compliance | Stripe Tax + Registrations API | | | Embedded financial accounts / banking | v2 Financial Accounts | | | Security (key management, RAKs, webhooks, OAuth, 2FA, Connect liability) | See security reference | | Read the relevant reference file before answering any integration question or writing code. Critical rules Before enabling automatictax: { enabled: true } (or calculating tax for a custom PaymentIntent), read the tax reference and confirm the user has an active registration.
More from this repo
connect-recommend
Used when the user asks about Stripe Connect configuration, charge patterns, Dashboard access, or how to get started...
stripe-directory
Identifies external providers, merchants, nonprofits, platforms, APIs, and software services, and resolves the...
stripe-projects
Used when the user wants to provision infrastructure or third-party services using Stripe Projects.