stripe-best-practices

Overview

The Stripe Best Practices skill from Stripe's official AI repository provides up-to-date guidance for building Stripe payment integrations. It covers the latest API version (2026-01-28.clover), prioritizes CheckoutSessions and PaymentIntents APIs, and guides developers away from deprecated endpoints like the Charges API, Sources API, and legacy Card Element.

Key Features

• Current API Guidance - References the latest Stripe API version (2026-01-28.clover) with current SDK recommendations
• Integration Prioritization - Recommends Stripe-hosted or embedded Checkout as the primary integration surface, with Payment Element as an alternative for advanced customization
• Deprecation Warnings - Explicitly warns against using the Charges API, Sources API, Tokens API, and legacy Card Element, with migration guidance
• Payment Flow Coverage - Covers CheckoutSessions for on-session payments, PaymentIntents for off-session payments, SetupIntents for saving payment methods, and subscription APIs
• Deferred Intent Support - Guides developers on using deferred PaymentIntent creation with the Payment Element for scenarios like surcharging that need card details inspection before payment

Who is this for?

This skill is for developers integrating Stripe payments into their applications who need current, authoritative best practices. It is especially valuable for teams building new payment flows or migrating from legacy Stripe integrations (Charges API, Card Element) to modern patterns using Checkout Sessions and Payment Element.