Stripe API Integration

Complete Stripe API reference. See auxiliary files for detailed operations.

Quick Start

curl https://api.stripe.com/v1/balance -u "$STRIPE_SECRET_KEY:"

Setup

On first use, read setup.md. Preferences stored in ~/stripe-api-integration/memory.md.

When to Use

Any Stripe operation: payments, subscriptions, invoices, checkout, webhooks, Connect, Issuing, Terminal, Treasury.

Architecture

~/stripe-api-integration/
├── memory.md      # Account context
└── webhooks.md    # Webhook configs

Quick Reference

| Topic | File | |-------|------| | Setup & memory | setup.md, memory-template.md | | Payments, refunds, disputes | payments.md | | Customers, products, prices | customers.md | | Subscriptions, usage billing | subscriptions.md | | Checkout Sessions | checkout.md | | Connect (marketplaces) | connect.md | | Webhooks & events | webhooks.md | | Invoices, quotes, tax | invoices.md | | Issuing, Terminal, Treasury, Identity, Radar | advanced.md |

Core Rules

1. Test mode first — Use sk_test_* keys. Test card: 4242424242424242
2. Amounts in cents — $10.00 = 1000
3. Idempotency keys — Prevent duplicate charges
4. Webhooks required — Never trust API response alone
5. Expand objects — Use ?expand[]=customer for related data
6. Pagination — Use starting_after for large lists
7. Error handling — See payments.md for error codes

Authentication

Required environment variables:

• STRIPE_SECRET_KEY — API key for all Stripe operations (starts with sk_test_ or sk_live_)
• STRIPE_WEBHOOK_SECRET — Signing secret for webhook verification (starts with whsec_)

curl https://api.stripe.com/v1/customers -u "$STRIPE_SECRET_KEY:"

Common Traps

• Amount in dollars not cents → 100x wrong charge
• No idempotency key → duplicate charges
• Skip webhook verification → accept fake events
• Ignore requires_action → 3DS stuck

External Endpoints

| Endpoint | Purpose | |----------|---------| | https://api.stripe.com/v1/* | API |

Security & Privacy

Environment variables used:

• STRIPE_SECRET_KEY — for API authentication
• STRIPE_WEBHOOK_SECRET — for webhook signature verification

Sent to Stripe: Customer info, payment data via api.stripe.com Stays local: API keys (never logged), ~/stripe-api-integration/ preferences Never: Log card numbers, skip webhook verification, expose keys

Trust

This skill sends data to Stripe (stripe.com).

Related Skills

Install with clawhub install <slug> if user confirms:

• api — REST API patterns
• saas — SaaS metrics
• webhook — Webhook patterns

Feedback

• If useful: clawhub star stripe-api-integration
• Stay updated: clawhub sync