Stripe

Stripe is a community skill for payment processing and subscription management, covering customer management, subscription billing, invoice generation, product and price creation, and secure payment handling for e-commerce and SaaS applications.

What Is This?

Overview

Stripe provides AI agents and automation tools with programmatic access to the Stripe payment platform for handling online payments and recurring billing. It covers customer management that creates, updates, and retrieves customer profiles with associated payment methods and billing details, subscription billing that manages recurring payment schedules with automated invoicing and payment collection, invoice generation that creates detailed billing documents with line items and tax calculations, product and price creation that defines catalog items with pricing tiers and billing intervals, and secure payment handling that processes one-time and recurring charges with PCI-compliant tokenization. The skill enables developers to integrate robust payment functionality and billing systems without building payment infrastructure from scratch, significantly reducing development time and operational complexity.

Who Should Use This

This skill serves SaaS developers implementing subscription billing models, e-commerce teams processing online payments, and AI agents automating payment workflows and financial operations. It is also well suited for freelancers and agencies building client billing systems that require reliable recurring invoicing and automated payment collection.

Why Use It?

Problems It Solves

Building secure payment infrastructure from scratch requires significant expertise and deep knowledge in payment security standards, regulatory compliance requirements, and fraud prevention measures. Managing recurring subscriptions manually leads to billing errors, missed payments, and customer churn. Integrating raw payment APIs directly involves complex OAuth authentication flows and token management, webhook handling, and error recovery logic patterns. Handling payment failures, automatic retries, and dunning management for failed recurring payments requires significant engineering effort and ongoing maintenance. Stripe consolidates these concerns into a single, well-documented platform with built-in support for edge cases.

Core Highlights

Customer manager creates and updates customer profiles with payment methods. Subscription engine automates recurring billing with flexible pricing plans. Invoice generator creates detailed bills with automatic delivery. Payment processor handles secure transactions with PCI compliance.

How to Use It?

Basic Usage

import stripe
stripe.api_key = 'sk_test_xxx'

customer = stripe.Customer.create(
    email='user@example.com',
    name='John Doe',
    description='Premium customer'
)

subscription = stripe.Subscription.create(
    customer=customer.id,
    items=[{
        'price': 'price_xxx'
    }],
    trial_period_days=14
)

Real-World Examples

product = stripe.Product.create(
    name='Pro Plan',
    description='Advanced features'
)

price = stripe.Price.create(
    product=product.id,
    unit_amount=2999,
    currency='usd',
    recurring={
        'interval': 'month'
    }
)

intent = stripe.PaymentIntent.create(
    amount=5000,
    currency='usd',
    customer=customer.id,
    payment_method='pm_xxx',
    confirm=True
)

invoice = stripe.Invoice.create(
    customer=customer.id,
    auto_advance=True
)
stripe.Invoice.finalize_invoice(
    invoice.id
)

Advanced Tips

Use webhook endpoints to handle asynchronous payment events like failed charges and subscription cancellations rather than polling the API. Implement idempotency keys for all payment operations to prevent duplicate charges during network retries. Store Stripe customer IDs in your database to maintain consistent references across sessions. Additionally, use Stripe's built-in test card numbers during development to simulate declined payments, insufficient funds, and authentication challenges before deploying to production.

When to Use It?

Use Cases

Build a SaaS subscription platform that manages monthly billing, usage-based pricing, and automatic payment collection with trial periods. Create an e-commerce checkout flow that processes one-time payments with support for multiple payment methods. Automate invoice generation and payment tracking for service businesses with recurring client billing.

Related Topics

Payment processing, subscription billing, recurring revenue, e-commerce platforms, payment gateways, and financial automation.

Important Notes

Requirements

A valid Stripe account with API keys configured for both test and production environments. OAuth credentials for managed authentication flows when using hosted payment integrations. PCI compliance understanding for handling sensitive payment data if storing card information directly.

Usage Recommendations

Do: use test mode extensively before going live to verify payment flows and webhook handling work correctly. Implement proper error handling for declined payments, expired cards, and insufficient funds scenarios. Monitor webhook delivery and implement retry logic for failed webhook processing.

Don't: store raw credit card numbers in your own database since Stripe handles tokenization securely. Skip webhook signature verification since unverified webhooks can be spoofed by attackers. Ignore failed payment events since they require customer communication and retry attempts.

Limitations

Stripe payment processing availability varies by country with different supported payment methods across geographic regions and supported payment methods differ across regions. Payment processing fees apply to all transactions with rates varying based on your pricing plan and transaction volume. Some advanced Stripe features like usage-based billing with metered pricing and complex pricing models require specific Stripe account configurations and may necessitate a higher-tier Stripe plan to access fully.