stripe/stripe-node
Stripe Node
This is a typed server-side library and payment gateway SDK for integrating Stripe into Node.js applications. It provides a typed client to manage payments, customers, and subscriptions, while offering specialized tools for executing secure financial transactions and managing billing resources.
The library distinguishes itself through an idempotent API client that prevents duplicate operations using idempotency keys and exponential backoff retry logic. It includes a webhook signature validator to verify that incoming HTTPS event notifications are authentic and an async-iterator pagination wrapper for traversing large datasets.
The project covers a broad range of capabilities, including subscription billing management, payment platform orchestration for connected accounts, and resource search. It provides comprehensive response handling through object expansion and field selection, alongside security features for API request authentication and webhook verification.
The library is written in TypeScript.
Features
- Online Payment Processing - Provides a comprehensive server-side SDK to integrate digital payment processing, customers, and subscriptions.
- Type-Safe API Clients - Provides a typed TypeScript client for executing secure server-side requests to manage payments and subscriptions.
- Authenticated API Clients - Provides a programmatic client that uses API keys to authenticate and authorize requests to Stripe services.
- Billing and Subscription Management - Automates recurring billing lifecycles, customer plans, and payment method management.
- Payment Gateway SDKs - Provides a server-side toolkit for executing secure financial transactions and managing billing resources.
- Webhook Event Receivers - Receives and routes real-time event notifications from the payment gateway to trigger automated workflows.
- Webhook Signature Verifiers - Verifies the authenticity of incoming HTTP webhook payloads using cryptographic signatures and shared secrets.
- API Key Authentications - Authenticates server-side requests using secret or restricted API keys to control access and permissions.
- Operation Idempotency - Prevents duplicate financial operations during retries by using unique idempotency keys.
- Idempotency Key Injection - Prevents duplicate operations during retries by attaching unique idempotency keys to request headers.
- CRUD API Implementations - Implements standard CRUD operations to manage payment-related objects like customers and subscriptions.
- Node.js Clients - Ships a typed REST client specifically optimized for the Node.js runtime environment.
- Webhook Event Processors - Processes real-time account activity notifications received from Stripe via HTTPS endpoints.
- Financial Record Retrieval - Enables fetching and iterating through large sets of transaction or customer records using pagination and search tools.
- Connected Account Management - Supports building marketplaces by performing actions on behalf of connected third-party accounts.
- Business Object Search - Enables finding specific records across top-level resources using search methods and cursor-based pagination.
- Async Iterable Streams - Uses JavaScript async iterators to stream paginated data from the API without buffering the entire payload.
- Field Selection - Optimizes response payloads by allowing the specification of which dependent properties to return.
- Automatic API Pagination Engines - Automatically traverses multi-page API results using async iterators to remove manual cursor management.
- API Versioning Headers - Controls API behavior by injecting specific version strings into the request headers for individual calls.
- Automatic Retry Clients - Implements an HTTP client that automatically retries failed network requests using exponential backoff.
- Exponential Backoff Retries - Automatically re-attempts failed network requests using a timed delay to handle rate limits and instability.
- Version Pinning - Enables specifying a target API version via request headers to maintain consistent behavior across integrations.
- Object Expansions - Stripe retrieves full objects instead of IDs by specifying nested paths in the request to reduce the total number of API calls.
- Account-Based Request Routing - Directs API requests to specific connected accounts using identifiers provided in the request headers.
- API Versioning - Allows managing API versions for requests and webhooks to ensure compatibility and access new features.
- SDKs and APIs - Integrates Stripe payment and billing services.
