# stripe-best-practices

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

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.

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 | references/payments.md | | Custom payment form with embedded UI | Checkout Sessions + Payment Element | references/payments.md | | Saving a payment method for later | Intents | references/payments.md | | Connect platform or marketplace | Accounts v2 (/v2/core/accounts) | references/connect.md | | -based billing (new integration) | Metronome | references/billing.md | | Subscriptions or recurring billing | Billing APIs + Checkout Sessions | references/billing.md | | Sales tax, VAT, or GST compliance | Stripe Tax + Registrations API | references/tax.md | | Embedded financial accounts / banking | v2 Financial Accounts | references/treasury.md | | Security (key management, RAKs, webhooks, OAuth, 2FA, Connect liability) | See security reference | references/security.md | Read the relevant reference file before answering any integration question or writing code.

## Links

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

## More from this repo

- [stripe-projects](https://omgskills.com/skills/stripe/agent-toolkit/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
- [upgrade-stripe](https://omgskills.com/skills/stripe/agent-toolkit/upgrade-stripe/index.md) — Guide for upgrading Stripe API versions and SDKs
   - [@stripe](https://omgskills.com/library/stripe/index.md) · 1.8k stars
- [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