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.
This release introduces a breaking change: the PaymentRequestAmount field for BillingRequestTemplate creation has been updated from an int to a string…
This release introduces a breaking change: the PaymentRequestAmount field for BillingRequestTemplate creation has been updated from an int to a string.
If you are using this feature, please ensure you update your implementation accordingly and thoroughly test before deploying to your users.
Updates to phpdocs to address #188 #187 #186
Full Changelog: https://github.com/gocardless/gocardless-pro-php/compare/v5.10.0...v5.11.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Added /exports APIs and added exports as a new event type
Full Changelog: https://github.com/gocardless/gocardless-pro-php/compare/v5.9.0...v5.10.0
Schema changes for /branding/logos and /branding/payer_themes. Endpoints renamed to /branding/logos and /branding/payer_themes from /creditors/ /brand
Schema changes for /branding/logos and /branding/payer_themes.
Endpoints renamed to /branding/logos and /branding/payer_themes from /creditors/<creditor_id>/branding/logos, /creditors/<creditor_id>/branding/payer_themes
Added new endponts /branding/logos and /branding/payer_themes`
Added new endponts /branding/logos and /branding/payer_themes`
Added payer_requested_dual_signature parameter to Billing Request Confirmation.
Added payer_requested_dual_signature parameter to Billing Request Confirmation.
Added payment[faster_ach] parameter to Payment creation.
payment[faster_ach] parameter to Payment creation.payment[faster_ach] response field to Payment responses.mandate[next_possible_standard_ach_charge_date] response field to Mandate responses.Fixed Deprecated 'dynamic variable access' warning
Full Changelog: https://github.com/gocardless/gocardless-pro-php/compare/5.5.0...v5.5.1
Summary
Added new restricted transferred_mandates API endpoint to request updated customer bank account details.
Added verification_status to creditor_bank_accounts
verification_status to creditor_bank_accountsAdded refund_funds_returned to payout item types
Update pagination definition (non-functional change)
This new version, v5.1.0-beta includes the following changes:
This new version, v5.1.0-beta includes the following changes:
It also includes the changes from the previous beta (Removing PHP 7 support, and adding PHP8 support)
### Major Release v5.0.0-beta Changes include: * Dropped support for PHP v7 * Now support PHP v8.1+
Changes include:
Add country_code as required parameter to list institutions for billing request API
Changes include:
country_code as required parameter to list institutions for billing request APIAdd the list verification_details endpoint to allow listing verification details for a given creditor.
This release contains:
Adding POST /verification_details endpoint, which allows integrators to submit creditor based kyc information via the API
This release contains
Adding POST /verification_details endpoint, which allows integrators to submit creditor based kyc information via the API
Exposes Scheme identifiers for Create/Get/List via the API, and allows scheme Identifiers to be applied to creditors via the /creditors/:identity/actions/apply_scheme_identifier route added
verified_at attribute added to mandate resource
Added authorisation_source parameter to Mandate create API and BillingRequest mandate creation API.
Added authorisation_source parameter to Mandate create API and BillingRequest mandate creation API.
Making creditor_type and country_code required when creating creditors via the API (for payment providers);
creditor_type and country_code required when creating creditors via the API (for payment providers);null as an allowed value for creditor_type when creating creditors.Added language parameter to Billing Request Flow creation.
Added language parameter to Billing Request Flow creation.
Add mandate_request[description] and mandate_request[constraints] parameters to Billing Request creation Add consent_parameters to mandate
Add mandate_request[description] and mandate_request[constraints] parameters to Billing Request creation
Add consent_parameters to mandate
Remove phone number from prefilled_customer on billing request flow
Remove phone number from prefilled_customer on billing request flow
Add reference field to Mandate Request in Billing Request
Add reference field to Mandate Request in Billing Request
Nothing published for this version
Adds ip_address to customer_billing_detail property in Billing Request.
Adds ip_address to customer_billing_detail property in Billing Request.
Adds support for billing request fallbacks
add Institution.country_code property
Block apiInstitution.country_code propertyBillingRequest.exit_uri propertyFull Changelog: https://github.com/gocardless/gocardless-pro-php/compare/v4.14.0...v4.15.0
Nothing published for this version
Adds support for recent Billing Request Changes
Adds support for recent Billing Request Changes
Add Scenario Simulator endpoints
Nothing published for this version
Nothing published for this version
Add support for Guzzle 7 (2198b3928d9c59cd8b14bc7fe616a228bbfc692e, @BinaryKitten)
Added a new resource called payer_authorisatons
Added a new resource called payer_authorisatons
This is our new API dedicated to building custom payment pages. It encapsulates the creation of customer, bank account and mandate under this single resource.
This release contains some bug fixes and minor schema changes.
This release contains some bug fixes and minor schema changes.
Added a new event called payer_authorisation_completed for an upcoming resource type called payer_authorisation which provides customer, customer_bank
payer_authorisation_completed for an upcoming resource type called payer_authorisation which provides customer, customer_bank_account, mandate and payer_authorisation linksAdded support for applying tax to transaction and surcharge fees.
Adds support for not_retried_reason for payment failure event
Adds support for not_retried_reason for payment failure event
BugFix: parse 204 No Content responses correctly in getResourceResponse
BugFix: parse 204 No Content responses correctly in getResourceResponse
Support new update instalment schedules method
Support new update instalment schedules method
Update the services to include @method comments
Update the services to include @method comments
Supports new update payout route
Deprecate support for php 5.6 or 7.1
implode params in php 7.4)Fixes bug with 204 - No Content HTTP request throwing MalformedResponseException if the response body is not JSON
204 - No Content HTTP request throwing MalformedResponseException if the response body is not JSONAdds metadata param to redirect flow creation endpoint
uses new instalment schedules schema (with two different create methods)
Fix pass by reference of config hash. (Related Error Notice: 'Undefined index: error_on_idempotency_conflict' in /vendor/gocardless/gocardless-pro/lib
Notice: 'Undefined index: error_on_idempotency_conflict' in /vendor/gocardless/gocardless-pro/lib/Core/ApiClient.php on line 25)Support for erroring on Idempotency Key Conflict.
Adds retry_if_possible field on payments, subscriptions and instalment_schedules
adds 3 extra fields to the creditors API
Adds functionality to support Instalment Schedules
bounced status on payoutsAllow integrator to specify an HTTP timeout when instantiating the client
Allow integrator to specify an HTTP timeout when instantiating the client
Add fx_payout_currency to creditor
Addition of the customer removal API
account_type in bank account APIAdd __isset() companion to __get()
__isset() companion to __get()BREAKING change webhook parsing to build nested objects rather than arrays (fixes https://github.com/gocardless/gocardless-pro-php/issues/47)
Add support for passing customer address fields to the Mandate PDFs creation endpoint.
Drop compatibility with PHP 5.5, since it is [no longer fully supported][1] (i.e. it has reached end-of-life), and continuing to support it stops us u
hash_equals function for constant time string comparison)GoCardlessPro\Resources\Event objectsAdd support for the new app_fee attribute returned by the Subscriptions API
app_fee attribute returned by the Subscriptions API* Add new Mandate Imports API * Update documentation for AUD
One column per quarter.