Mollie Api Php Laravel Package

This release aligns the v2 Checkout Sessions integration with the current API specification.

• Add current Session response fields, including clientAccessToken, customer and payment details, profile ID, and lifecycle timestamps.
• Add STATUS_OPEN, STATUS_EXPIRED, isOpen(), and isExpired() while retaining legacy fields and helpers for compatibility.
• Update the create-session example to use top-level payment data and a client access token for frontend checkout. The requiredCustomerDetails option remains in private beta.

See #939 and the full comparison.

v3.15.0 brings rate-limit visibility and opt-in HTTP 429 retries to the PHP 7.4-compatible v3 line. Existing clients keep their current retry behavior unless they select the new strategy.

Added

• Response::header() and headers() expose response headers. Response::rateLimit() parses Mollie's RateLimit and RateLimit-Policy headers into a RateLimit object with the policy, remaining requests, restore time, burst, quota, and window. Missing or malformed rate-limit headers return null.
• TooManyRequestsException::getRetryAfterSeconds() exposes Retry-After as a delay in seconds, accepting both integer seconds and HTTP-date values.
• ExponentialRetryStrategy can retry temporary network failures and HTTP 429 responses. It supports exponential backoff, optional jitter, and a maximum delay budget. A 429 whose Retry-After exceeds that budget is thrown rather than delayed.
• ConditionalRetryStrategyContract lets custom strategies decide which exceptions to retry and use the triggering exception when calculating a delay.

Compatibility

LinearRetryStrategy remains the default and continues to retry temporary network failures as before. The original RetryStrategyContract is unchanged, so existing custom strategies require no migration. The new behavior is opt-in:

use Mollie\Api\Http\ExponentialRetryStrategy;

$client->setRetryStrategy(new ExponentialRetryStrategy());

See the retry guide for configuration and custom strategy examples, or compare v3.14.0 with v3.15.0 for all changes.

Added

• RateLimit value object and Response::rateLimit() accessor for RateLimit and RateLimit-Policy response headers.
• middleware()->onResolved(), a post-hydration middleware phase for transforms that need the hydrated resource or collection rather than the raw response.
• Mollie\Api\Utils\Utility::isTrue(), the shared boolean coercion used for API-facing scalar values such as testmode arriving from a query string or payload.

Changed

• ExponentialRetryStrategy skips 429 retries when Retry-After exceeds maxDelayMs and adds bounded, additive jitter when honoring the header.
• ExponentialRetryStrategy applies the maxDelayMs cap before exponential full jitter, avoiding a probability spike at the cap.
• onResponse() callbacks now always receive the raw Response, regardless of priority. Move transforms that expect a hydrated resource or collection to onResolved(). See UPGRADING.md section 3.7.
• Custom endpoint maps are declared with a class constant. Subclasses that mutated the protected static $endpoints property must override the protected ENDPOINTS constant instead. See UPGRADING.md section 3.6.
• The one-shot idempotency key is now transferred to the request while it is assembled and cleared from the connector immediately, so a failed or exhausted retry can no longer leak it into a later request. Retries reuse the key already on the assembled request.
• Test mode is resolved once per request, with API-key precedence, so the value observed on the request cannot drift from the value sent to Mollie.
• Balance transaction listing propagates one effective test mode across every list, page and iterator route.
• Request factories resolve values by key presence rather than truthiness, so explicitly supplied falsy values such as 0, "0" and 0.0 are no longer dropped.
• ResourceRegistry keeps its class and type indexes consistent, and paginated query factories build their query from one authoritative input map.

Removed

• Mollie\Api\Http\Middleware\ResetIdempotencyKey. It cleared the connector key from the response phase, which never runs when a request throws. Clearing now happens during request assembly, so no replacement is needed. setIdempotencyKey() and resetIdempotencyKey() are unchanged.

For contributors

