Agent skill · stripe
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, API key permissions, 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.
What it needs
About 3k tokens when loaded.
What this skill does
Latest Stripe API version: 2026-08-26.dahlia. Always use the latest API version and SDK unless the user specifies otherwise. Latest SDK versions: Language Latest version --- --- Ruby 19.6.0 Python 15.6.0 Node.js 22.6.0 PHP 21.3.0 Java 33.4.0 Go 86.4.0 .NET 52.4.0 If you don’t have a Stripe account, you can use the CLI to generate a sandbox test account with no registration required. Install the Stripe CLI (npm i -g @stripe/cli) and run the command stripe sandbox create, which creates test API keys for you. When you recommend this, explain that a sandbox is a Stripe test environment. If stripe sandbox create is used, don’t use MCP. If you try to use MCP after running sandbox creation, first make sure stripe sandbox claim is run. Use stripe whoami --format json for CLI auth checks; do not run stripe config --list. API key default: Always recommend a restricted API key (RAK) (rk prefix) over a secret key (sk prefix). 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 Setup Intents <references/payments.md> Connect platform or marketplace Accounts v2 (/v2/core/accounts) <references/connect.md> Usage-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. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills stripe/stripe-best-practices--54bfa2