This is the official TypeScript SDK for interacting with the Mollie Payments API, providing a type-safe and developer-friendly interface. It is currently at version 1.5.2 and maintains a rapid release cadence, with updates often published multiple times a week. The SDK is automatically generated using the Speakeasy CLI based on the Mollie OpenAPI specification, ensuring it stays up-to-date with the latest API changes. Key differentiators include full TypeScript support for robust development, explicit handling for authentication via API keys, organization access tokens, or OAuth, and built-in features like idempotency keys, custom User-Agent headers, pagination helpers, and automatic retry mechanisms. It supports both CommonJS and ES Modules runtimes for broad compatibility.
npm install mollie-api-typescriptVerified import paths — ran on the pinned version, not inferred.
This example initializes the Mollie client with an organization access token and fetches a paginated list of balances in EUR, demonstrating basic client setup and API interaction.
Review the API documentation for the settlements endpoint and update your calls to remove the `testmode` parameter and adapt to the new response object structures. Regenerate types or update your code if you were relying on previous type definitions.
Always review the SDK's `CHANGELOG.md` or release notes before updating, especially if you are using specific API endpoints that frequently evolve. Implement robust error handling and potentially API version pinning in critical production environments.
Ensure you are using the correct security scheme and providing the appropriate environment variable (e.g., `CLIENT_API_KEY` or `CLIENT_ORGANIZATION_ACCESS_TOKEN`) matching the type of access you require. Verify that the token has the necessary scopes for the API operations you are performing.
Always use the `for await...of` loop or explicitly handle the `nextPage()` method provided by the SDK's pagination helpers when dealing with list operations to ensure all available results are processed. Consult the SDK's usage examples for proper pagination patterns.
Verify that your `security` configuration when initializing the `Client` is correct and that the associated environment variable (e.g., `CLIENT_ORGANIZATION_ACCESS_TOKEN`) holds a valid, active token with the necessary permissions.
Update the `mollie-api-typescript` package to the latest version using `npm update mollie-api-typescript` or `yarn upgrade mollie-api-typescript`. Double-check the SDK documentation for the correct method names and casing.
Update `mollie-api-typescript` to the latest version. New API features and corresponding request/response properties are added as the SDK is generated from the most recent OpenAPI specification.
When running in a browser environment, configure your build tools (e.g., Webpack, Rollup, Parcel, Vite) to provide a polyfill or substitute for `process.env`, or pass environment variables explicitly during the build process instead of relying on runtime access.
No dependency data recorded yet.