stripe-best-practices

Identify Stripe integration best practices for secure, scalable payment flows.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Helps engineers decide how to structure Stripe integrations, including API surface choices, platform setup, billing and treasury considerations, and secure key handling to reduce risk and accelerate delivery.

Core Features & Use Cases

  • Guidance on selecting API patterns (Checkout Sessions vs PaymentIntents), Connect Accounts v2, and surface coverage (billing, treasury, webhooks).
  • Migration and modernization advice for moving away from deprecated Stripe APIs and older workflows.
  • Security best practices for key management, restricted keys, OAuth, and webhook verification.

Quick Start

Review the recommended Stripe integration patterns and implement the guidance in your project.

Frequently Asked Questions about stripe-best-practices

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

FAQPage Schema
What is the best way to choose between Stripe Checkout Sessions and PaymentIntents?

Choosing between Stripe Checkout Sessions and PaymentIntents depends on your integration complexity. Checkout Sessions provide pre-built UI flows for rapid deployment, while PaymentIntents offer granular control for custom payment flows and scalable architecture.

How do I securely manage Stripe API keys and verify webhooks?

Secure Stripe integrations require using restricted API keys for least privilege access and strictly verifying webhook signatures. This prevents unauthorized access and ensures that incoming webhook events genuinely originate from Stripe.

Can I use Stripe Connect Accounts v2 for multi-party payment routing?

Stripe Connect Accounts v2 supports multi-party payment routing and platform setup. It provides the architectural guidance needed to structure scalable marketplace payments, manage sellers, and handle complex treasury considerations.

How do I migrate away from deprecated Stripe APIs to modern workflows?

Migrating away from deprecated Stripe APIs involves modernizing your integration to current workflows. The process provides specific migration considerations and references relevant documentation to guide implementation toward secure, scalable payment flows.

What Stripe integration patterns cover billing and treasury management?

Stripe integration patterns cover billing and treasury management through specific API surface selections. These patterns guide how to structure recurring billing cycles and manage funds within your scalable payment architecture.