Mollie API client for PHP v3 is now production ready

We’re excited to announce that version version 3 of the Mollie API client for PHP is now production ready.

This major release brings a modern developer experience, better testability, improved debugging, and long-requested flexibility around HTTP clients and error handling. After extensive community testing during the beta period, it’s now stable for production use.

Highlights of v3

• ✅ Fully typed request objects for IDE autocompletion and static analysis
• ✅ Global and per-request test mode configuration
• ✅ Comprehensive API mocking for tests, including errors and embedded resources
• ✅ Enhanced debugging with safe request/response output
• ✅ Dedicated exception classes for granular error handling
• ✅ PSR-18 HTTP client support with first-party adapter
• ✅ Clean object-oriented API responses with optional raw access
• ✅ Custom resource wrappers for seamless domain integration

You can read more about these features in our v3 beta announcement or the official documentation.

Upgrade Instructions

composer require mollie/mollie-api-php:^3.0

Be sure to review the upgrade guide for any breaking changes before upgrading.

Thank You

Thanks to everyone who tested the beta and shared feedback. This release was a collaboration between the Mollie team and Sandorian. Special shout out to Krishan König for leading the rewrite and pushing the client into a new era.

Need help or want to contribute? Visit the GitHub repository.