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

Test mode first — Use sk_test_* keys. Test card: 4242424242424242
Amounts in cents — $10.00 = 1000
Idempotency keys — Prevent duplicate charges
Webhooks required — Never trust API response alone
Expand objects — Use ?expand[]=customer for related data
Pagination — Use starting_after for large lists
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