stripe-best-practices · openai — Codex skill: what it does, how to install
This skill guides Stripe API choices for payments, subscriptions, marketplaces, and financial accounts. Use it when building or reviewing a Stripe integration.
npx skills add openai/plugins --skill stripe-best-practices -a codexWhat stripe-best-practices does
stripe-best-practices maps common Stripe tasks to the relevant APIs. It points to Checkout Sessions for one-time payments, Checkout Sessions with Payment Element for an embedded custom form, and Setup Intents for saving a payment method. Subscriptions use Billing APIs with Checkout Sessions.
The skill also covers Connect platforms with Accounts v2 and controller properties, v2 Financial Accounts, and migrations away from deprecated Stripe APIs. It is intended for building, changing, or reviewing integrations for payments and connected accounts.
Install it when your agent needs to make Stripe architecture decisions before writing code. It has little to add to projects with no Stripe integration.
What it helps with
- choose a Stripe API for one-time payments
- build an embedded form with Checkout Sessions and Payment Element
- set up a Connect marketplace with Accounts v2
- add subscriptions with Billing APIs
- migrate away from deprecated Stripe APIs
Example prompts for the agent
- Choose the right Stripe API for this payment flow and explain the tradeoff.
- Review this Stripe subscription integration and suggest the matching Billing APIs.
- Design a Connect setup for connected accounts using Accounts v2.
How to install stripe-best-practices
1Skills CLI (Vercel)
npx skills add openai/plugins --skill stripe-best-practices -a codex2Manually: put the files in place
.agents/skills/stripe-best-practices/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add openai/plugins --skill stripe-best-practices -a claude-code2Manually: put the files in place
~/.claude/skills/stripe-best-practices/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/stripe-best-practices/
Manually: put the files in place
.cursor/skills/stripe-best-practices/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install openai/plugins stripe-best-practices2Manually: put the files in place
.github/skills/stripe-best-practices/SKILL.mdPlatform CLI
gemini skills install https://github.com/openai/plugins --path plugins/build-web-apps/skills/stripe-best-practicesManually: put the files in place
.devin/skills/stripe-best-practices/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set201
The whole set →Other versions of stripe-best-practices
Similar
Questions about stripe-best-practices
How do I install stripe-best-practices in Codex?
Run npx skills add openai/plugins --skill stripe-best-practices or npx skills add openai/plugins --skill stripe-best-practices -a codex. The skill file is placed at .agents/skills/stripe-best-practices/SKILL.md.
What does stripe-best-practices do?
It guides Stripe API and integration choices for payments, subscriptions, Connect, financial accounts, and migrations from deprecated APIs.
Which Stripe API should I use to save a payment method?
The skill directs this use case to Setup Intents.
Source text
SKILL.md · MIT
--- name: stripe-best-practices description: Guides Stripe integration decisions — API selection (Checkout Sessions vs PaymentIntents), Connect platform setup (Accounts v2, controller properties), billing/subscriptions, Treasury financial accounts, integration surfaces (Checkout, Payment Element), and migrating from deprecated Stripe APIs. Use when building, modifying, or reviewing any Stripe integration — including accepting payments, building marketplaces, integrating Stripe, processing payments, setting up subscriptions, or creating connected accounts. --- Latest Stripe API version: **2026-02-25.clover**. Always use the latest API version and SDK unless the user specifies otherwise. ## Integration routing | Building... | Recommended API | Details | |---|---|---| | One-time payments | Checkout Sessions | [references/payments.md](references/payments.md) | | Custom payment form with embedded UI | Checkout Sessions + Payment Element | [references/payments.md](references/payments.md) | | Saving a payment method for later | Setup Intents | [references/payments.md](references/payments.md) | | Connect platform or marketplace | Accounts v2 (`/v2/core/accounts`) | [references/connect.md](references/connect.md) | | Subscriptions or recurring billing | Billing APIs + Checkout Sessions | [references/billing.md](references/billing.md) | | Embedded financial accounts / banking | v2 Financial Accounts | [references/treasury.md](references/treasury.md) | Read the relevant reference file before answering any integration question or writing code. ## Key documentation When the user's request does not clearly fit a single domain above, consult: - [Integration Options](https://docs.stripe.com/payments/payment-methods/integration-options.md) — Start here when designing any integration. - [API Tour](https://docs.stripe.com/payments-api/tour.md) — Overview of Stripe's API surface. - [Go Live Checklist](https://docs.stripe.com/get-started/checklist/go-live.md) — Review before launching.
© OpenAI · MIT · openai/plugins