mollie/mollie-api-php v4.1.0

on PHP Packagist

This release restores voucher category parameters and includes the fixes and additions merged since v4.0.0. Requires PHP 8.2 or newer.

Fixed

• Voucher payments: restore category and categories on OrderLine, including factory mapping. Use categories for payment and payment-link lines and category for order lines. This fixes the missing voucher parameters in v4. Thanks to @jasperdar for #947.
• Sales invoices: hydrate collections returned under _embedded.invoices, while retaining the existing registry names and legacy response aliases (#935).
• HTTP failures: classify network and request errors consistently with Guzzle 7 and 8. Preserve original exceptions, avoid retrying malformed requests, and do not treat incomplete transfers as completed HTTP responses (#937).
• Checkout Sessions: align the request and resource models with the API specification (#932).

Added

• Checkout Session requiredCustomerDetails support in request objects and factories, plus requiredCustomerDetails, profileId, createdAt, expiredAt, and completedAt on session resources. Customer-detail collection is a private-beta API feature (#932).
• Guzzle 8 compatibility, tested alongside Guzzle 7 with lowest and stable dependencies (#937).

Deprecated

• Checkout Session cancelUrl and Session::getRedirectUrl() are documented as deprecated: the API does not accept a cancel URL and returns only a self link. Use clientAccessToken with Mollie's client-side components (#932).

Documentation and maintenance

• Clarify that Google Pay payments use PaymentMethod::Creditcard, with googlePayPaymentToken for direct integration. PaymentMethod::Googlepay remains a wallet identifier for the Methods API, not a valid Create payment method (#934).
• Add MoneyPHP and Brick Money macro examples (#941).
• Extend CI coverage through PHP 8.6 and remove obsolete reflection calls from tests (#928, #929, #945).

The release commit passed the PHP 8.2–8.6 / Guzzle 7–8 CI matrix, PHPStan, and code style checks. The voucher fix was also verified with 20 outgoing JSON checks covering direct and factory-created payments and payment links.

Full changelog: v4.0.0...v4.1.0