stripe-best-practices

Guide Stripe integration decisions for API selection, Connect setup, and migration paths.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/afterwork/arra-aif --skill stripe-best-practices-afterwork
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: stripe-best-practices
Source: https://github.com/afterwork/arra-aif/tree/main/.cursor/skills/stripe-best-practices
Command: npx skills add https://github.com/afterwork/arra-aif --skill stripe-best-practices-afterwork

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

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.

Core Features & Use Cases

  • API surface guidance for choosing between Checkout Sessions and PaymentIntents based on fit for one-time vs recurring payments.
  • Connect platform planning with Accounts v2, controller properties, and risk distribution decisions.
  • Billing and subscriptions guidance, including proration, metering, and lifecycle flows.
  • Treasury/Financial Accounts considerations for embedded payments and platform-led finance.
  • Surface recommendations (Checkout, Payment Element, or hosted solutions) and migration paths from deprecated APIs.
  • Use case examples including SaaS marketplaces, multi-vendor platforms, and traditional e-commerce integrations.

Quick Start

Specify your Stripe use case and I will present the recommended API path and surface.

Frequently Asked Questions about stripe-best-practices

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
When should I use Stripe Checkout Sessions instead of PaymentIntents for accepting payments?

Stripe Checkout Sessions provide a pre-built, hosted payment page for rapid integration, while PaymentIntents offer granular control for custom interfaces. Use Checkout for standard e-commerce and PaymentIntents for complex, customized payment flows.

How do I set up a Stripe Connect marketplace with Accounts v2?

Configure Stripe Connect marketplace platforms using Accounts v2 and controller properties to manage risk distribution and fund routing. This provides structured guidance for multi-vendor platform integrations and connected account creation.

What is the best way to migrate from deprecated Stripe APIs?

Migrate from deprecated Stripe APIs by following established migration paths toward current surfaces like Checkout and Payment Element. This ensures your payment integration remains supported, secure, and compliant.

Does Stripe Treasury support embedded financial accounts for platform-led finance?

Yes, Stripe Treasury supports embedded financial accounts for platform-led finance. It allows you to integrate banking services directly into your platform, enabling users to store funds and manage payouts within your ecosystem.

How do I handle proration and metering for Stripe billing subscriptions?

Handle proration and metering for Stripe billing subscriptions by configuring lifecycle flows that automatically adjust costs based on usage changes or plan upgrades. This ensures accurate, automated recurring billing for SaaS applications.