stripe-api
Use when working with Stripe API for payments, subscriptions, checkout sessions, webhooks, or billing. Also use when setting up Stripe authentication, handling payment errors, or troubleshooting rate limits.
| Model | Source |
|---|---|
| sonnet | pack: payments |
Overview
Section titled “Overview”Stripe API (version 2026-01-28.clover) for accepting payments, managing subscriptions, and building checkout experiences. Uses PaymentIntents for custom payment flows and Checkout Sessions for hosted/embedded payment pages.
Full Reference
┏━ 🔧 stripe-api ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ Use when working with Stripe API for payments,… ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
Stripe API
Section titled “Stripe API”Overview
Section titled “Overview”Stripe API (version 2026-01-28.clover) for accepting payments, managing subscriptions, and building checkout experiences. Uses PaymentIntents for custom payment flows and Checkout Sessions for hosted/embedded payment pages.
Quick Reference
Section titled “Quick Reference”| Item | Value |
|---|---|
| Current API Version | 2026-01-28.clover |
| Base URL | https://api.stripe.com/v1 |
| Auth | Secret key (sk_live_... / sk_test_...) |
| Python SDK | pip install stripe (v14.x) |
| Node.js SDK | npm install stripe (v20.x) |
| Versioning | Date-based with codenames: acacia → basil → clover |
| Docs | docs.stripe.com/api |
Reference Index
Section titled “Reference Index”| File | Contents |
|---|---|
reference/setup.md | API versioning, authentication, idempotency keys, SDK setup for Python/Node.js/other |
reference/payments.md | PaymentIntents, Payment Element, lifecycle states, auth+capture, saved payment methods |
reference/checkout.md | Hosted and embedded Checkout Sessions, subscription checkout, session expiration |
reference/subscriptions.md | Creating subscriptions, lifecycle, flexible billing mode, trials, pausing, canceling, dunning |
reference/webhooks.md | Endpoint setup, signature verification, best practices, secret rotation, local testing with CLI |
reference/errors.md | Error types, HTTP status codes, common error codes, handling patterns for Python/Node.js |
reference/rate-limits.md | Global limits, per-endpoint limits, read allocation, exponential backoff pattern |
reference/testing.md | Test card numbers, sandbox vs test mode, webhook local testing via Stripe CLI |
reference/changelog.md | Clover breaking changes, new features, active deprecations, Basil→Clover migration checklist |
reference/fees.md | US payment processing fees, additional service fees, currency minimums |
Usage: Read the reference file matching your current task from the index above. Each file is self-contained with code examples and inline gotchas.