# Versioning and change log

This log details any breaking and non-breaking API changes we have released for our Account Payouts service.

Prerequisite
Make yourself familiar with our [API principles](/products/reference/api-principles) to ensure a resilient integration.

## Versioning log

br
#### Version 2025-01-01 (17 February 2025)

Version 3 of our Account Payouts API now unlocks support for Marketplaces. To achieve a Marketplaces flow you must use a [combination of our APIs](/products/marketplaces/).

#### Version 1/2 (27 July 2023)

Version 1 of the Account Payouts API launched.

## Change log (non-breaking changes)

br
#### Additional paymentState values (12 November 2025)

details
summary
More details
You may now receive the following new [paymentState values](/products/account-payouts/openapi/get-payouts-by-payout-request-id/getbypayoutrequestid#get-payouts-by-payout-request-id/getbypayoutrequestid/t=response&c=200&path=paymentstate):

* `IN_REVIEW` - the payout is under compliance review
* `RFI_IN_PROGRESS` - the payout is on hold pending compliance review
* `AWAITING_LIQUIDITY` - the payout is on hold due to insufficient funds


The paymentState `RFI_IN_PROGRESS` and `AWAITING_LIQUIDITY` are not enabled by default. Please contact your Implementation Manager.

#### New daily reminder for insufficient liquidity (10 November 2025)

details
summary
More details
You can now receive a [daily event reminding you that your account remains in deficit](/products/account-payouts/account-events#supported-event-webhooks) and must be credited to release pending payouts.

#### Release of channel and routedChannel (09 October 2025)

details
summary
More details
You can now submit a [`channel`](/products/account-payouts/openapi/single-payout/postpayout#single-payout/postpayout/t=request&path=instruction/channel) in your account payout request to send your payout down your preferred route.
`channel` replaces the use of the `fastPayment` property which will continue to work for existing customers but will be removed in the next version.

br
We now also return a `routedChannel` in your GET response to advise which channel was used to route your payout.

#### Event webhook updates (28 August 2025)

details
summary
More details
We have released a new ["RFI in Progress" webhook](/products/account-payouts/account-events#payout-rfi-in-progress) advising you that a payout is on hold pending a compliance review.

We have also released preview documentation for:

* [low balance](/products/account-payouts/account-events#low-balance)
* [insufficient liquidity](/products/account-payouts/account-events#insufficient-liquidity)
* [payout in review](/products/account-payouts/account-events#payout-in-review) and
* [payout screening release](/products/account-payouts/account-events#payout-released)


events.

Additionally, you can preview documentation for extra fields, `channel` and `routedChannel`, we have added to our [success](/products/account-payouts/account-events#payout-success) and [reversal](/products/account-payouts/account-events#payout-reversal) webhooks.

#### Notification Of Change (NOC) US (26 August 2025)

details
summary
More details
You may now receive a [Notification Of Change (NOC)](/products/account-payouts/account-events) to indicate that a beneficiary's bank details have changed for US Payouts.

#### Estimated payout date (27 March 2025)

details
summary
More details
You will now receive `estimatedSettlementDate` in your [account payout notifications](/products/account-payouts/v2/notifications). This gives you an estimate date of when the beneficiary will receive their funds.