Changelog#
A record of significant changes to the GoCardless API, organised by year.
2025
9th May 2025 — Removed Refund API limit of 25 refunds per payment.
26th March 2025 — Added a new endpoint /balances that returns balances for a creditor.
27th January 2025 — Exposed processing errors in Mandate Import Entries API: Added status filter parameter. Added processing_errors response field.
This section will be updated as new changes are released.
2024
2nd December 2024 — Added ACH and PAD-specific API fields: Added mandate_request[consent_type] parameter to Billing Request creation. Added constraints[payment_method] parameter to Billing Request creation. Added subscription_request parameter to Billing Request creation. Added instalment_schedule_request parameter to Billing Request creation.
8th January 2024 — Added API fields for Faster ACH: Added payment[faster_ach] parameter to Payment creation. Added payment[faster_ach] response field to Payment responses. Added mandate[next_possible_standard_ach_charge_date] response field to Mandate responses.
These entries cover changes released in 2024.
2023
18th July 2023 — Updated our public certificate policy.
21st June 2023 — Added the resource_metadata property to Events.
16th March 2023 — Added show_success_redirect_button parameter to Billing Request Flow creation.
1st March 2023 — Changed the Payout Items API to only return Payout Items created in the previous 6 months.
22nd February 2023 — Made the Billing Requests API and the Blocks API respond in English if the Accept-Language header isn't set, like other API endpoints.
8th February 2023 — Added billing_request[purpose_code] parameter to Billing Request creation.
13th January 2023 — Added the verified_at timestamp field to the Mandates API.
These entries cover changes released in 2023.
2022
23rd December 2022 — Updated our public certificate policy.
20th December 2022 — Added authorisation_source parameter to the Mandate creation API and mandate_request[authourisation_source] parameter to the Billing Request creation API. This field is required for offline mandates.
13th December 2022 — Added creditor_type parameter to the Creditors API.
9th December 2022 — Added language parameter to Billing Request Flow creation.
11th November 2022 — Added mandate_request[description] and mandate_request[constraints] parameter to Billing Request creation.
1st November 2022 — Payout Items are no longer ordered by type. The order of Payout Items for a given Payout is still consistent between requests.
5th August 2022 — Added payer_requested_dual_signature parameter to Billing Request action confirm payer details.
21st July 2022 — Added prefilled_customer and prefilled_bank_account parameters to Billing Request creation.
14th July 2022 — Added mandate_request[reference] parameter to Billing Request creation.
10th May 2022 — Autogiro scheme is now available in Billing Request flow.
4th May 2022 — Event creation is now an asynchronous process.
26th January 2022 — Added support for filtering events by instalment schedule.
These entries cover changes released in 2022.
2021
31st December 2021 — Added support for Sepa Credit Transfer and Sepa Instant Credit Transfer in Billing Request.
18th November 2021 — Added block endpoints.
5th August 2021 — Fixed reason codes sent for BECS so they are consistent with documentation.
30th March 2021 — Added Scenario Simulators endpoint for manual testing in Sandbox.
26th March 2021 — Added a new resource called Billing Requests.
28th January 2021 — Added webhook endpoints to view and retry webhooks. Began including webhook_id inside meta key in webhooks.
30th October 2020 — Added a new resource called Payer Authorisations.
12th August 2020 — Added a new event called payer_authorisation_completed.
14th July 2020 — Added support for applying tax to transaction and surcharge fees.
These entries cover changes released in 2020–2021.
2019–2015
2019 — Added support for PAD (Canadian) Direct Debit. Added idempotency_key to Webhooks. Added Betalingsservice (Danish Direct Debit).
2018 — Added support for BECS NZ (New Zealand). Added charge_date to payment responses. Added filtering by customer on payments and mandates list endpoints.
2017 — Added currency field to payment creation for foreign exchange payments. Added support for Autogiro (Swedish Direct Debit). Added Mandate PDFs endpoints. Added support for SEPA Core.
2016 — Added filtering by created_at to various APIs.
6th July 2015 — Released API version 2015-07-06. Removes Helpers endpoint. Renames start_at/end_at on subscriptions to start_date/end_date. Enforces date format for payment charge_date.
29th April 2015 — Released API version 2015-04-29. Removes Roles and Users. Replaces Api Keys with Access Tokens. Replaces Publishable Api Keys with Publishable Access Tokens.
These entries cover changes released between 2015 and 2019.