stripe-best-practices

Guide Stripe integration decisions on API selection, billing, and security.

1|Updated Apr 30, 2026
One-click install
npx skills add https://github.com/superwizor/ai --skill stripe-best-practices-superwizor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: stripe-best-practices
Source: https://github.com/superwizor/ai/tree/main/.agents/skills/stripe-best-practices
Command: npx skills add https://github.com/superwizor/ai --skill stripe-best-practices-superwizor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill provides guidance on making optimal Stripe integration decisions, covering a wide range of topics from API selection to security best practices.

Core Features & Use Cases

  • API Selection: Offers recommendations on using the best API (Checkout Sessions vs PaymentIntents) for different use cases.
  • Connect Platform Setup: Guides on setting up the Connect platform, including Accounts v2 and controller properties.
  • Billing/Subscriptions: Best practices for implementing billing and subscriptions.
  • Security Best Practices: Security guidelines for API key management, restricted keys, webhooks, OAuth, and two-factor authentication.
  • Use Case: Ideal for businesses building, modifying, or reviewing any Stripe integration, including payment processing, marketplace development, or subscription management.

Quick Start

To get started, read the 'Integration routing' section in the SKILL.md file to understand which API to use for your specific use case.

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 payment processing?

For Stripe payment processing, Checkout Sessions provide a pre-built UI for quick integration, while PaymentIntents offer custom control for complex flows. The Skill guides API selection based on your specific use case.

How do I set up a Stripe Connect platform for marketplace development?

Setting up a Stripe Connect platform involves configuring Accounts v2 and controller properties. This Skill provides best practices for structuring your Connect platform to handle marketplace routing correctly.

What are the security best practices for Stripe API key management and webhooks?

Stripe security best practices include using restricted API keys, securing webhook endpoints, implementing OAuth safely, and enabling two-factor authentication. The Skill details guidelines for protecting your integration.

How do I implement Stripe billing and subscriptions?

Implementing Stripe billing and subscriptions requires mapping your recurring revenue model to the correct API objects. The Skill offers best practices for structuring subscription plans and billing cycles.

Can I use this guidance for reviewing an existing Stripe integration?

Yes, the guidance covers reviewing existing Stripe integrations. It helps identify architectural improvements in API selection, security configurations, and billing setups to optimize your current implementation.