// the find
stripe/stripe-node
Node.js library for the Stripe API.
The official Stripe Node.js SDK, maintained by Stripe engineers. Covers essentially all of the Stripe API surface including Connect, webhooks, Terminal, Treasury, Issuing, and the newer V2 API resources. Anyone building payment flows in Node should be using this rather than raw HTTP calls.
- Auto-pagination via async iterators and autoPagingEach/autoPagingToArray covers a genuinely annoying problem cleanly, with multiple API styles to fit different codebases.
- TypeScript types are first-party and generated from the OpenAPI spec, so they stay accurate. The expand field typing (string | Foo) is an honest representation of what the API actually returns.
- Built-in idempotent retries with exponential backoff by default—most people forget to implement this themselves, and getting it wrong causes duplicate charges.
- Pluggable HTTP client and crypto providers (NodeHttpClient vs FetchHttpClient, NodeCryptoProvider vs SubtleCryptoProvider) mean it works in edge runtimes and Deno without a separate package.
- Types only track the latest API version. If you're pinned to an older API version for billing compatibility reasons, you're stuck using ts-ignore comments throughout your codebase.
- The `expand` fields are typed as `string | Foo`, so you always have to cast after expand calls—there's no way for the type system to narrow based on what you passed in the expand array.
- Test files in the resources/ directory are plain JavaScript (.spec.js) while the source is TypeScript, which means the test coverage for individual resources doesn't get type checking.
- Minor version bumps can introduce TypeScript type errors due to enum additions or other non-runtime-breaking changes. That's explicitly called out in the README, but it's still a real pain when upgrading in a strict CI environment.