NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #840 most downloaded on Packagist
Mollie API client library for PHP. Mollie is a European Payment Service provider and offers international payment methods such as Mastercard, VISA, American Express and PayPal, and local payment methods such as iDEAL, Bancontact, SOFORT Banking, SEPA direct debit, Belfius Direct Net, KBC Payment Button and various gift cards such as Podiumcadeaukaart and fashioncheque.
Latest stable
v4.1.0
Last release 17 days ago
04 Nov 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
13 years old
246 releases · first in 2013
Drag across the ruler to compare, or tap a release to open it.
We're urging you to test this release as soon as possible.
We're urging you to test this release as soon as possible.
This is an "alpha" pre-release covering PR #538 .
Essentially this PR is non-breaking, unless you're using dependency injection to instantiate the MollieApiClient.
You can test it by setting the following in your composer.json file:
"mollie-api-php": "2.31.0-alpha",
and run composer update.
Added the Organization.vatRegulation field.
Added the Organization.vatRegulation field.
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Added the nextPaymentDate field to the Subscription resource (#535 - docs). Thanks @hesje !
nextPaymentDate field to the Subscription resource (#535 - docs). Thanks @hesje !Marked PaymentMethod::INGHOMEPAY as deprecated. February 1st 2021, support for inghomepay will be discontinued. More info here.
Payment and OrderLine resources (thanks @ciungulete)PaymentMethod::INGHOMEPAY as deprecated. February 1st 2021, support for inghomepay will be discontinued. More info here.Added list methods to the paymentRefunds endpoint.
paymentRefunds endpoint.applicationFee method on the Payment resource.Thanks @ciungulete!
The value of the recently released payment.amountChargedBack attribute is positive. The attribute's docblock now reflects this.
payment.amountChargedBack attribute is positive. The attribute's docblock now reflects this.Fixed the pre-built zip by updating PHP Scoper. Thanks @ciungulete!
Fixed the pre-built zip by updating PHP Scoper. Thanks @ciungulete!
Added amountChargedBack attribute to the Payment resource.
Added amountChargedBack attribute to the Payment resource.
- Added support for PHP8 - Switched CI to Github Actions Thanks @ciungulete !
Thanks @ciungulete !
Dropped PaymentMethodStatus::PENDING_ONBOARDING
PaymentMethodStatus::PENDING_ONBOARDINGPaymentMethodStatus::PENDING_BOARDINGRefundStatus::FAILED and Refund::isFailed()OrderLine::update() to support empty parametersThanks @SanderVanLeeuwen for your help!
In the very rare occasion your application cannot reach Mollie, this client will now retry the request up to five times at an increasing interval.
In the very rare occasion your application cannot reach Mollie, this client will now retry the request up to five times at an increasing interval.
The ApiException message now contains the API response (when available) and a timestamp. So if anything goes wrong your log is even more helpful, espe
$settlement->payments() method: limit, parameters. So you can now control how you paginate through all payments for a specific settlement.The pre-built zip includes all dependencies, but Guzzle 7 was causing issues with older php versions.
The pre-built zip includes all dependencies, but Guzzle 7 was causing issues with older php versions.
This release reverts the zip to using Guzzle 6.
Nothing published for this version
Fixed issue #480 , the downloadable zip file for each release now again includes the dependencies.
When updating an Order or OrderLine, these attributes will now also be saved:
When updating an Order or OrderLine, these attributes will now also be saved:
Order:
OrderLine:
Nothing published for this version
Added paypal to the MandateMethod type (Thanks @mmachatschek !)
paypal to the MandateMethod type (Thanks @mmachatschek !)Added convenient forId methods to the SubscriptionEndpoint (thanks @Rkallenkoot !)
forId methods to the SubscriptionEndpoint (thanks @Rkallenkoot !)Added the status field to the Method resource
status field to the Method resourcePaymentMethodStatus typeAdded the metadata attribute to the OrderLine resource - thanks @reindernl !
metadata attribute to the OrderLine resource - thanks @reindernl !Added methods getSettlementAmount(), getAmountCaptured(), getApplicationFeeAmount() and a number of missing response fields to the Payment resource (t
getSettlementAmount(), getAmountCaptured(), getApplicationFeeAmount() and a number of missing response fields to the Payment resource (thanks @pmzandbergen!)refund() method.Are you using OAuth ( also known as Mollie Connect) in test mode?
Modified
Are you using OAuth ( also known as Mollie Connect) in test mode?
Calls made from retrieved resources no longer require you to explicitly set ['testmode' => true]. (But things will continue to work if you do.)
Changes include:
update(), payments(), createSubscription() and subscriptions().cancel(), createShipment(), getShipment(), shipAll(), shipments(), refund(), refundAllgetRefund(), getCapture(), getChargeback(), refund()Added
OrderLine.update() for updating a single OrderLine. (No OAuth testmode support yet.)Added the payments() method to the Subscription resource. This allows you to list all payments for a subscription.
Added the payments() method to the Subscription resource. This allows you to list all payments for a subscription.
Enabled updating the restrictPaymentMethodsToCountry attribute on the Payment resource.
Enabled updating the restrictPaymentMethodsToCountry attribute on the Payment resource.
Fixed updating the subscription metadata.
Fixed updating the subscription metadata.
Added support for updating subscription intervals.
whereStatus filter method to the MandateCollection.Fixed an issue accessing some subresources (#423, #424)
Fixed an issue accessing some subresources (#423, #424)
You can now paginate through subscriptions across all customers using $mollie->subscriptions->page().
You can now paginate through subscriptions across all customers using $mollie->subscriptions->page().
Direct integration of Apple Pay is now available.
Order, the orderNumber can now be updated as well.This is the 100th release of mollie-api-php! 🎉
Mollie now supports Apple Pay.
This is the 100th release of mollie-api-php! 🎉
Fixed a bug which occurred when calling $payment->chargebacks() without any chargebacks present.
Fixed a bug which occurred when calling $payment->chargebacks() without any chargebacks present.
Thanks @vdbelt!
Starting May 1st, Mollie no longer supports Bitcoin payments, so it's now marked as deprecated.
Starting May 1st, Mollie no longer supports Bitcoin payments, so it's now marked as deprecated.
Added support for the Onboarding API. Read more about this endpoint here. Big thanks to @LauLaman!
Added support for the Onboarding API. Read more about this endpoint here. Big thanks to @LauLaman!
Fixed a bug on $mollie->methods->allAvailable($parameters), where the parameters were not handled correctly.
Fixed a bug on $mollie->methods->allAvailable($parameters), where the parameters were not handled correctly.
You can find more information on the allAvailable method here.
Added minimumAmount and maximumAmount fields to the Method resource.
minimumAmount and maximumAmount fields to the Method resource.$mollie->methods->allAvailable() to use the profileId when using OAuth access tokens.Minor release: bumping the client version constant for easier debugging by Mollie's support desk.
Minor release: bumping the client version constant for easier debugging by Mollie's support desk.
Deprecated $mollie->methods->all(). Use $mollie->methods->allActive() instead.
This release resolves some confusion for listing payment methods via the Methods API:
Added $mollie->methods->allActive(). Retrieve all active payment methods. The results are not paginated. In test mode, this includes pending methods.
Added $mollie->methods->allAvailable(). Retrieve all payment methods offered by Mollie, for which the requesting organization is eligible. This includes both activated and not (yet) activated payment methods.
Deprecated $mollie->methods->all(). Use $mollie->methods->allActive() instead.
Added support for direct API calls to subresources. You're no longer required to first fetch the parent resource. Supported subresources include custo
Bugfix for fetching settlement payments
Bugfix for fetching settlement payments
Added payments() method to the Order resource. For this to work, don't forget to set the embed=payments flag while retrieving the Order. Read the Orde
payments() method to the Order resource. For this to work, don't forget to set the embed=payments flag while retrieving the Order. Read the Order API documentation for more information.MandateMethod::getForFirstPaymentMethod($firstMethod) for your convenience. Use this to retrieve the expected mandate method for a provided first payment method. A creditcard first payment will always result in a creditcard mandate. All other first payment methods (like ideal) will result in a directdebit mandate method.Added pricing() helper to the Method resource
pricing() helper to the Method resourceCREDITCARD constant to the MandateMethod typeAdded enable and disable payment methods for the current profile (me)
me)Fixed a bug (#344) introduced in v2.2.0. The bug rendered calling next() on a CursorCollection (Payments, Customers, etc.) useless. You can use it aga
next() on a CursorCollection (Payments, Customers, etc.) useless. You can use it again now 😅. Also note that there is a hasNext() helper method.Added $order->createPayment(...)
$order->createPayment(...)$mollie->profiles->getCurrent(), an alias for $mollie->profiles->get('me')Added $profile->enableMethod() and $profile->disableMethod()
$profile->enableMethod() and $profile->disableMethod()ApiException:
getResponse()hasLink()getLink()getUrl()getDashboardUrl()Marked the Order refunded status and isRefunded method as deprecated.
pending statusrefunded status and isRefunded method as deprecated.refunded status and isRefunded method as deprecated.Added the Chargeback endpoint, so you can list chargebacks across all payments on the payment profile.
Chargeback endpoint, so you can list chargebacks across all payments on the payment profile.settledAt property to Settlement resource. Helpful for your IDE's autocompletion features.The organizationName has been moved into the address objects. See: https://docs.mollie.com/changelog/v2/changelog
organizationName has been moved into the address objects. See: https://docs.mollie.com/changelog/v2/changelogAdded the organizationName to order resource.
organizationName to order resource.Examples are restructured for a better overview
Added mandateId to Subscription resource. You can use this to create a subscription with a specific mandate.
A fix was implemented for reading the body content properly
See: https://docs.mollie.com/reference/v2
See: https://docs.mollie.com/reference/v2
Nothing published for this version
Get current organization api.mollie.com/v2/organizations/me
api.mollie.com/v2/organizations/meapi.mollie.com/v2/organizations/*id*api.mollie.com/v2/organizations/*id*api.mollie.com/v2/permissions/*id*api.mollie.com/v2/permissionsinvoiceId added to Settlement resourcemode to Mandate resourceAdds a shortcut to cancel a Subscription
Smaller release, various unneeded files removed from distributions.
Added a static PHP-Scoper prefix: _MollieApiPhp
_MollieApiPhpOne column per quarter.