--- title: "stripe-best-practices skill: build Stripe payments correctly" canonical_url: https://cookiesforai.app/skills/stripe/stripe-best-practices last_updated: 2026-10-02T03:02:16+02:00 type: skill summary: "stripe-best-practices is Stripe's own agent skill for integration decisions: it steers the agent to the right Stripe API for payments, subscriptions, Connect, tax and security, using current API and SDK versions." install: "npx skills add stripe/ai --skill stripe-best-practices" related: - "https://cookiesforai.app/skills/anthropics/claude-api" - "https://cookiesforai.app/skills/vercel-labs/vercel-react-best-practices" - "https://cookiesforai.app/skills/vercel-labs/vercel-composition-patterns" - "https://cookiesforai.app/skills/vercel-labs/vercel-react-native-skills" --- # Stripe best practices stripe-best-practices is Stripe's own agent skill for integration decisions: it steers the agent to the right Stripe API for payments, subscriptions, Connect, tax and security, using current API and SDK versions. | Fact | Value | |---|---| | Publisher | Stripe (official, own GitHub account) | | Source | https://github.com/stripe/ai/tree/HEAD/skills/stripe-best-practices | | License | MIT | | Repository stars | 1,852 on 2026-10-02 | | Skill name | stripe-best-practices | | Category | Coding and frameworks | | Skill last changed | 2026-10-02 | | Page updated | 2026-10-02 | | Facts checked | 2026-10-02 | ## Install Install the skill with the skills CLI: ``` npx skills add stripe/ai --skill stripe-best-practices ``` Or, in Claude Code, install Stripe's plugin from the official marketplace: ``` claude plugin install stripe@claude-plugins-official ``` Or, in Codex, install Stripe's plugin from the OpenAI-curated marketplace: ``` codex plugin add stripe@openai-curated ``` Stripe recommends its plugins where available because they update automatically. Copies installed with the skills CLI need npx skills update to stay current. ## Ask your coding agent A skill can include scripts that run on your computer, so read its source first: https://github.com/stripe/ai/tree/HEAD/skills/stripe-best-practices ```text Install the agent skill stripe-best-practices from github.com/stripe/ai. ``` ## What it does Stripe best practices is the main skill in Stripe's AI repository and loads whenever an agent plans, builds, changes, tests or reviews a Stripe integration. On 2026-10-01 it names Stripe API version 2026-08-26.dahlia as the latest and lists current SDK versions for Ruby, Python, Node.js, PHP, Java, Go and .NET, telling the agent to use them unless you say otherwise. A routing table maps each job to an API: Checkout Sessions for one-time payments, Checkout Sessions with the Payment Element for embedded forms, Setup Intents for saving cards, Accounts v2 for Connect platforms, Billing APIs for subscriptions, Metronome for new usage-based billing, Stripe Tax with the Registrations API for sales tax and VAT, and v2 Financial Accounts for embedded banking. The agent reads the matching reference page before writing code. Its critical rules target common mistakes. The agent must not pass payment_method_types except for Terminal, must treat webhooks as required and fulfil orders in a webhook handler instead of the success page, must confirm an active tax registration before turning on automatic tax, and must use a StripeClient instance instead of the deprecated global API key. It recommends restricted API keys over secret keys and separate sandboxes for development and CI. ## When to use it - You are adding Stripe Checkout or subscriptions to an app and want the current recommended API. - You are building a marketplace on Stripe Connect. - You want to collect sales tax or VAT with Stripe Tax without silently collecting nothing. - You want an agent to review an existing Stripe integration for deprecated patterns. ## When to pick something else - Other payment providers: every rule here is specific to Stripe's APIs. ## What it needs - A Stripe account, or a test sandbox created with the Stripe CLI (stripe sandbox create) ## Which agents it works in Stripe documents it for Claude Code, Codex, Cursor, Grok Build, Any agent that reads SKILL.md files, through the skills CLI. The open skills CLI also installs it into 78 agents (listed with the CLI on 2026-10-01). Most details live in reference pages on docs.stripe.com that the agent is told to read before answering, so it needs web access to follow the skill fully. ## License MIT. ## Related ### Related skills for coding and frameworks - [Claude API](https://cookiesforai.app/skills/anthropics/claude-api): Claude API is Anthropic's open-source agent skill for code that calls Claude: current model IDs and prices, guides for seven SDK languages plus cURL, and guided migrations to newer models. - [React Best Practices](https://cookiesforai.app/skills/vercel-labs/vercel-react-best-practices): React Best Practices is Vercel Engineering's agent skill of 70 performance rules for React and Next.js, ranked by impact, which the agent applies when it writes or reviews code. - [React Composition Patterns](https://cookiesforai.app/skills/vercel-labs/vercel-composition-patterns): React Composition Patterns is Vercel's agent skill for React component APIs: compound components, lifted state and explicit variants instead of a growing list of boolean props. - [React Native](https://cookiesforai.app/skills/vercel-labs/vercel-react-native-skills): React Native is Vercel's agent skill of React Native and Expo rules, ranked by impact: list performance, animations, native navigation and UI patterns for faster mobile apps.