The API Report CardAPI Index
Stripe

Stripe API

stripe.com

Stripe's REST API at api.stripe.com is fully self-serve: free keys, SDKs in ten languages, a CLI, and 200 plus signed webhook event types; you pay per transaction. Versioning is date-pinned per account, and with no bulk endpoints, backfills iterate one object at a time.

Last verified: August 2026Financial ServicesMCP READY
API GRADE
A
VERIFIED AUG 2026

SCORECARD

ExistenceGOODPublic REST API at api.stripe.com; JSON responses, form-encoded requests, full OpenAPI spec.
AccessGOODSelf-serve secret keys per environment; access is free and you pay per transaction and per product.
CoverageGOODPayments through billing, tax, and identity are all programmatic; no bulk endpoints, so backfills iterate per object.
AuthGOODSecret and scoped restricted keys, Connect OAuth for platforms, and first-class idempotency keys.
Docs & DXGOODSDKs in ten languages, Stripe CLI, sandbox, OpenAPI spec; sandbox does not fully mimic live fraud or 3DS behavior.
StabilityGOODDate-stamped versions pinned per account with opt-in upgrades; webhook handlers must tolerate replays and reordering.
MCPGOODStripe publishes an official hosted MCP server at mcp.stripe.com with OAuth and Dashboard session management, exposing broad read and write access to the Stripe API including customers, invoices, subscriptions, refunds, and documentation search. Full install instructions for Cursor, Claude Code, VS Code, and other clients are at docs.stripe.com/mcp. docs.stripe.com VERIFIED 2026-08
Supergood turns hard-to-integrate enterprise software into clean REST APIs and MCP tools: stable endpoints, normalized JSON, managed auth.

Frequently asked questions

Stripe scores A on Supergood's API Report Card. Stripe's REST API at api.stripe.com is fully self-serve: free keys, SDKs in ten languages, a CLI, and 200 plus signed webhook event types; you pay per transaction. Versioning is date-pinned per account, and with no bulk endpoints, backfills iterate one object at a time.

Tried to integrate with Stripe?
SOURCES
API surface is enormous and still growing, onboarding a full Connect + Billing + Tax + Radar integration is a multi-week project even with great docs moldstud.com
Frequent API version bumps require teams to track changelogs and re-test against new dated versions; pinning per-account can hide breaking behavior in webhooks docs.stripe.com
Webhook delivery is at-least-once and can re-order, handlers must be idempotent and tolerate replays, which is a common source of double-grant bugs docs.stripe.com
Test/sandbox environment does not perfectly simulate production behaviors (e.g., live fraud signals, real bank-debit timing, certain 3DS flows) docs.stripe.com
API v2 (announced 2025) introduces a parallel surface alongside v1 that teams must now reason about docs.stripe.com
Rate limits can throttle bulk operations (e.g., backfilling Subscriptions or migrating Customers), no bulk endpoints; you iterate one object at a time docs.stripe.com
Restricted keys are powerful but per-permission scoping is fine-grained and tedious to configure in the Dashboard docs.stripe.com
Connect 'destination' vs. 'separate charges and transfers' vs. 'direct charges' models are notoriously confusing for marketplace builders docs.stripe.com
`expand` parameter helps avoid N+1 lookups but is undocumented for some nested resources, causing developers to guess paths docs.stripe.com
OpenAPI spec is published but lags behind the live API for new beta endpoints github.com
Idempotency-key window is 24 hours, retries beyond that can produce duplicates if not handled in application logic docs.stripe.com
Sudden account freezes/closures with funds held 90–180 days; common cause is being reclassified 'high risk' after volume spikes cardpaymentoptions.com
Stripe Inc. carries 1,000+ BBB complaints with a recurring pattern of frozen payouts and difficulty reaching a human reviewer bbb.org
Customer support is widely cited as slow, scripted, and unhelpful once an account is flagged, escalation paths are unclear technologyadvice.com
'High-risk' classification is opaque: businesses report being approved, processing for weeks, then being shut off with no specific TOS citation secureglobalpay.net
Chargeback / dispute fees ($15 per dispute) and limited merchant-side evidence tooling are common complaints cardpaymentoptions.com
Pricing creep at scale: standard 2.9% + $0.30 is competitive for SMB but uncompetitive vs. interchange++ offered by Adyen/Checkout.com once volume crosses ~$10M/yr index.dev
Reserves and rolling holds are imposed unilaterally on perceived-risky merchants (subscription, digital goods, supplements, crypto, adult, firearms, CBD) chargeback.io
Radar (fraud) sometimes blocks legitimate transactions with limited override; tuning requires Radar for Teams ($0.02/txn extra) stripe.com
Limited live phone support for non-enterprise accounts; chat/email queue can be 24–72h technologyadvice.com
Country/industry restrictions are restrictive vs. specialty acquirers, gambling, certain crypto, firearms, telemedicine controlled substances are prohibited stripe.com