# 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](/access/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](/access/products/marketplaces/).

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

Version 1 of the Account Payouts API launched.

## Change log (non-breaking changes)

br
#### New Try IPs for webhooks (23 March 2026)

details
summary
More details
To continue to receive event webhooks for our Try environment you must now whitelist a [new set of IP addresses](/access/products/account-payouts/account-events#configuration).

#### Defect fix (17 February 2026)

details
summary
More details
We have increased the date range, you can query your payouts for, from 30 to 31 days.

#### Updated 403 response (06 January 2026)

details
summary
More details
We have updated the `errorName` and `message` for our [403 response](/access/products/account-payouts/openapi/single-payout/postpayout#single-payout/postpayout/response&c=403) from:


```
{
  "errorName": "entityIsNotConfigured",
  "message": "Provided Identity is not valid"
}
```

to


```
"errorName": "forbidden",
  "message": "Forbidden. Unauthorised request"
```

#### Bank reference in payout search (09 December 2025)

details
summary
More details
You now receive a [`bankReference` in the response](/access/products/account-payouts/openapi/get-payouts) to your GET request. This bank-generated reference allows your customers to track their payout within the payment network.

#### Event webhook updates (26 November 2025)

details
summary
More details
You now receive additional fields `channel` and `routedChannel` in our [success](/access/products/account-payouts/account-events#payout-success) and [reversal](/access/products/account-payouts/account-events#payout-reversal) webhooks.

This is not enabled by default. Please speak to your Implementation Manager if you want to receive this.

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

details
summary
More details
You may now receive the following new [paymentState values](/access/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](/access/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`](/access/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](/access/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](/access/products/account-payouts/account-events#low-balance)
* [insufficient liquidity](/access/products/account-payouts/account-events#insufficient-liquidity)
* [payout in review](/access/products/account-payouts/account-events#payout-in-review) and
* [payout screening release](/access/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](/access/products/account-payouts/account-events#payout-success) and [reversal](/access/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)](/access/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](/access/products/account-payouts/v2/notifications). This gives you an estimate date of when the beneficiary will receive their funds.