{"title":"Dynamic settlement delays","category":"default","creationDate":1772799840,"content":"<p><span style=\"color: #0ABF53;\"><span style=\"font-size: 20px;\"><strong>Limited availability<\/strong><\/span><\/span><br \/>\nAdyen's Managed Risk solution is in pilot phase. Some of the processes and documentation may change as the solution evolves.<\/p>\n<hr \/>\n<p>Adyen's risk engine continuously monitors and evaluates your user's transactions, and decreases or increases the settlement delay of your user's transactions.<\/p>\n<h2>Requirements<\/h2>\n<p>If you have the roles and permissions for <a href=\"\/platforms\/managed-risk\/#requirements\">Managed Risk<\/a>, there are no additional requirements, limitations, or preparations.<\/p>\n<h2>Dynamic settlement delay<\/h2>\n<p>After we verify your user's information during onboarding and enable their payment processing capabilities, Adyen configures an initial settlement delay for their transactions. The <a href=\"\/platforms\/settle-funds\" target=\"&quot;_blank&quot;\">settlement delay<\/a> specifies the number of business days after which the funds in a daily settlement batch become available in your user's balance account. When the funds become available, you can pay them out to your user manually, or according to a preconfigured <a href=\"\/platforms\/payout-to-users\/scheduled-payouts\" target=\"&quot;_blank&quot;\">payout schedule<\/a>.<\/p>\n<p>The initial settlement delay configured for your users may be longer than our default sales day settlement delay for the given region. The exact number of days depends on your user's industry, operating country, and the payment methods used.<\/p>\n<p>We continuously monitor and evaluate your user's transaction data, and dynamically decrease or increase the settlement period of your user's transactions according to their risk level.<\/p>\n<h2>Receive updates<\/h2>\n<p>Listen to the <code>balancePlatform.managedRisk.settlementDelay.updated<\/code> webhook to be notified when we increase or decrease the settlement delay applied to your user's transactions.<\/p>\n<p>This webhook contains the following information in the <code>data<\/code> object:<\/p>\n<div class=\"sticky-table-container\">\n    \n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><code>accountHolderId<\/code><\/td>\n<td style=\"text-align: left;\">The unique identifier of the account holder whose risk management changes.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>balancePlatform<\/code><\/td>\n<td style=\"text-align: left;\">The unique identifier of the balance platform in which the change occurs.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>creationDate<\/code><\/td>\n<td style=\"text-align: left;\">The date and time when the change was triggered, in <a href=\"https:\/\/www.iso.org\/iso-8601-date-and-time-format.html\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">ISO 8601<\/a> extended format.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>configurations.paymentMethod<\/code><\/td>\n<td style=\"text-align: left;\">The payment method to which the settlement delay applies.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>configurations.settlementDelay<\/code><\/td>\n<td style=\"text-align: left;\">The settlement delay applied to your user's transactions. It indicates the number of days after which your user's funds become available in their balance account.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>id<\/code><\/td>\n<td style=\"text-align: left;\">The unique identifier of the webhook event.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>reason<\/code><\/td>\n<td style=\"text-align: left;\">The reason for the change in your user's risk management, set to <span translate=\"no\"><strong>settlementDelayConfigurationUpdated<\/strong><\/span>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n<\/div>\n\n<p>The following example shows the webhook you receive when the settlement delay is changed for your user's transactions.<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Settlement delay increased'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"data\\\": {\\n        \\\"accountHolderId\\\": \\\"AH00000000000000000000001\\\",\\n        \\\"balancePlatform\\\": \\\"YOUR_BALANCE_PLATFORM\\\",\\n        \\\"creationDate\\\": \\\"2024-10-18T10:15:30+01:00\\\",\\n        \\\"configurations\\\": [\\n            {\\n                \\\"paymentMethod\\\": \\\"default\\\",\\n                \\\"settlementDelay\\\": 4\\n            },\\n            {\\n                \\\"paymentMethod\\\": \\\"ach\\\",\\n                \\\"settlementDelay\\\": 6\\n            }\\n        ],\\n        \\\"id\\\": \\\"JN4227222422265\\\",\\n        \\\"reason\\\": \\\"settlementDelayConfigurationUpdated\\\"\\n    },\\n    \\\"environment\\\": \\\"test\\\",\\n    \\\"type\\\": \\\"balancePlatform.managedRisk.settlementDelay.updated\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<h2>View changes<\/h2>\n<p>You can track the changes and view all events related to your users' risk management in your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>:<\/p>\n<ol>\n<li>Go to <strong>Balance account<\/strong> &gt; <strong>Overview<\/strong>.<\/li>\n<li>In the <strong>Summary<\/strong> section, you can view the current settlement delay set for your user's transactions.<br \/>\nTransactions initiated through direct debit and other payment methods can have different settlement delays.<\/li>\n<li>In the <strong>Balance risk events<\/strong> section, you can view the list of the latest changes in your user's settlement delay configuration.<\/li>\n<\/ol>\n<h2>See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/platforms\/managed-risk\/rolling-reserve\"\n                        target=\"_self\"\n                        >\n                    Rolling reserves\n                <\/a><\/li><li><a href=\"\/platforms\/settle-funds\"\n                        target=\"_self\"\n                        >\n                    Settle funds\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/platforms\/managed-risk\/dynamic-settlement-delay","articleFields":{"description":"Find out how Adyen controls the availability of your user&#39;s funds.","robots":"noindex,nofollow","never_cache_twig":true,"parameters":{"directoryPath":"\/platforms","model":"platform"},"type":"page","feedback_component":true,"filters_component":false,"decision_tree":"[]","page_id":"4ca979bf-3be5-4fd5-b321-30d1f4bfb901","last_edit_on":"06-03-2026 13:24"},"algolia":{"url":"https:\/\/docs.adyen.com\/platforms\/managed-risk\/dynamic-settlement-delay","title":"Dynamic settlement delays","content":"Limited availability\nAdyen's Managed Risk solution is in pilot phase. Some of the processes and documentation may change as the solution evolves.\n\nAdyen's risk engine continuously monitors and evaluates your user's transactions, and decreases or increases the settlement delay of your user's transactions.\nRequirements\nIf you have the roles and permissions for Managed Risk, there are no additional requirements, limitations, or preparations.\nDynamic settlement delay\nAfter we verify your user's information during onboarding and enable their payment processing capabilities, Adyen configures an initial settlement delay for their transactions. The settlement delay specifies the number of business days after which the funds in a daily settlement batch become available in 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.\nThe initial settlement delay configured for your users may be longer than our default sales day settlement delay for the given region. The exact number of days depends on your user's industry, operating country, and the payment methods used.\nWe continuously monitor and evaluate your user's transaction data, and dynamically decrease or increase the settlement period of your user's transactions according to their risk level.\nReceive updates\nListen to the balancePlatform.managedRisk.settlementDelay.updated webhook to be notified when we increase or decrease the settlement delay applied to your user's transactions.\nThis webhook contains the following information in the data object:\n\n    \n\n\n\nParameter\nDescription\n\n\n\n\naccountHolderId\nThe unique identifier of the account holder whose risk management changes.\n\n\nbalancePlatform\nThe unique identifier of the balance platform in which the change occurs.\n\n\ncreationDate\nThe date and time when the change was triggered, in ISO 8601 extended format.\n\n\nconfigurations.paymentMethod\nThe payment method to which the settlement delay applies.\n\n\nconfigurations.settlementDelay\nThe settlement delay applied to your user's transactions. It indicates the number of days after which your user's funds become available in their balance account.\n\n\nid\nThe unique identifier of the webhook event.\n\n\nreason\nThe reason for the change in your user's risk management, set to settlementDelayConfigurationUpdated.\n\n\n\n\n\n\nThe following example shows the webhook you receive when the settlement delay is changed for your user's transactions.\n\n    \n\nView changes\nYou can track the changes and view all events related to your users' risk management in your Customer Area:\n\nGo to Balance account &gt; Overview.\nIn the Summary section, you can view the current settlement delay set for your user's transactions.\nTransactions initiated through direct debit and other payment methods can have different settlement delays.\nIn the Balance risk events section, you can view the list of the latest changes in your user's settlement delay configuration.\n\nSee also\n\n\n                    Rolling reserves\n                \n                    Settle funds\n                \n","type":"page","locale":"en","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Platforms","lvl2":"Adyen Managed Risk","lvl3":"Dynamic settlement delays"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/platforms","lvl2":"https:\/\/docs.adyen.com\/platforms\/managed-risk","lvl3":"\/platforms\/managed-risk\/dynamic-settlement-delay"},"levels":4,"category":"Platforms","category_color":"green","tags":["Dynamic","settlement","delays"]},"articleFiles":{"ba-settlement-delay.png":"<img alt=\"\" src=\"https:\/\/docs.adyen.com\/user\/pages\/docs\/05.platforms\/42.managed-risk\/01.dynamic-settlement-delay\/ba-settlement-delay.png\" \/>","settlement_delay_decrease.svg":"<img alt=\"\" src=\"https:\/\/docs.adyen.com\/user\/pages\/docs\/05.platforms\/42.managed-risk\/01.dynamic-settlement-delay\/settlement_delay_decrease.svg\" \/>","settlement_delay_increase.svg":"<img alt=\"\" src=\"https:\/\/docs.adyen.com\/user\/pages\/docs\/05.platforms\/42.managed-risk\/01.dynamic-settlement-delay\/settlement_delay_increase.svg\" \/>"}}
