mollie/mollie-api-php

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 #895

Full Changelog: v3.13.0...v3.13.1

What's Changed

• feat: add terminal pairing code endpoints by @gabrielciobanu-mollie in #894
• feat: re-add payouts endpoints (restored after revert) by @Naoray in #893

New Contributors

• @gabrielciobanu-mollie made their first contribution in #894

Full Changelog: v3.12.0...v3.13.0

What's Changed

• fix: add scopes query parameter to list customer mandates by @Naoray in #887
• feat: add Google Pay direct integration support by @Naoray in #888
• fix: pass settlement pagination filters by @Naoray in #889

Full Changelog: v3.11.0...v3.12.0

What's Changed

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

Full Changelog: v3.10.0...v3.11.0

What's Changed

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

New Contributors

• @dionnijssen made their first contribution in #871

Full Changelog: v3.9.0...v3.10.0

What's Changed

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

New Contributors

• @derrabus made their first contribution in #852
• @NormanAlbert91 made their first contribution in #862

Full Changelog: v3.8.0...v3.9.0

What's Changed

• Feature: added metadata to connect balance transfer by @Naoray in #848
• Fixed: cURL deprecation notice for PHP 8.5 and higher by @RobinvanderVliet in #847
• Fixed: make TransferParty data accessible for debugging by @Naoray in #849
• Fixed inclusion and embed query mismatches by @Naoray and @sandervanhooft in #851

New Contributors

• @RobinvanderVliet made their first contribution in #847

Full Changelog: v3.7.0...v3.8.0

What's Changed

• feat: add metadata to connect balance transfer by @Naoray in https://github.com/mollie/mollie-api-php/pull/848
• Fix cURL deprecation notice for PHP 8.5 and higher by @RobinvanderVliet in https://github.com/mollie/mollie-api-php/pull/847
• fix: make TransferParty data accessible for debugging by @Naoray in https://github.com/mollie/mollie-api-php/pull/849
• Sandervanhooft fix/inclusion qr mismatch by @Naoray 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 #844
• Add fromArray to Money by @Naoray in #846

New Contributors

• @samdejongobc made their first contribution in #844

Full Changelog: v3.6.0...v3.7.0

What's Changed

• Add GOOGLEPAY and SWISH payment methods 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 #842
• Fixed webhook docs typo and explained next-gen webhook focus by @sandervanhooft in #841

Full Changelog: v3.5.0...v3.6.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

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: 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/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

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

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

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

• 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