• Formatting moved from PHP-CS-Fixer to Laravel Pint. Run composer format to apply and composer check:format to verify. The rule set is unchanged, so no reformatting is required on in-flight branches.
• The code style workflow reports violations instead of committing fixes back to the branch, and CI validation reads the repository's real PHPStan and PHPUnit configuration.
• bin/release publishes only from an already-merged remote state and honors the operator's tag signing configuration.
• The changelog workflow derives its identity from the release event and triggers on published, so pre-releases are no longer skipped.

What’s Changed

• Update signature-verification.md by @fjbender in https://github.com/mollie/mollie-api-php/pull/902
• Do not drop request fields whose value is 0, "0" or 0.0 by @winklemad in https://github.com/mollie/mollie-api-php/pull/907

New Contributors

• @winklemad made their first contribution in https://github.com/mollie/mollie-api-php/pull/907

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.13.1...v3.13.2

First beta of v4.0.0 — the PHP 8.2+ modernization (#901).

Highlights:

• PHP 8.2+ required; CI covers 8.2, 8.3, 8.4
• All src/Types/ constants are now string-backed enums (PaymentStatus::Paid)
• Typed resource properties and readonly value objects (Money, Address, OrderLine, …)
• Generic return types on MollieApiClient::send() — your IDE infers the resource from the request class
• Money::of() fluent builder, typed MockResponse factories
• ExponentialRetryStrategy with jitter and HTTP 429 / Retry-After support
• Test suite migrated to Pest v3

This is a pre-release for early adopters; expect breaking changes until 4.0.0 stable. Full details in the changelog and the upgrade guide.

Install:

composer require mollie/mollie-api-php:^4.0@beta

Feedback welcome on #901.

What's Changed

• fix: support applicationFee on payment link creation by @Naoray in https://github.com/mollie/mollie-api-php/pull/895

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.13.0...v3.13.1

What's Changed

• feat: add terminal pairing code endpoints by @gabrielciobanu-mollie in https://github.com/mollie/mollie-api-php/pull/894
• feat: re-add payouts endpoints (restored after revert) by @Naoray in https://github.com/mollie/mollie-api-php/pull/893

New Contributors

• @gabrielciobanu-mollie made their first contribution in https://github.com/mollie/mollie-api-php/pull/894

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.12.0...v3.13.0

What's Changed

• fix: add scopes query parameter to list customer mandates by @Naoray in https://github.com/mollie/mollie-api-php/pull/887
• feat: add Google Pay direct integration support by @Naoray in https://github.com/mollie/mollie-api-php/pull/888
• fix: pass settlement pagination filters by @Naoray in https://github.com/mollie/mollie-api-php/pull/889

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.11.0...v3.12.0

What's Changed

• refactor(webhooks): decouple hydrated resources from the HTTP domain by @Naoray in https://github.com/mollie/mollie-api-php/pull/880
• fix(webhooks): hydrate entity locally from signed snapshot by @Naoray in https://github.com/mollie/mollie-api-php/pull/879
• fix: change customer email property type to a nullable string by @edwinvdpol in https://github.com/mollie/mollie-api-php/pull/882
• fix: make all UpdateSalesInvoiceRequest params optional by @Naoray in https://github.com/mollie/mollie-api-php/pull/885
• fix: make all UpdateSalesInvoiceRequest params optional by @fjbender in https://github.com/mollie/mollie-api-php/pull/884

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.10.0...v3.11.0

What's Changed

• Update documentation link for methods API by @sandervanhooft in https://github.com/mollie/mollie-api-php/pull/866
• docs: add full OAuth permission scopes list and link to official reference by @Naoray in https://github.com/mollie/mollie-api-php/pull/867
• docs: fix documentation reference url by @dionnijssen in https://github.com/mollie/mollie-api-php/pull/871
• Fix: Add missing googlepay type to wallet constants by @NormanAlbert91 in https://github.com/mollie/mollie-api-php/pull/869
• feat: Add BACS mandate method for UK direct debit support by @sandervanhooft in https://github.com/mollie/mollie-api-php/pull/870
• Fix PHPStan CI: replace ramsey/composer-install with plain composer install by @Naoray in https://github.com/mollie/mollie-api-php/pull/873
• Fix PHP 8+ deprecation warning in CreatePaymentRefundRequest by @Naoray in https://github.com/mollie/mollie-api-php/pull/872
• Fix onFatal callback bug + strict comparison consistency by @Naoray in https://github.com/mollie/mollie-api-php/pull/874
• feat: add lines, addresses and minimumAmount to Payment Links API by @Naoray in https://github.com/mollie/mollie-api-php/pull/877
• feat(sessions): align session endpoint with API specification by @Naoray in https://github.com/mollie/mollie-api-php/pull/858

New Contributors

• @dionnijssen made their first contribution in https://github.com/mollie/mollie-api-php/pull/871

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.9.0...v3.10.0

What's Changed

• Fix: Don't call deprecated setAccessible() by @derrabus in https://github.com/mollie/mollie-api-php/pull/852
• Fix documented Capability::$requirements structure by @derrabus in https://github.com/mollie/mollie-api-php/pull/853
• feat(auth): add setToken helper for api keys by @Naoray in https://github.com/mollie/mollie-api-php/pull/859
• Chore/enhance sdk with docs and convenience methods by @Naoray in https://github.com/mollie/mollie-api-php/pull/855
• Fix/wrong payment details attribute by @Naoray in https://github.com/mollie/mollie-api-php/pull/854
• Remove incorrect null return type from ClientLink::getRedirectUrl() by @Naoray in https://github.com/mollie/mollie-api-php/pull/865
• Remove incorrect null return type from ClientLink::getRedirectUrl() by @NormanAlbert91 in https://github.com/mollie/mollie-api-php/pull/862

New Contributors

• @derrabus made their first contribution in https://github.com/mollie/mollie-api-php/pull/852
• @NormanAlbert91 made their first contribution in https://github.com/mollie/mollie-api-php/pull/862

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.8.0...v3.9.0

What's Changed

• Feature: added metadata to connect balance transfer by @Naoray in https://github.com/mollie/mollie-api-php/pull/848
• Fixed: cURL deprecation notice for PHP 8.5 and higher by @RobinvanderVliet in https://github.com/mollie/mollie-api-php/pull/847
• Fixed: make TransferParty data accessible for debugging by @Naoray in https://github.com/mollie/mollie-api-php/pull/849
• Fixed inclusion and embed query mismatches by @Naoray and @sandervanhooft in https://github.com/mollie/mollie-api-php/pull/851

New Contributors

• @RobinvanderVliet made their first contribution in https://github.com/mollie/mollie-api-php/pull/847

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.7.0...v3.8.0

What's Changed

• Add SWISH payment method by @samdejongobc in https://github.com/mollie/mollie-api-php/pull/844
• Add fromArray to Money by @Naoray in https://github.com/mollie/mollie-api-php/pull/846

New Contributors

• @samdejongobc made their first contribution in https://github.com/mollie/mollie-api-php/pull/844

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.6.0...v3.7.0

What's Changed

• Feat/add balance transfer webhook events by @sandervanhooft in https://github.com/mollie/mollie-api-php/pull/842
• Fixed webhook docs typo and explained next-gen webhook focus by @sandervanhooft in https://github.com/mollie/mollie-api-php/pull/841

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.5.0...v3.6.0

Added

• Feat/add retry logic by @Naoray in https://github.com/mollie/mollie-api-php/pull/826
• Feat/add fake retain requests option by @Naoray in https://github.com/mollie/mollie-api-php/pull/830
• feat: add isEInvoice param and add support for testmode in all sales-… by @Naoray in https://github.com/mollie/mollie-api-php/pull/832
• feat: add customerId and mandateId to create sales invoice request by @Naoray in https://github.com/mollie/mollie-api-php/pull/834
• Feat/add balance transfer endpoint by @Naoray in https://github.com/mollie/mollie-api-php/pull/831
• Feat/add webhook mapping and events by @Naoray in https://github.com/mollie/mollie-api-php/pull/829
  • global Config that serves as a lookup map to easily map resources to their respective collection keys
  • MockEvent to easily test event handling
  • Str utility class
  • classBasename to Utility
  • WebhookEntity to serve as Container for Resource data received through webhooks (-> can be transformed into BaseResource)
  • Webhook Events that are instanced via the WebhookEventMapper

Changed

• Feat/make sequence mock responses consume callables by @Naoray in https://github.com/mollie/mollie-api-php/pull/833

Fixed

• Change include to embed just like in GetPaginatedChargebacksRequest.php #837 by @Naoray in https://github.com/mollie/mollie-api-php/pull/838
• Allow description on CreatePaymentRefundRequest to be empty by @Naoray in https://github.com/mollie/mollie-api-php/pull/839

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.4.0...v3.5.0

This release introduces support for the brand new Delayed Routing API.

What's Changed

• Feat/add new payment route endpoints by @Naoray in https://github.com/mollie/mollie-api-php/pull/825

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.3.3...v3.4.0

What's Changed

• Fix/823 inconsistencies on payment link request by @Naoray in https://github.com/mollie/mollie-api-php/pull/824

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.3.2...v3.3.3

What's Changed

• Fix/819 signature date invalid by @Naoray in https://github.com/mollie/mollie-api-php/pull/820

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.3.1...v3.3.2

What's Changed

• fix: signature validator handling null signatures by @Naoray in https://github.com/mollie/mollie-api-php/pull/822

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.3.0...v3.3.1

What's Changed

• Feat/expose webhook signature header by @Naoray in https://github.com/mollie/mollie-api-php/pull/821
• Feat/expose webhook signature creation by @Naoray

What's Changed

• Feat/add create webhook endpoint by @Naoray in https://github.com/mollie/mollie-api-php/pull/812
• Feat/webhook signature verification by @Naoray in https://github.com/mollie/mollie-api-php/pull/813

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.1.5...v3.2.0

What's Changed

• Fix: allow array of payment methods when creating a payment by @jockri in https://github.com/mollie/mollie-api-php/pull/811
• Sandervanhooft fix/recipe classes by @Naoray in https://github.com/mollie/mollie-api-php/pull/815
• Fix class references on recipes by @sandervanhooft in https://github.com/mollie/mollie-api-php/pull/814
• Fix payment links expiresAt by @sandervanhooft in https://github.com/mollie/mollie-api-php/pull/817
• Change "include" into "embed" on GetPaginatedChargebacksRequest by @sandervanhooft in https://github.com/mollie/mollie-api-php/pull/818

New Contributors

• @jockri made their first contribution in https://github.com/mollie/mollie-api-php/pull/811

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.1.4...v3.1.5

What's Changed

• Fix 400 Bad Request on DELETE when store array is empty by @cswiers in https://github.com/mollie/mollie-api-php/pull/810

New Contributors

• @cswiers made their first contribution in https://github.com/mollie/mollie-api-php/pull/810

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.1.3...v3.1.4

What's Changed

• fix: allow profileId in AllMethods factory by @joester89 in https://github.com/mollie/mollie-api-php/pull/809

New Contributors

• @joester89 made their first contribution in https://github.com/mollie/mollie-api-php/pull/809

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.1.2...v3.1.3

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.1.1...v3.1.2

What's Changed

• Fix/include resources by @Naoray in https://github.com/mollie/mollie-api-php/pull/808

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.1.0...v3.1.1

What's Changed

• Main by @Naoray in https://github.com/mollie/mollie-api-php/pull/804
• feat: add status reason to payment resource by @Naoray in https://github.com/mollie/mollie-api-php/pull/806

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.0.6...v3.1.0

What's Changed

• Amend capturable recipe by @fjbender in https://github.com/mollie/mollie-api-php/pull/796
• fix: exchange wrong request name by @Naoray in https://github.com/mollie/mollie-api-php/pull/797
• Removes nullability from delete() method, as it cannot return null by @Sjustein in https://github.com/mollie/mollie-api-php/pull/802
• fix: use payload instead of query params for testmode by @Naoray in https://github.com/mollie/mollie-api-php/pull/803

New Contributors

• @Sjustein made their first contribution in https://github.com/mollie/mollie-api-php/pull/802

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.0.5...v3.0.6

What's Changed

• accepted response should accept empty body by @Naoray in https://github.com/mollie/mollie-api-php/pull/799

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v2.79.0...v2.79.1

What's Changed

• Fix/791 data types may mess up property order by @Naoray in https://github.com/mollie/mollie-api-php/pull/794

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.0.4...v3.0.5

What's Changed

• Chore/allow psr message v1 by @Naoray in https://github.com/mollie/mollie-api-php/pull/793
• Fix/789 remove overhault to resource calls by @Naoray in https://github.com/mollie/mollie-api-php/pull/792

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.0.3...v3.0.4

What's Changed

• Fixed docs links by @sandervanhooft in https://github.com/mollie/mollie-api-php/pull/787
• Feat/small improvements by @Naoray in https://github.com/mollie/mollie-api-php/pull/788
  • make MockResponse serializable
  • add changed $metadata handling to upgrade guide

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.0.2...v3.0.3

What's Changed

• handle nullable 422 exception field by @sandervanhooft in https://github.com/mollie/mollie-api-php/pull/786

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.0.1...v3.0.2

What's Changed

• fix: remove Metadata as it is not supposed to be sent as json encoded data by @Naoray in https://github.com/mollie/mollie-api-php/pull/783

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.0.0...v3.0.1

🎉 Introducing version 3 of mollie-api-php. Enjoy!

Upgrading from version 2? Check out the upgrade guide here.

What's Changed

• Endpoint structure change poc by @Naoray in https://github.com/mollie/mollie-api-php/pull/736
• Add support for php8.4 to GH test workflow by @sandervanhooft in https://github.com/mollie/mollie-api-php/pull/755
• V3 without dedicated payloads and queries by @Naoray in https://github.com/mollie/mollie-api-php/pull/759
• V3 recipes by @sandervanhooft in https://github.com/mollie/mollie-api-php/pull/768
• Exceptions documentation by @sandervanhooft in https://github.com/mollie/mollie-api-php/pull/769
• Add MB Way and Multibanco to PaymentMethod type by @mweghorst in https://github.com/mollie/mollie-api-php/pull/770
• V3: Added payment methods mbway and multibanco by @sandervanhooft in https://github.com/mollie/mollie-api-php/pull/771
• fix: add missing psr/http-client dependency by @Naoray in https://github.com/mollie/mollie-api-php/pull/774
• V3 fix/consistent handling of transforming request values by @Naoray in https://github.com/mollie/mollie-api-php/pull/777
• Feat v3/add get testmode to pending request by @Naoray in https://github.com/mollie/mollie-api-php/pull/778
• V3 fix/query include statements by @Naoray in https://github.com/mollie/mollie-api-php/pull/779
• Improve v3 upgrade guide readability by @sandervanhooft in https://github.com/mollie/mollie-api-php/pull/781
• Feat/766 filter out null payment methods with null status by @Naoray in https://github.com/mollie/mollie-api-php/pull/780
• V3 by @Naoray in https://github.com/mollie/mollie-api-php/pull/727

New Contributors

• @mweghorst made their first contribution in https://github.com/mollie/mollie-api-php/pull/770

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v2.78.0...v3.0.0

What's Changed

• V3 fix/query include statements by @Naoray in https://github.com/mollie/mollie-api-php/pull/779

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.0.0-beta.10...v3.0.0-beta.11

What's Changed

• Feat v3/add get testmode to pending request by @Naoray in https://github.com/mollie/mollie-api-php/pull/778

Full Changelog: https://github.com/mollie/mollie-api-php/compare/v3.0.0-beta.9...v3.0.0-beta.10