When to use it
- Adding payments or subscriptions to an app
- Choosing between Checkout and the Payment Element
- Setting up webhooks correctly
What it looks like
Add monthly and yearly subscriptions to this Next.js app.
stripe_implementation_plannersearch_stripe_documentationstripe_api_searchstripe_api_details+1 morePlan: Stripe Billing with hosted Checkout. One product with two prices, a /api/checkout route that creates the session, the customer portal for changes, and a webhook for checkout.session.completed, invoice.paid and invoice.payment_failed. Create the test-mode product and prices now?
The SKILL.md file
name: stripe-integration-planPlan and build a Stripe integration, such as Checkout, Billing subscriptions, Connect or webhooks, using Stripe's implementation planner and current docs, with test-mode verification. Use when the user wants to add payments, subscriptions or Stripe webhooks to their app, or asks which Stripe product to use.
Steps
- Ask, or read from the repo: what they sell (one-off, subscription, usage-based or marketplace), the stack, and where customers pay (hosted page, embedded, or mobile).
- Run
stripe_implementation_plannerwith that context to get Stripe's recommended approach, such as Checkout vs Payment Element, Billing, or Connect. - Check the details in current docs with
search_stripe_documentation, and the exact API objects withstripe_api_searchandstripe_api_details. Prefer the newest recommended APIs over older ones you remember. - Write the plan:
- products and prices to create;
- server endpoints, such as creating a Checkout Session, and the client changes;
- webhooks to handle (at least
checkout.session.completedandinvoice.paidorinvoice.payment_failedfor subscriptions), with signature verification; - test cards and test clocks for subscriptions.
- When the repo is open, implement it step by step, with keys read from environment variables.
- Create test-mode products or prices with
stripe_api_writeonly after the user approves, and never in live mode during setup.
Done means
A full test-mode payment works end to end, the webhook handler verifies signatures, and the user has a short checklist for going live.
Stripe tools it uses
stripe_implementation_plannersearch_stripe_documentationstripe_api_searchstripe_api_detailsstripe_api_writeAsks first
Tool list from Stripe MCP documentation.
FAQ
Does it use the latest Stripe APIs?
Yes. It checks Stripe's current docs and planner rather than relying on memory.
Will it touch my live account?
No. Setup happens in test mode, and anything it creates needs your yes.