Skip to content

stripe.md

Latest commit

 

History

History
148 lines (106 loc) · 3.11 KB

stripe.md

File metadata and controls

148 lines (106 loc) · 3.11 KB

Stripe

Payment processing, subscriptions, and billing for internet businesses.

Capabilities

Integration Available Notes
API ✓ Comprehensive REST API
MCP ✓ Available via Stripe MCP server
CLI ✓ stripe CLI for testing and webhooks
SDK ✓ Official SDKs for most languages

Authentication

  • Type: API Key
  • Header: Authorization: Bearer sk_live_xxx or sk_test_xxx
  • Keys: Secret key (server), Publishable key (client)

Common Agent Operations

List customers

GET https://api.stripe.com/v1/customers?limit=10

Get customer by email

GET https://api.stripe.com/v1/customers?email=user@example.com

Get subscription

GET https://api.stripe.com/v1/subscriptions/{subscription_id}

List subscriptions for customer

GET https://api.stripe.com/v1/subscriptions?customer={customer_id}

Create checkout session

POST https://api.stripe.com/v1/checkout/sessions

customer={customer_id}
&line_items[0][price]={price_id}
&line_items[0][quantity]=1
&mode=subscription
&success_url=https://example.com/success
&cancel_url=https://example.com/cancel

Create customer portal session

POST https://api.stripe.com/v1/billing_portal/sessions

customer={customer_id}
&return_url=https://example.com/account

List recent invoices

GET https://api.stripe.com/v1/invoices?customer={customer_id}&limit=10

Get payment intent

GET https://api.stripe.com/v1/payment_intents/{payment_intent_id}

Webhook Events

Key events to handle:

Event When Action
checkout.session.completed Successful checkout Provision access
customer.subscription.created New subscription Update user record
customer.subscription.updated Plan change Update entitlements
customer.subscription.deleted Cancellation Revoke access
invoice.payment_failed Payment failed Notify user, retry
invoice.paid Invoice paid Confirm payment

Verify webhook signature

const event = stripe.webhooks.constructEvent(
  payload,
  sig,
  webhookSecret
);

CLI Commands

# Listen to webhooks locally
stripe listen --forward-to localhost:3000/webhooks

# Trigger test events
stripe trigger checkout.session.completed

# List recent events
stripe events list --limit 10

# Get resource
stripe customers retrieve cus_xxx

Key Objects

  • Customer - User billing profile
  • Subscription - Recurring billing
  • Price - Pricing configuration
  • Product - What you sell
  • Invoice - Billing document
  • PaymentIntent - One-time payment
  • Checkout Session - Hosted payment page

When to Use

  • Processing payments
  • Managing subscriptions
  • Creating checkout flows
  • Handling billing portal
  • Querying customer data
  • Revenue analytics

Rate Limits

  • 100 read requests per second
  • 100 write requests per second
  • Higher limits available on request

Relevant Skills

  • pricing
  • referrals (Stripe-integrated affiliate tools)
  • analytics (revenue tracking)