stripe-best-practices
Guides Stripe integration decisions across development and test environment planning (separate sandboxes vs the shared test mode sandbox), 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, API key permissions, webhooks, OAuth). Use when planning, building, modifying, testing, or reviewing any Stripe integration, including choosing a development environment, 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
With your agent
Install OMGSkills skill "stripe/ai:stripe-best-practices" into this agent's normal skills directory: call the OMGSkills MCP get_install_plan tool for your agent and run the script it returns (it installs only the pinned commit and verifies SKILL.md), and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.
Manual command
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...
connect-required-verification-information
Used when the user asks what information a Stripe Connect connected account must provide for verification, onboarding,...
stripe-apps
Build, modify, or review Stripe Apps and extensions using the relevant documentation and reference guides.