# stripe-best-practices

> Claude/Codex skill by [@stripe](https://omgskills.com/library/stripe/index.md) · 1.8k stars · 84k installs · Updated 2026-08-30

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.

Tags: ai, gemini-cli-extension, llm, llm-agents, mcp, python, typescript, workflows

## Install

```sh
git clone https://github.com/stripe/ai /tmp/ai && ln -s /tmp/ai/skills/stripe-best-practices ~/.claude/skills/stripe-best-practices
```

## From 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.

## Links

- HTML page: https://omgskills.com/skills/stripe/ai/stripe-best-practices/
- GitHub: https://github.com/stripe/ai
- Author: [@stripe](https://omgskills.com/library/stripe/index.md)

## More from this repo

- [connect-recommend](https://omgskills.com/skills/stripe/ai/connect-recommend/index.md) — Used when the user asks about Stripe Connect configuration, charge patterns, Dashboard access, or how to get started...
   - [@stripe](https://omgskills.com/library/stripe/index.md) · 1.8k stars
- [stripe-directory](https://omgskills.com/skills/stripe/ai/stripe-directory/index.md) — Identifies external providers, merchants, nonprofits, platforms, APIs, and software services, and resolves the...
   - [@stripe](https://omgskills.com/library/stripe/index.md) · 1.8k stars
- [stripe-projects](https://omgskills.com/skills/stripe/ai/stripe-projects/index.md) — Used when the user wants to provision infrastructure or third-party services using Stripe Projects.
   - [@stripe](https://omgskills.com/library/stripe/index.md) · 1.8k stars