stripe-best-practicesby stripe
Latest Stripe API version: 2026-04-22.dahlia . Always use the latest API version and SDK unless the user specifies otherwise.
npx skills add https://github.com/stripe/agent-toolkit --skill stripe-best-practicesLatest Stripe API version: 2026-04-22.dahlia. Always use the latest API version and SDK unless the user specifies otherwise.
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> |
| Subscriptions or recurring billing | Billing APIs + Checkout Sessions | <references/billing.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.
Critical rules
- Never include
payment_method_typesin any Stripe API call, with one exception: Terminal (in-person payments) integrations must passpayment_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, usepayment_method_configurationsorexcluded_payment_method_typesinstead ofpayment_method_types.
Key documentation
When the user’s request does not clearly fit a single domain above, consult:
- Integration Options — Start here when designing any integration.
- API Tour — Overview of Stripe’s API surface.
- Go Live Checklist — Review before launching.
More skills from stripe
stripe-projects
by stripe
Stripe Projects is a CLI for provisioning software stacks.
upgrade-stripe
by stripe
Guide for upgrading Stripe API versions and SDKs
stripe-best-practices
by stripe
Decision guide for Stripe API selection, Connect setup, billing, and integration patterns. Routes integration decisions across six domains: one-time payments (Checkout Sessions), custom payment forms (Payment Element), saved payment methods (Setup Intents), marketplaces (Accounts v2), subscriptions (Billing APIs), and embedded financial accounts (Treasury) Provides reference documentation for each integration type, including API version guidance (latest: 2026-02-25.clover) and pre-launch...
stripe-projects
by stripe
Provision third-party services and retrieve API keys/tokens using the Stripe Projects CLI plugin.
create-payment-credential
by stripe
Use Link to get secure, one-time-use payment credentials from a Link wallet to complete purchases.
pay-for-http-request
by stripe
Make HTTP requests with automatic x402 payment support using the purl command line interface.