stripe-best-practices

Guides Stripe integration decisions across payments, Connect, billing, tax, and security.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Stripe integrations involve many API choices and common pitfalls—deprecated endpoints, misconfigured tax collection, missing webhooks, and insecure key handling. This Skill routes every Stripe question to the correct current API and enforces critical rules so integrations are built correctly the first time. ## Core Features & Use Cases - Integration Routing: Maps your use case (one-time payments, subscriptions, marketplaces, tax, Treasury) to the right Stripe API and a dedicated reference guide. - Critical Rule Enforcement: Prevents common mistakes like passing payment_method_types, enabling automatic_tax without an active registration, using deprecated Charges/Sources APIs, or treating webhooks as optional. - Security Guidance: Covers restricted API keys, secrets vaults, webhook signature verification, CSP headers, OAuth state parameters, and incident response. - Use Case: When building a marketplace with Stripe Connect, the Skill directs you to Accounts v2, the correct charge pattern (destination vs. direct), capability status checks, and required embedded components—avoiding deprecated v1 account types. ## Quick Start Ask how to accept payments, set up subscriptions, build a Connect marketplace, or collect sales tax with Stripe, and the Skill will route you to the correct API and best practices.

Frequently Asked Questions about stripe-best-practices

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

FAQPage Schema
How do I accept one-time payments with Stripe?

Use the Checkout Sessions API for one-time payments, which handles discounts, shipping, and adaptive pricing automatically. Omit payment_method_types entirely so Stripe dynamically shows the most relevant payment methods for each customer.

Should I use Checkout Sessions or PaymentIntents for Stripe payments?

Use Checkout Sessions for on-session payments and PaymentIntents for off-session payments or when you need to model checkout state independently. Never use the deprecated Charges API; migrate to Checkout Sessions or PaymentIntents instead.

Why is Stripe Tax collecting zero tax on my transactions?

Zero tax usually means automatic_tax is enabled without an active registration in the customer's jurisdiction, or the product has a Nontaxable tax code. Check the line item's taxability_reason and verify registrations with the Tax Registrations API.

How do I set up Stripe Connect for a marketplace?

Use the Accounts v2 API with configuration.recipient requesting stripe_transfers, dashboard set to express, and destination charges with application_fee_amount. Never use deprecated v1 account types like express, custom, or standard in account creation.

Are webhooks required for Stripe integrations?

Webhooks are required for subscriptions, delayed-notification payment methods, and any post-payment side effect like fulfillment. Handle both checkout.session.completed and checkout.session.async_payment_succeeded, and always verify webhook signatures.

Should I use a secret key or restricted API key for Stripe?

Always prefer a restricted API key (rk_ prefix) with only the permissions each service needs, following least privilege. Store keys in a secrets vault like AWS Secrets Manager or Azure Key Vault, never in source code.