stripe-integration

Implement Stripe payment processing with checkout sessions, subscriptions, webhooks, and refunds.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/scoots31/engineering-playbook --skill stripe-integration-scoots31
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: stripe-integration
Source: https://github.com/scoots31/engineering-playbook/tree/main/references/stripe-integration
Command: npx skills add https://github.com/scoots31/engineering-playbook --skill stripe-integration-scoots31

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires stripe.

What problem does it solve? Integrating payments correctly is hard: PCI compliance, subscription lifecycles, webhook verification, and refund handling all have failure modes that cost money or leak revenue. This Skill provides production-tested patterns for the full Stripe payment lifecycle so you avoid common integration mistakes. ## Core Features & Use Cases - Checkout & Payment Flows: Create hosted Checkout Sessions, embedded Payment Elements, or bespoke Payment Intents for one-time and recurring charges. - Subscriptions & Customer Management: Build subscription billing with products, prices, invoices, customer records, saved payment methods, and a self-service customer portal. - Secure Webhooks & Refunds: Verify webhook signatures, handle events idempotently, process refunds, and respond to disputes with evidence. - Use Case: You are adding a $20/month premium tier to your app. Use this Skill to create a subscription Checkout Session, provision access on invoice.payment_succeeded, and revoke it on customer.subscription.deleted. ## Quick Start Ask the AI to create a Stripe checkout session for a monthly subscription with a webhook endpoint that activates the user's account on successful payment.

Frequently Asked Questions about stripe-integration

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

FAQPage Schema
How do I create a Stripe checkout session in Python?

Call stripe.checkout.Session.create with line_items, a mode of 'payment' or 'subscription', and success/cancel URLs, then redirect the user to session.url. Hosted checkout is the recommended approach for most integrations.

Stripe Checkout Sessions vs Payment Intents: which should I use?

Checkout Sessions are recommended for most integrations because they handle line items, taxes, discounts, and the checkout UI with lower maintenance burden. Payment Intents give bespoke control when you calculate final amounts yourself, but require Stripe.js and more implementation work.

How do I handle Stripe webhooks securely?

Verify the Stripe-Signature header using stripe.Webhook.construct_event with your endpoint secret before processing any event. Track processed event IDs to ensure idempotency, since Stripe retries failed webhook deliveries.

How do I test Stripe payments without real cards?

Use test mode API keys with Stripe's test card numbers, such as 4242424242424242 for success and 4000000000000002 for declines. You can also confirm payment intents with test payment methods like pm_card_visa.

How do I let customers manage their own Stripe subscriptions?

Create a billing portal session with stripe.billing_portal.Session.create passing the customer ID and a return URL, then redirect the customer to the returned URL. The portal lets them update payment methods and cancel subscriptions.