NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #2349 most downloaded on Packagist
GoCardless PHP Client Library
Latest stable
8.21.0
Last release 12 days ago
10 Nov 2026
Ships unpredictably
gaps range from 8 days to 13 months
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
141 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
Update test fixtures for BECS/AUD
Throws a GoCardlessInternalException, as expected, when the API returns a 500 Internal Server Error (previously, we threw a GoCardlessProException wit
GoCardlessInternalException, as expected, when the API returns a 500 Internal Server Error (previously, we threw a GoCardlessProException with the message "Invalid error type gocardless" 🙈) (#41)- Update payout currency comment
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Exposes the full HTTP response when the GoCardless API returns an error with a public getApiResponse() method on ApiException
getApiResponse() method on ApiExceptiondanish_identity_number attribute in the Customers APIApiException to be constructed with an ApiResponse$this->setExpectedException rather than annotations\GoCardlessPro\Support\TestFixtures traitAdds can_create_refunds attribute to responses from the Creditors API, to indicate whether a merchant may create refund payments.
can_create_refunds attribute to responses from the Creditors API, to indicate whether a merchant may create refund payments.Adds support for the new Payout Items API, allowing you to view, on a per-payout basis, the credit and debit items that make up that payout’s amount
Adds support for the new confirmation_url attribute in the Redirect Flow API
confirmation_url attribute in the Redirect Flow APIAdds support for the Creditors API's new verification_status attribute, which may be either action_required, in_review or successful. See the new "Hel
verification_status attribute, which may be either action_required, in_review or successful. See the new "Helping your users get verified" section in the partner guide for details.GET requests, so they're casted to strings as "true" or "false", rather than "1" or "" (see 0bed1c2bfebcd63b01819626791ef1ae9ec6307a for more details)Breaking change: Automatically retrieve and return the existing resource in the event of a 409 idempotent_creation_conflict response. This changes pre…
409 idempotent_creation_conflict response. This changes previous behaviour - instead of seeing an exception at this point, the client will now automatically retrieve the original resource that was created with that idempotency key.Add payout_type to Payout resource
payout_type to Payout resource- Update version - Update documentation URL
Support payments_require_approval on Mandates
payments_require_approval on Mandatesarrival_date and deducted_fees on PayoutsFix https://github.com/gocardless/gocardless-pro-php/issues/5 - Better hinting for IDEs using @return types
@return typesResolves an issue where package_path was being incorrectly generated
This release uses the bundled certificate for making requests.
This release uses the bundled certificate for making requests.
This release brings us closer to a _v1.0.0_ release and brings the general interface of the client in line with the existing ruby and python clients.
This release brings us closer to a v1.0.0 release and brings the general interface of the client in line with the existing ruby and python clients.
Query and request params as now nested under a params key.
For example:
$customers = $client->customers()->list(['params' => ['limit' => 400]]);
We've renamed the exception classes:
GoCardlessError -> GoCardlessProExceptionInvalidApiUsageError -> InvalidApiUsageExceptionInvalidStateError -> InvalidStateExceptionValidationFailedError -> ValidationFailedExceptionand altered the available api error methods slightly:
print_r($e->api_error)
/*
* stdClass Object
* (
* [message] => Payment cannot be cancelled
* [errors] => Array
* (
* [0] => stdClass Object
* (
* [reason] => cancellation_failed
* [message] => Payment cannot be cancelled
* )
*
* )
*
* [documentation_url] => https://developer.gocardless.com/pro#cancellation_failed
* [type] => invalid_state
* [request_id] => 262edcc8-8fdc-4b89-8040-c3d066cea430
* [code] => 422
* )
*/
$e->getType() // invalid_state
$e->getErrors() // Array of API errors
$e->getDocumentationUrl() // https://developer.gocardless.com/pro#cancellation_failed
$e->getRequestId() // 262edcc8-8fdc-4b89-8040-c3d066cea431
$e->getMessage() // Payment cannot be cancelled
$e->getCode() // 422
Fix SSL issues and cancel endpoints
Fix SSL issues and cancel endpoints
Support for GoCardless Pro API version 2015-07-06, along with the bank account lookup endpoint.
Support for GoCardless Pro API version 2015-07-06, along with the bank account lookup endpoint.
Adds support for the new mandate pdf and modulus check endpoints.
Adds support for the new mandate pdf and modulus check endpoints.
Nothing published for this version
Nothing published for this version
One column per quarter.