mkurman Overview
Stripe handles payment processing for online businesses — one-time charges, subscription billing, invoicing, marketplace payouts (Connect), and fraud prevention (Radar). This skill covers the Python SDK (stripe module).
Installation
uv pip install stripe
One-Time Charge
import stripe
stripe.api_key = "sk_test_..."
charge = stripe.Charge.create(
amount=2000, # $20.00 in cents
currency="usd",
source="tok_visa", # token from Stripe.js
description="Example charge",
)
print(charge.id, charge.status)
Subscription
customer = stripe.Customer.create(email="customer@example.com")
subscription = stripe.Subscription.create(
customer=customer.id,
items=[{"price": "price_123"}], # recurring price ID
)
print(subscription.id, subscription.status)
Webhook Verification
from flask import request
import stripe
payload = request.data
sig_header = request.headers.get("Stripe-Signature")
event = stripe.Webhook.construct_event(payload, sig_header, "whsec_...")
if event.type == "payment_intent.succeeded":
payment_intent = event.data.object
print(f"Payment {payment_intent.id} succeeded")
Connect Platform (Marketplace Payouts)
# Create a connected account
account = stripe.Account.create(
type="express",
country="US",
email="seller@example.com",
)
# Transfer funds
transfer = stripe.Transfer.create(
amount=1000,
currency="usd",
destination=account.id,
)
Error Handling
try:
charge = stripe.Charge.create(amount=-1, currency="usd")
except stripe.error.InvalidRequestError as e:
print(f"Invalid request: {e.user_message}")
except stripe.error.CardError as e:
print(f"Card declined: {e.error.decline_code}")
except stripe.error.RateLimitError:
print("Rate limited — retry with exponential backoff")