{"title":"Rolling reserves","category":"default","creationDate":1753898220,"content":"

Limited availability<\/strong><\/span><\/span>
\nAdyen's Managed Risk solution is in pilot phase. Some of the processes and documentation may change as the solution evolves.<\/p>\n

\n

If your user is considered higher risk due to their industry or behavior, we withhold a percentage of their daily sales volume from the sales day's settlement batch for a certain period of time. Adyen holds the reserved funds until the end of the rolling reserve cycle, then releases them to your user's balance account. When the funds become available, you can pay them out to your user manually, or according to a preconfigured payout schedule.<\/p>\n

Requirements<\/h2>\n

If you have the roles and permissions for Managed Risk<\/a>, there are no additional requirements, limitations, or preparations.<\/p>\n

How it works<\/h2>\n

In the following example, Adyen applied a 10% reserve to your user's daily sales, with a 30-day rolling cycle and a 2-day settlement delay.<\/p>\n

This means that 90% of your user's daily sales become available on your user's balance account after the settlement delay (on day 3), while the remaining 10% is held in reserve for 30 days. According to the 2-day settlement delay and the 30-day rolling reserve cycle, the funds that become available on day 33 consist of 90% of the sales volume of day 31, plus the amount that was reserved on day 3.<\/p>\n

Available funds(D31)<\/sub><\/code> =<\/strong> (Sales volume(D31)<\/sub> x<\/b> 0.90)<\/code> +<\/strong> (Sales volume(D1)<\/sub> x<\/b> 0.10)<\/code><\/p>\n

\n \n
\n
\n <\/i>\n
\n

Example breakdown for a rolling reserve<\/h4>\n <\/div>\n <\/div>\n
\n \n

Here is the breakdown of the reserved, released, and available funds for the rolling reserve cycle described above:<\/p>\n

\n \n\n\n\n\n\n\n\n\n\n\n\n\n\n
Sales day<\/th>\nSales volume<\/th>\nFunds reserved<\/th>\nFunds released<\/th>\nAvailable funds<\/th>\nFunds in reserve<\/th>\n<\/tr>\n<\/thead>\n
1<\/td>\n$1,000.00<\/td>\n$100.00<\/td>\n$0.00<\/td>\n$0.00<\/td>\n$100.00<\/td>\n<\/tr>\n
2<\/td>\n$2,000.00<\/td>\n$200.00<\/td>\n$0.00<\/td>\n$0.00<\/td>\n$300.00<\/td>\n<\/tr>\n
3<\/td>\n$3,000.00<\/td>\n$300.00<\/td>\n$0.00<\/td>\n$900.00<\/td>\n$600.00<\/td>\n<\/tr>\n
4<\/td>\n$1,000.00<\/td>\n$100.00<\/td>\n$0.00<\/td>\n$1,800.00<\/td>\n$700.00<\/td>\n<\/tr>\n
...<\/td>\n...<\/td>\n...<\/td>\n...<\/td>\n...<\/td>\n...<\/td>\n<\/tr>\n
31<\/td>\n$3,000.00<\/td>\n$300.00<\/td>\n$100.00<\/td>\n$900.00<\/td>\n$5,600.00<\/td>\n<\/tr>\n
32<\/td>\n$1,000.00<\/td>\n$100.00<\/td>\n$200.00<\/td>\n$1,800.00<\/td>\n$5,500.00<\/td>\n<\/tr>\n
33<\/td>\n$2,000.00<\/td>\n$200.00<\/td>\n$300.00<\/td>\n$2,700.00<\/td>\n$5,400.00<\/td>\n<\/tr>\n
34<\/td>\n$1,000.00<\/td>\n$100.00<\/td>\n$100.00<\/td>\n$900.0<\/td>\n$5,400.00<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n<\/div>\n\n\n <\/div>\n <\/div>\n<\/div>\n\n

Receive configuration updates<\/h2>\n

All changes in your user's risk management settings automatically trigger webhooks to your server. To receive these webhooks, subscribe<\/a> to the Configuration webhooks<\/a>.<\/p>\n

Rolling reserve applied<\/h3>\n

We send a balancePlatform.managedRisk.rollingReserve.applied<\/code> webhook when we apply a rolling reserve to your user's balance account.<\/p>\n

This webhook contains the following information in the data<\/code> object:<\/p>\n

\n \n\n\n\n\n\n\n\n\n\n\n
Parameter<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
accountHolderId<\/code><\/td>\nThe unique identifier of the account holder whose daily sales we applied the rolling reserve.<\/td>\n<\/tr>\n
balancePlatform<\/code><\/td>\nThe unique identifier of the balance platform in which the change occurred.<\/td>\n<\/tr>\n
creationDate<\/code><\/td>\nThe date and time when the rolling reserve was applied, in ISO 8601<\/a> extended format.<\/td>\n<\/tr>\n
id<\/code><\/td>\nThe unique identifier of the webhook event.<\/td>\n<\/tr>\n
rollingReservePercentage<\/code><\/td>\nThe percentage of your user's daily sales volume that is withheld from the settlement batch as a rolling reserve.<\/td>\n<\/tr>\n
withHoldingPeriodInDays<\/code><\/td>\nThe number of days after which we release the withheld percentage of your user's daily sales volume.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n<\/div>\n\n

The following example shows the webhook you receive when a rolling reserve is applied to your user's daily sales volume.<\/p>\n

\n <\/code-sample>\n<\/div>\n

Rolling reserve updated<\/h3>\n

Adyen sends a balancePlatform.managedRisk.rollingReserve.updated<\/code> webhook to notify you of changes to the applied rolling reserve. Updated reserve terms only affect future payments and do not affect previous reserves.<\/p>\n

This webhook contains the following information in the data<\/code> object:<\/p>\n

\n \n\n\n\n\n\n\n\n\n\n\n
Parameter<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
accountHolderId<\/code><\/td>\nThe unique identifier of the account holder whose risk settings changed.<\/td>\n<\/tr>\n
balancePlatform<\/code><\/td>\nThe unique identifier of the balance platform in which the change occurred.<\/td>\n<\/tr>\n
creationDate<\/code><\/td>\nThe date and time when the rolling reserve amount and\/or withholding period changed, in ISO 8601<\/a> extended format.<\/td>\n<\/tr>\n
id<\/code><\/td>\nThe unique identifier of the webhook event.<\/td>\n<\/tr>\n
rollingReservePercentage<\/code><\/td>\nThe updated percentage of your user's daily sales volume that is withheld from the settlement batch as a rolling reserve.<\/td>\n<\/tr>\n
withHoldingPeriodInDays<\/code><\/td>\nThe updated number of days after which we release the withheld percentage of your user's daily sales volume.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n<\/div>\n\n

The following example shows the webhook you receive when a rolling reserve that has been applied to your user's daily sales volume, is updated.<\/p>\n

\n <\/code-sample>\n<\/div>\n

Rolling reserve lifted<\/h3>\n

Adyen sends a balancePlatform.managedRisk.rollingReserve.lifted<\/code> webhook when we remove the rolling reserve configuration from your user's balance account.<\/p>\n

This webhook contains the following information in the data<\/code> object:<\/p>\n

\n \n\n\n\n\n\n\n\n
Parameter<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
accountHolderId<\/code><\/td>\nThe unique identifier of the account holder whose risk management changes.<\/td>\n<\/tr>\n
balancePlatform<\/code><\/td>\nThe unique identifier of the balance platform in which the change occurs.<\/td>\n<\/tr>\n
id<\/code><\/td>\nThe unique identifier of the webhook event.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n<\/div>\n\n

The following example shows the webhook you receive when a rolling reserve is lifted from your user's daily sales volume.<\/p>\n

\n <\/code-sample>\n<\/div>\n

Receive fund movement updates<\/h2>\n

All fund movements in your balance platform automatically trigger webhooks to your server. We send a balancePlatform.transfer.updated<\/a> webhook when we deduct funds from your user's transaction and allocate it to the reserve, and a balancePlatform.managedRisk.balance.block.released<\/code> webhook when we release these funds.<\/p>\n

While we send individual transfer webhooks for every transaction, we only send one balancePlatform.managedRisk.balance.block.released<\/code> per settlement batch.<\/p>\n

Reserved funds<\/h3>\n

Adyen sends a balancePlatform.transfer.updated<\/a> webhook when we reserve the funds from your user's transaction amount and allocate it to the rolling reserve.<\/p>\n

This webhook contains an additional managedRisk<\/code> object with the following information:<\/p>\n

\n \n\n\n\n\n\n\n\n
Parameter<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
blockedAmount<\/code><\/td>\nThe amount deducted from the original transaction amount and allocated to the reserve.<\/td>\n<\/tr>\n
expectedReleaseDate<\/code><\/td>\nThe date when the withheld amount is scheduled to be released to the balance account, in ISO 8601<\/a> format.<\/td>\n<\/tr>\n
batchReference<\/code><\/td>\nThe unique identifier of the batch of transfers this individual transfer is part of.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n<\/div>\n\n
\n

The reserved amounts are also included in the Managed Risk Blocked Amount<\/strong> column of the Balance Platform Accounting<\/a> and Payout<\/a> reports. You can enable this column by configuring the reports<\/a> in your Customer Area<\/a>.<\/p>\n<\/div>\n

The following example shows the webhook you receive when we add USD 100 to a rolling reserve with a 30-day cycle.<\/p>\n

\n <\/code-sample>\n<\/div>\n

Released funds<\/h3>\n

Adyen sends a balancePlatform.managedRisk.balance.block.released<\/code> webhook when we release the funds from the reserve and allocate it to the current sales day's settlement batch.<\/p>\n

This webhook contains the following information:<\/p>\n

\n \n\n\n\n\n\n\n\n
Parameter<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
amount<\/code><\/td>\nThe sum of the funds released from the reserve and allocated to the settlement batch of the valueDate<\/code>.<\/td>\n<\/tr>\n
valueDate<\/code><\/td>\nThe date when the previously withheld amount is released to the balance account, in ISO 8601<\/a> format.<\/td>\n<\/tr>\n
batchReference<\/code><\/td>\nThe unique identifier of the batch of fund releases.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n<\/div>\n\n

The following example shows the webhook you receive when we release the funds reserved in the previous example<\/a>.<\/p>\n

\n <\/code-sample>\n<\/div>\n

View events and changes<\/h2>\n

View the rolling reserve configuration and fund movement details in your Customer Area<\/a>:<\/p>\n

    \n
  1. Go to Balance account<\/strong>.<\/li>\n
  2. Select the Rolling reserves<\/strong> tab.
    \nThis tab is only visible if a rolling reserve is applied to the balance account.<\/li>\n
  3. You can view the current rolling reserve configuration in the header.<\/li>\n
  4. In the table, you can see an overview of when funds are added to and released from the reserve, and the total amount that is held in reserve on your user's balance account.<\/li>\n<\/ol>\n

    \n \"\"\n<\/a><\/p>\n

    See also<\/h2>\n