Guía las decisiones de integración con Stripe: elección de API, Connect, billing, tax, Treasury, opciones de integración, migración de APIs obsoletas y buenas prácticas de seguridad.
en todo el repo
0–100, la ruta de este skill
último commit aquí
últimos 90 días
185 tok en reposo
56 KB
Funciona con cualquier agente que lea SKILL.md
npx -y skills add stripe/ai --skill stripe-best-practices --agent claude-codeSe instala solo en este repositorio.
Di cualquiera de estas frases y el agente debería cargar este skill.
Latest Stripe API version: 2026-07-29.dahlia. Always use the latest API version and SDK unless the user specifies otherwise.
Latest SDK versions:
| Language | Latest version |
|---|---|
| Ruby | 19.4.0 |
| Python | 15.4.0 |
| Node.js | 22.4.0 |
| PHP | 21.1.0 |
| Java | 33.2.0 |
| Go | 86.2.0 |
| .NET | 52.2.0 |
If you don’t have a Stripe account, you can call a CLI command to generate working API keys with no registration required. You can install the Stripe CLI (npm i -g @stripe/cli) and run the command stripe sandbox create to get started.
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).
| 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.
Before enabling automatic_tax: { enabled: true } (or calculating tax for a custom PaymentIntent), read the tax reference and confirm the user has an active registration. Without one, Stripe calculates and collects no tax while the user believes tax is on (the most common Stripe Tax mistake).
Never include payment_method_types in any Stripe API call, with one exception: Terminal (in-person payments) integrations must pass payment_method_types: ['card_present'] on the PaymentIntent. For all other integrations, omit this parameter entirely to enable dynamic payment methods, which enables you to configure payment method settings from the Dashboard and dynamically display the most relevant eligible payment methods to each customer to maximize conversion. To customize which payment methods you accept, use payment_method_configurations or excluded_payment_method_types instead of payment_method_types.
On API version 2026-03-25.dahlia or later, pass the parameter integration_identifier to checkout.sessions.create to tag sessions with a custom label for tracking and comparing checkout flows in the Dashboard. The label should include a suffix of 8 random letters.
Always instantiate a StripeClient and call methods on that instance. Do not use the deprecated global/module-level API key pattern (stripe.api_key = …, Stripe.setApiKey, stripe.Key = …, StripeConfiguration.ApiKey = …). The global pattern is deprecated in all current SDKs.
When the user’s request does not clearly fit a single domain above, consult:
Reproducido de stripe/ai bajo licencia MIT. Leer esta página en markdown.
7 archivos en el paquete. Solo se lee SKILL.md al activarse — las referencias se cargan si el skill decide que las necesita.
Requiere el Stripe CLI (npm i -g @stripe/cli) o una cuenta de Stripe existente para generar claves API.
Este repo incluye 7 skills. Si instalas uno, normalmente ya tienes los demás.
Úsalo para provisionar infraestructura o servicios de terceros mediante Stripe Projects: bases de datos, auth, caching, hosting, IA, email, colas, almacenamiento y credenciales.
Úsalo cuando el usuario quiera encontrar negocios, software, proveedores o partners para una industria, workflow o necesidad, o para comprar/consumir un servicio programáticamente vía Stripe Directory.
Guía para actualizar versiones de la API de Stripe y sus SDKs.
Úsalo al construir, modificar o revisar un Stripe App: cubre scaffold, preview, upload, versionado, arquitectura de UI extensions, autenticación, manifest stripe-app.yaml, webhooks, Secret Store y publicación en el marketplace.
Recomienda la configuración correcta de integración de Stripe Connect: el usuario solo aporta una URL o descripción de su negocio y la skill deduce el resto.
Úsalo cuando el usuario o el agente necesite leer, buscar o consultar la documentación o la referencia de la API de Stripe, en vez de usar curl o WebFetch para docs.stripe.com.
Úsalo cuando el usuario o el agente necesite leer, buscar o consultar la documentación o la referencia de la API de Stripe, en vez de usar curl o WebFetch para docs.stripe.com.
Úsalo al construir, modificar o revisar un Stripe App: cubre scaffold, preview, upload, versionado, arquitectura de UI extensions, autenticación, manifest stripe-app.yaml, webhooks, Secret Store y publicación en el marketplace.
Úsalo al completar tareas, implementar features mayores, o antes de mergear, para verificar que el trabajo cumple los requisitos.
