{"title":"Renew a grant","category":"default","creationDate":1781532753,"content":"<p><span style=\"color: #0ABF53;\"><span style=\"font-size: 20px;\"><strong>Limited availability<\/strong><\/span><\/span><br \/>\nGrant renewal is currently in a pilot phase. To request access, reach out to your Adyen contact.<\/p>\n<hr \/>\n<p>Users do not have to wait until the prior grant is fully repaid to receive additional financing. When a grant is partially paid off and meets <a href=\"\/capital\/additional-financing#eligibility\">eligibility requirements for grant renewal<\/a>, you can configure a subsequent grant. Adyen disburses the full subsequent grant amount and reserves the outstanding principal of the prior grant for repayment.<\/p>\n<p>This page covers the process of renewing a grant.<\/p>\n<div class=\"notices green\">\n<p>Throughout this page, <em>prior grant<\/em> refers to the active grant that is being renewed, and <em>subsequent grant<\/em> refers to the new grant that renews it.<\/p>\n<\/div>\n<h2>Requirements<\/h2>\n<p>Before you begin, take into account the following requirements, limitations, and preparations.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Requirement<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><strong>Integration type<\/strong><\/td>\n<td style=\"text-align: left;\">You must have an Adyen for Platforms integration that supports Capital.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>API credentials<\/strong><\/td>\n<td style=\"text-align: left;\">You must have a <a href=\"\/capital\/manage-access#api-credentials\">Balance Platform API key<\/a> (for example, <span translate=\"no\"><strong>ws[_123456]@BalancePlatform.[YourBalancePlatform]<\/strong><\/span>) to access the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/capital\/latest\/overview\" class=\" external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Capital API<\/a>.<br\/><br\/>Your API credential must have the following roles: <ul><li markdown=\"1\"><strong>Balance Platform Capital Configuration role<\/strong><\/li><li markdown=\"1\"><strong>Balance Platform Capital Grant Initiation role<\/strong><\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Capabilities<\/strong><\/td>\n<td style=\"text-align: left;\">Make sure that your user has the following <a href=\"\/capital\/manage-user-capabilities\">capabilities<\/a>: <ul><li markdown=\"1\"><span translate=\"no\"><strong>getGrantOffers<\/strong><\/span><\/li><li markdown=\"1\"><span translate=\"no\"><strong>receiveGrants<\/strong><\/span><\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Webhooks<\/strong><\/td>\n<td style=\"text-align: left;\">Subscribe to the following webhooks: <ul><li markdown=\"1\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/capital-webhooks\/latest\/overview\" class=\" external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Capital webhooks<\/a><\/li><li markdown=\"1\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfer-webhooks\/latest\/overview\" class=\" external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Transfer webhooks<\/a><\/li><li markdown=\"1\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transaction-webhooks\/latest\/overview\" class=\" external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Transaction webhooks<\/a><\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Limitations<\/strong><\/td>\n<td style=\"text-align: left;\">Currently, only one disbursement per grant is allowed. We are working on enabling multiple disbursements to different balance accounts.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Setup steps<\/strong><\/td>\n<td style=\"text-align: left;\">Before you begin, make sure: <ul><li markdown=\"1\">You followed our <a href=\"\/capital\/compliance-guidelines\">compliance guidelines for Capital<\/a> when creating user interfaces, marketing materials, and other processes.<\/li><li markdown=\"1\">You reviewed the eligibility requirements and conditions for <a href=\"\/capital\/additional-financing\">grant renewal<\/a>.<\/li><\/ul><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>How it works<\/h2>\n<p>The grant renewal process includes the following steps:<\/p>\n<ol>\n<li><a href=\"#grant-eligibility\">Get a notification<\/a> of grant eligibility for grant renewal.<\/li>\n<li><a href=\"#get-offers\">Get offers<\/a> for the account holder and present those that meet the renewal minimum.<\/li>\n<li><a href=\"#present-tos\">Present the user with the new Terms of Service<\/a>.<\/li>\n<li><a href=\"#configure-renewal-grant\">Configure a subsequent grant<\/a>.<\/li>\n<li><a href=\"#get-updates\">Get updates<\/a> about the grant status.<\/li>\n<\/ol>\n<h2 id=\"grant-eligibility\">1. Get a notification of grant eligibility for grant renewal<\/h2>\n<p>Listen to the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/capital-webhooks\/latest\/post\/balancePlatform.grants.updated\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balancePlatform.grants.updated<\/a> webhook. When a grant becomes eligible for grant renewal, Adyen sends a webhook with the following key fields:<\/p>\n<ul>\n<li><code>renewal.eligible<\/code>: <strong>true<\/strong><\/li>\n<li><code>renewal.minimumAmount<\/code>: The minimum financing amount the user must accept to renew the grant.<\/li>\n<li><code>id<\/code>: The unique identifier of the grant that is eligible for renewal.<\/li>\n<\/ul>\n<p>Alternatively, you can get this information by making the GET  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/capital\/latest\/get\/grants\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/grants<\/a> request.<\/p>\n<p>The following example shows a webhook for a grant eligible for grant renewal.<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Grant eligible for renewal'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"data\\\": {\\n        \\\"balancePlatform\\\": \\\"TestBalancePlatform\\\",\\n        \\\"id\\\": \\\"GR00000000000000000000001\\\",\\n        \\\"grant\\\": {\\n            \\\"counterparty\\\": {\\n                \\\"accountHolderId\\\": \\\"AH00000000000000000000001\\\",\\n                \\\"balanceAccountId\\\": \\\"BA00000000000000000000001\\\"\\n            },\\n            \\\"grantAccountId\\\": \\\"CG00000000000000000000001\\\",\\n            \\\"grantOfferId\\\": \\\"GO00000000000001\\\",\\n            \\\"balances\\\": {\\n                \\\"currency\\\": \\\"EUR\\\",\\n                \\\"fee\\\": 94406,\\n                \\\"principal\\\": 629375,\\n                \\\"total\\\": 723781\\n            },\\n            \\\"id\\\": \\\"GR00000000000000000000001\\\",\\n            \\\"status\\\": {\\n                \\\"code\\\": \\\"Active\\\"\\n            },\\n            \\\"renewal\\\": {\\n                \\\"eligible\\\": true,\\n                \\\"minimumAmount\\\": {\\n                    \\\"currency\\\": \\\"EUR\\\",\\n                    \\\"value\\\": 9440625\\n                }\\n            }\\n        }\\n    },\\n    \\\"environment\\\": \\\"test\\\",\\n    \\\"timestamp\\\": \\\"2026-01-21T19:57:25.856Z\\\",\\n    \\\"type\\\": \\\"balancePlatform.grants.updated\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<h2 id=\"get-offers\">2. Get financing offers<\/h2>\n<div class=\"notices green\">\n<p>The renewal offer must be at least 150% of the outstanding balance of the prior grant. Available offers are recalculated weekly and expire after seven days.<\/p>\n<\/div>\n<ol>\n<li><a href=\"\/capital\/get-grant-offers\">Get financing offers<\/a> for the account holder. You can get either <a href=\"\/capital\/get-grant-offers\/dynamic-offers\">dynamic<\/a> or <a href=\"\/capital\/get-grant-offers\/static-offers\">static<\/a> offers.<\/li>\n<li>In your user interface, present the offers that meet the <code>renewal.minimumAmount<\/code> from the webhook.<\/li>\n<\/ol>\n<h2 id=\"present-tos\">3. Present the user with the new Terms of Service<\/h2>\n<div class=\"notices green\">\n<p>After the user selects a renewal offer, the <code>receiveGrants<\/code> capability is disallowed until the Terms of Service are accepted again.<\/p>\n<\/div>\n<p>For grant renewal, underwriting follows specific credit assessment rules to determine the new repayment percentage, fee, and maximum amount. The new terms can differ from the prior grant. The user must re-accept the Terms of Service before the subsequent grant can be disbursed.<\/p>\n<ol>\n<li><a href=\"\/capital\/terms-of-service\">Generate a Terms of Service document<\/a>.<\/li>\n<li>In your user interface, present the Terms of Service for acceptance.<\/li>\n<\/ol>\n<h2 id=\"configure-renewal-grant\">4. Configure a subsequent grant<\/h2>\n<p>To configure a subsequent grant:<\/p>\n<ol>\n<li>\n<p>Make a POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/capital\/latest\/post\/grants\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/grants<\/a> request, specifying the following parameters:<\/p>\n<table>\n<thead>\n<tr>\n<th>Parameter<\/th>\n<th>Type<\/th>\n<th style=\"text-align: center;\">Required<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/capital\/latest\/post\/grants#request-counterparty-balanceAccountId\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">counterparty.balanceAccountId<\/a><\/td>\n<td>String<\/td>\n<td style=\"text-align: center;\"><\/td>\n<td>The unique identifier of the balance account that belongs to the receiving account holder. Pass this parameter if you choose to pay out to the balance account of the user.<br\/><br\/>If <code>balanceAccountId<\/code> is not provided in the request, the grant is paid out to the account holder's  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/balanceplatform\/latest\/get\/accountHolders\/(id)#responses-200-primaryBalanceAccount\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">primaryBalanceAccount<\/a>.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/capital\/latest\/post\/grants#request-counterparty-transferInstrumentId\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">counterparty.transferInstrumentId<\/a><\/td>\n<td>String<\/td>\n<td style=\"text-align: center;\"><\/td>\n<td>The unique identifier of the transfer instrument that belongs to the legal entity of the account holder. Pass this parameter if you choose to pay out to the transfer instrument of the user.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/capital\/latest\/post\/grants#request-grantAccountId\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">grantAccountId<\/a><\/td>\n<td>String<\/td>\n<td style=\"text-align: center;\"><span class=\"hint--bottom\" data-hint=\"Required\" markdown=\"1\"><img style=\"width: 25px;\" alt=\"Required\" src=\"\/user\/pages\/reuse\/image-library\/01.icons\/required\/required.svg?decoding=auto&amp;fetchpriority=auto\" \/><\/span><\/td>\n<td>The unique identifier of the grant account. Reach out to your Adyen contact to get this value.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/capital\/latest\/post\/grants#request-grantOfferId\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">grantOfferId<\/a><\/td>\n<td>String<\/td>\n<td style=\"text-align: center;\"><span class=\"hint--bottom\" data-hint=\"Required\" markdown=\"1\"><img style=\"width: 25px;\" alt=\"Required\" src=\"\/user\/pages\/reuse\/image-library\/01.icons\/required\/required.svg?decoding=auto&amp;fetchpriority=auto\" \/><\/span><\/td>\n<td>The unique identifier of the grant offer that has been selected by the user.<\/td>\n<\/tr>\n<tr>\n<td><code>renewsGrantId<\/code><\/td>\n<td>String<\/td>\n<td style=\"text-align: center;\"><span class=\"hint--bottom\" data-hint=\"Required\" markdown=\"1\"><img style=\"width: 25px;\" alt=\"Required\" src=\"\/user\/pages\/reuse\/image-library\/01.icons\/required\/required.svg?decoding=auto&amp;fetchpriority=auto\" \/><\/span><\/td>\n<td>The unique identifier of the prior grant to renew.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p><img alt=\"This is the required icon.\" src=\"\/user\/pages\/reuse\/image-library\/01.icons\/capital-legend\/required.svg?decoding=auto&amp;fetchpriority=auto\" \/> Required <br><img alt=\"This is the conditionally required icon.\" src=\"\/user\/pages\/reuse\/image-library\/01.icons\/capital-legend\/conditionally-required.svg?decoding=auto&amp;fetchpriority=auto\" \/> Conditionally required<\/p>\n<p>The following example shows how to configure a grant to renew a prior grant.<\/p>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Disburse a subsequent grant'\" :id=\"'configure-renewal-grant'\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/balanceplatform-api-test.adyen.com\\\/capital\\\/v1\\\/grants \\\\\\n-H 'x-api-key: ADYEN_BALANCE_PLATFORM_API_KEY' \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-X POST \\\\\\n-d '{\\n   \\&quot;counterparty\\&quot;: {\\n      \\&quot;balanceAccountId\\&quot;: \\&quot;BA00000000000000000000001\\&quot;\\n   },\\n   \\&quot;grantAccountId\\&quot;: \\&quot;CG00000000000000000000001\\&quot;,\\n   \\&quot;grantOfferId\\&quot;: \\&quot;0000000000000002\\&quot;,\\n   \\&quot;renewsGrantId\\&quot;: \\&quot;GR00000000000000000000001\\&quot;\\n}'&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<li>\n<p>In the response, note the following parameters:<\/p>\n<table>\n<thead>\n<tr>\n<th>Parameter<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/capital\/latest\/post\/grants#responses-200-id\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">id<\/a><\/td>\n<td>The unique identifier of the grant.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/capital\/latest\/post\/grants#responses-200-grantAccountId\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">grantAccountId<\/a><\/td>\n<td>The identifier of the grant account used to account for the grant.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/capital\/latest\/post\/grants#responses-200-grantOfferId\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">grantOfferId<\/a><\/td>\n<td>The unique identifier for the related grant offer, which determines the grant conditions.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/capital\/latest\/post\/grants#responses-200-counterparty\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">counterparty<\/a><\/td>\n<td>An object that contains the details of the receiving account holder.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/capital\/latest\/post\/grants#responses-200-status\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">status<\/a><\/td>\n<td>The status of the grant.<\/td>\n<\/tr>\n<tr>\n<td><code>renewsGrantId<\/code><\/td>\n<td>The unique identifier of the prior grant that the current grant renews.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Subsequent grant requested'\" :id=\"'request-grant-response'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"grantAccountId\\\": \\\"CG00000000000000000000001\\\",\\n    \\\"counterparty\\\": {\\n        \\\"accountHolderId\\\": \\\"AH00000000000000000000001\\\",\\n        \\\"balanceAccountId\\\": \\\"BA00000000000000000000001\\\"\\n    },\\n    \\\"grantOfferId\\\": \\\"0000000000000002\\\",\\n    \\\"id\\\": \\\"GR00000000000000000000002\\\",\\n    \\\"status\\\": {\\n        \\\"code\\\": \\\"Requested\\\"\\n    },\\n    \\\"balances\\\": {\\n        \\\"principal\\\": 0,\\n        \\\"fee\\\": 0,\\n        \\\"total\\\": 0,\\n        \\\"currency\\\": \\\"EUR\\\"\\n    },\\n    \\\"renewsGrantId\\\": \\\"GR00000000000000000000001\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<\/ol>\n<p>Adyen processes POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/capital\/latest\/post\/grants\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/grants<\/a> requests asynchronously. You receive a response to your API request, but you must wait for the <a href=\"\/capital\/make-grant-request?tab=grant_configured_0_1\">webhook<\/a> to know the final result.<\/p>\n<h2 id=\"get-updates\">5. Get updates<\/h2>\n<p>Adyen sends the webhook messages for the following event types to your server to update you about the grant and fund transfer status.<\/p>\n<table>\n<thead>\n<tr>\n<th>Event type<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/capital-webhooks\/latest\/post\/balancePlatform.grants.created\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balancePlatform.grants.created<\/a><\/td>\n<td>The grant has been configured.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/capital-webhooks\/latest\/post\/balancePlatform.grants.updated\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balancePlatform.grants.updated<\/a><\/td>\n<td>The grant has been fully repaid, reconfigured, or written off in case the user did not pay back all outstanding funds.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfer-webhooks\/latest\/post\/balancePlatform.transfer.created\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balancePlatform.transfer.created<\/a><\/td>\n<td>The outgoing or incoming grant transfer request has been received.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfer-webhooks\/latest\/post\/balancePlatform.transfer.updated\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balancePlatform.transfer.updated<\/a><\/td>\n<td>The outgoing or incoming grant transfer request has been authorized and\/or booked.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transaction-webhooks\/latest\/post\/balancePlatform.transaction.created\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balancePlatform.transaction.created<\/a><\/td>\n<td>The funds have been paid out to the balance account or the payment instrument.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>To keep track of webhooks, make sure that your server can <a href=\"\/development-resources\/webhooks\">receive and accept webhooks<\/a>.<\/p>\n\n<div id=\"tabyQRJl\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Grant configured&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;After Adyen configures the subsequent grant, you receive a webhook message with the event type &lt;code&gt;balancePlatform.grants.created&lt;\\\/code&gt;.&lt;\\\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Grant configured webhook&#039;\\&quot; :id=\\&quot;&#039;&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n    \\\\\\&quot;data\\\\\\&quot;: {\\\\n        \\\\\\&quot;balancePlatform\\\\\\&quot;: \\\\\\&quot;TestBalancePlatform\\\\\\&quot;,\\\\n        \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;GR00000000000000000000001\\\\\\&quot;,\\\\n        \\\\\\&quot;grant\\\\\\&quot;: {\\\\n            \\\\\\&quot;counterparty\\\\\\&quot;: {\\\\n                \\\\\\&quot;accountHolderId\\\\\\&quot;: \\\\\\&quot;AH00000000000000000000001\\\\\\&quot;\\\\n            },\\\\n            \\\\\\&quot;grantAccountId\\\\\\&quot;: \\\\\\&quot;CG00000000000000000000001\\\\\\&quot;,\\\\n            \\\\\\&quot;grantOfferId\\\\\\&quot;: \\\\\\&quot;GO00000000000002\\\\\\&quot;,\\\\n            \\\\\\&quot;balances\\\\\\&quot;: {\\\\n                \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;EUR\\\\\\&quot;,\\\\n                \\\\\\&quot;fee\\\\\\&quot;: 0,\\\\n                \\\\\\&quot;principal\\\\\\&quot;: 0,\\\\n                \\\\\\&quot;total\\\\\\&quot;: 0\\\\n            },\\\\n            \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;GR00000000000000000000002\\\\\\&quot;,\\\\n            \\\\\\&quot;status\\\\\\&quot;: {\\\\n                \\\\\\&quot;code\\\\\\&quot;: \\\\\\&quot;Requested\\\\\\&quot;\\\\n            },\\\\n            \\\\\\&quot;renewsGrantId\\\\\\&quot;: \\\\\\&quot;GR00000000000000000000001\\\\\\&quot;\\\\n        }\\\\n    },\\\\n    \\\\\\&quot;environment\\\\\\&quot;: \\\\\\&quot;test\\\\\\&quot;,\\\\n    \\\\\\&quot;timestamp\\\\\\&quot;: \\\\\\&quot;2026-01-21T19:56:42.107Z\\\\\\&quot;,\\\\n    \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;balancePlatform.grants.created\\\\\\&quot;\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Transfer received&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;After Adyen configures the subsequent grant, you receive a webhook message with the event type  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/transfer-webhooks\\\/latest\\\/post\\\/balancePlatform.transfer.created\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;balancePlatform.transfer.created&lt;\\\/a&gt; and the &lt;code&gt;status&lt;\\\/code&gt; &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;received&lt;\\\/strong&gt;&lt;\\\/span&gt;.&lt;\\\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Incoming transfer received&#039;\\&quot; :id=\\&quot;&#039;&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n    \\\\\\&quot;data\\\\\\&quot;: {\\\\n        \\\\\\&quot;balancePlatform\\\\\\&quot;: \\\\\\&quot;TestBalancePlatform\\\\\\&quot;,\\\\n        \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;1OUUU768NUBED14V\\\\\\&quot;,\\\\n        \\\\\\&quot;creationDate\\\\\\&quot;: \\\\\\&quot;2025-10-15T18:53:08+02:00\\\\\\&quot;,\\\\n        \\\\\\&quot;createdAt\\\\\\&quot;: \\\\\\&quot;2025-10-15T18:52:54+02:00\\\\\\&quot;,\\\\n        \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;received\\\\\\&quot;,\\\\n        \\\\\\&quot;reason\\\\\\&quot;: \\\\\\&quot;approved\\\\\\&quot;,\\\\n        \\\\\\&quot;direction\\\\\\&quot;: \\\\\\&quot;incoming\\\\\\&quot;,\\\\n        \\\\\\&quot;balanceAccount\\\\\\&quot;: {\\\\n            \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;BA00000000000000000000001\\\\\\&quot;,\\\\n            \\\\\\&quot;description\\\\\\&quot;: \\\\\\&quot;\\\\\\&quot;,\\\\n            \\\\\\&quot;reference\\\\\\&quot;: \\\\\\&quot;BA-ref-01\\\\\\&quot;\\\\n        },\\\\n        \\\\\\&quot;accountHolder\\\\\\&quot;: {\\\\n            \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;AH00000000000000000000001\\\\\\&quot;,\\\\n            \\\\\\&quot;reference\\\\\\&quot;: \\\\\\&quot;AH-ref-01\\\\\\&quot;\\\\n        },\\\\n        \\\\\\&quot;category\\\\\\&quot;: \\\\\\&quot;grants\\\\\\&quot;,\\\\n        \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;grant\\\\\\&quot;,\\\\n        \\\\\\&quot;amount\\\\\\&quot;: {\\\\n            \\\\\\&quot;value\\\\\\&quot;: 1850000,\\\\n            \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;EUR\\\\\\&quot;\\\\n        },\\\\n        \\\\\\&quot;reference\\\\\\&quot;: \\\\\\&quot;GR00000000000000000000001\\\\\\&quot;,\\\\n        \\\\\\&quot;referenceForBeneficiary\\\\\\&quot;: \\\\\\&quot;GR00000000000000000000002\\\\\\&quot;,\\\\n        \\\\\\&quot;description\\\\\\&quot;: \\\\\\&quot;GR00000000000000000000002\\\\\\&quot;,\\\\n        \\\\\\&quot;updatedAt\\\\\\&quot;: \\\\\\&quot;2025-10-15T18:53:08+02:00\\\\\\&quot;,\\\\n        \\\\\\&quot;sequenceNumber\\\\\\&quot;: 1,\\\\n        \\\\\\&quot;balances\\\\\\&quot;: [\\\\n            {\\\\n                \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;EUR\\\\\\&quot;,\\\\n                \\\\\\&quot;received\\\\\\&quot;: 1850000\\\\n            }\\\\n        ],\\\\n        \\\\\\&quot;events\\\\\\&quot;: [\\\\n            {\\\\n                \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;EV0000000000000000000000000001\\\\\\&quot;,\\\\n                \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;received\\\\\\&quot;,\\\\n                \\\\\\&quot;bookingDate\\\\\\&quot;: \\\\\\&quot;2025-10-15T18:53:08+02:00\\\\\\&quot;,\\\\n                \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;accounting\\\\\\&quot;,\\\\n                \\\\\\&quot;mutations\\\\\\&quot;: [\\\\n                    {\\\\n                        \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;EUR\\\\\\&quot;,\\\\n                        \\\\\\&quot;received\\\\\\&quot;: 1850000\\\\n                    }\\\\n                ]\\\\n            }\\\\n        ],\\\\n        \\\\\\&quot;eventId\\\\\\&quot;: \\\\\\&quot;EV0000000000000000000000000001\\\\\\&quot;\\\\n    },\\\\n    \\\\\\&quot;environment\\\\\\&quot;: \\\\\\&quot;test\\\\\\&quot;,\\\\n    \\\\\\&quot;timestamp\\\\\\&quot;: \\\\\\&quot;2025-10-15T16:53:11.336Z\\\\\\&quot;,\\\\n    \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;balancePlatform.transfer.created\\\\\\&quot;\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Transfer authorised&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;After Adyen receives the grant payout request, you receive a webhook message with the event type  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/transfer-webhooks\\\/latest\\\/post\\\/balancePlatform.transfer.updated\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;balancePlatform.transfer.updated&lt;\\\/a&gt; and the &lt;code&gt;status&lt;\\\/code&gt; &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;authorized&lt;\\\/strong&gt;&lt;\\\/span&gt;.&lt;\\\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Incoming transfer authorized&#039;\\&quot; :id=\\&quot;&#039;&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n    \\\\\\&quot;data\\\\\\&quot;: {\\\\n        \\\\\\&quot;balancePlatform\\\\\\&quot;: \\\\\\&quot;TestBalancePlatform\\\\\\&quot;,\\\\n        \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;1OUUU768NUBED14V\\\\\\&quot;,\\\\n        \\\\\\&quot;creationDate\\\\\\&quot;: \\\\\\&quot;2025-10-15T18:53:08+02:00\\\\\\&quot;,\\\\n        \\\\\\&quot;createdAt\\\\\\&quot;: \\\\\\&quot;2025-10-15T18:52:54+02:00\\\\\\&quot;,\\\\n        \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;authorised\\\\\\&quot;,\\\\n        \\\\\\&quot;reason\\\\\\&quot;: \\\\\\&quot;approved\\\\\\&quot;,\\\\n        \\\\\\&quot;direction\\\\\\&quot;: \\\\\\&quot;incoming\\\\\\&quot;,\\\\n        \\\\\\&quot;balanceAccount\\\\\\&quot;: {\\\\n            \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;BA00000000000000000000001\\\\\\&quot;,\\\\n            \\\\\\&quot;description\\\\\\&quot;: \\\\\\&quot;\\\\\\&quot;,\\\\n            \\\\\\&quot;reference\\\\\\&quot;: \\\\\\&quot;BA-ref-01\\\\\\&quot;\\\\n        },\\\\n        \\\\\\&quot;accountHolder\\\\\\&quot;: {\\\\n            \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;AH00000000000000000000001\\\\\\&quot;,\\\\n            \\\\\\&quot;reference\\\\\\&quot;: \\\\\\&quot;AH-ref-01\\\\\\&quot;\\\\n        },\\\\n        \\\\\\&quot;category\\\\\\&quot;: \\\\\\&quot;grants\\\\\\&quot;,\\\\n        \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;grant\\\\\\&quot;,\\\\n        \\\\\\&quot;amount\\\\\\&quot;: {\\\\n            \\\\\\&quot;value\\\\\\&quot;: 1850000,\\\\n            \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;EUR\\\\\\&quot;\\\\n        },\\\\n        \\\\\\&quot;reference\\\\\\&quot;: \\\\\\&quot;GR00000000000000000000002\\\\\\&quot;,\\\\n        \\\\\\&quot;referenceForBeneficiary\\\\\\&quot;: \\\\\\&quot;GR00000000000000000000002\\\\\\&quot;,\\\\n        \\\\\\&quot;description\\\\\\&quot;: \\\\\\&quot;GR00000000000000000000001\\\\\\&quot;,\\\\n        \\\\\\&quot;updatedAt\\\\\\&quot;: \\\\\\&quot;2025-10-15T18:53:08+02:00\\\\\\&quot;,\\\\n        \\\\\\&quot;sequenceNumber\\\\\\&quot;: 2,\\\\n        \\\\\\&quot;balances\\\\\\&quot;: [\\\\n            {\\\\n                \\\\\\&quot;reserved\\\\\\&quot;: 1850000,\\\\n                \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;EUR\\\\\\&quot;,\\\\n                \\\\\\&quot;received\\\\\\&quot;: 0\\\\n            }\\\\n        ],\\\\n        \\\\\\&quot;events\\\\\\&quot;: [\\\\n            {\\\\n                \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;EV0000000000000000000000000001\\\\\\&quot;,\\\\n                \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;received\\\\\\&quot;,\\\\n                \\\\\\&quot;bookingDate\\\\\\&quot;: \\\\\\&quot;2025-10-15T18:53:08+02:00\\\\\\&quot;,\\\\n                \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;accounting\\\\\\&quot;,\\\\n                \\\\\\&quot;mutations\\\\\\&quot;: [\\\\n                    {\\\\n                        \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;EUR\\\\\\&quot;,\\\\n                        \\\\\\&quot;received\\\\\\&quot;: 1850000\\\\n                    }\\\\n                ]\\\\n            },\\\\n            {\\\\n                \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;EV0000000000000000000000000002\\\\\\&quot;,\\\\n                \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;authorised\\\\\\&quot;,\\\\n                \\\\\\&quot;bookingDate\\\\\\&quot;: \\\\\\&quot;2025-10-15T18:53:08+02:00\\\\\\&quot;,\\\\n                \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;accounting\\\\\\&quot;,\\\\n                \\\\\\&quot;mutations\\\\\\&quot;: [\\\\n                    {\\\\n                        \\\\\\&quot;reserved\\\\\\&quot;: 1850000,\\\\n                        \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;EUR\\\\\\&quot;,\\\\n                        \\\\\\&quot;received\\\\\\&quot;: -1850000\\\\n                    }\\\\n                ]\\\\n            }\\\\n        ],\\\\n        \\\\\\&quot;eventId\\\\\\&quot;: \\\\\\&quot;EV0000000000000000000000000002\\\\\\&quot;\\\\n    },\\\\n    \\\\\\&quot;environment\\\\\\&quot;: \\\\\\&quot;test\\\\\\&quot;,\\\\n    \\\\\\&quot;timestamp\\\\\\&quot;: \\\\\\&quot;2025-10-15T16:53:11.336Z\\\\\\&quot;,\\\\n    \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;balancePlatform.transfer.updated\\\\\\&quot;\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Transfer booked&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;After Adyen authorizes the grant payout request, you receive another webhook message with the event type  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/transfer-webhooks\\\/latest\\\/post\\\/balancePlatform.transfer.updated\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;balancePlatform.transfer.updated&lt;\\\/a&gt; and the &lt;code&gt;status&lt;\\\/code&gt; &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;booked&lt;\\\/strong&gt;&lt;\\\/span&gt;.&lt;\\\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Incoming transfer booked&#039;\\&quot; :id=\\&quot;&#039;&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n    \\\\\\&quot;data\\\\\\&quot;: {\\\\n        \\\\\\&quot;balancePlatform\\\\\\&quot;: \\\\\\&quot;TestBalancePlatform\\\\\\&quot;,\\\\n        \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;1OUUU768NUBED14V\\\\\\&quot;,\\\\n        \\\\\\&quot;creationDate\\\\\\&quot;: \\\\\\&quot;2025-10-15T18:53:08+02:00\\\\\\&quot;,\\\\n        \\\\\\&quot;createdAt\\\\\\&quot;: \\\\\\&quot;2025-10-15T18:52:54+02:00\\\\\\&quot;,\\\\n        \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;booked\\\\\\&quot;,\\\\n        \\\\\\&quot;reason\\\\\\&quot;: \\\\\\&quot;approved\\\\\\&quot;,\\\\n        \\\\\\&quot;direction\\\\\\&quot;: \\\\\\&quot;incoming\\\\\\&quot;,\\\\n        \\\\\\&quot;balanceAccount\\\\\\&quot;: {\\\\n            \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;BA00000000000000000000001\\\\\\&quot;,\\\\n            \\\\\\&quot;description\\\\\\&quot;: \\\\\\&quot;\\\\\\&quot;,\\\\n            \\\\\\&quot;reference\\\\\\&quot;: \\\\\\&quot;BA-ref-01\\\\\\&quot;\\\\n        },\\\\n        \\\\\\&quot;accountHolder\\\\\\&quot;: {\\\\n            \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;AH00000000000000000000001\\\\\\&quot;,\\\\n            \\\\\\&quot;reference\\\\\\&quot;: \\\\\\&quot;AH-ref-01\\\\\\&quot;\\\\n        },\\\\n        \\\\\\&quot;category\\\\\\&quot;: \\\\\\&quot;grants\\\\\\&quot;,\\\\n        \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;grant\\\\\\&quot;,\\\\n        \\\\\\&quot;amount\\\\\\&quot;: {\\\\n            \\\\\\&quot;value\\\\\\&quot;: 1850000,\\\\n            \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;EUR\\\\\\&quot;\\\\n        },\\\\n        \\\\\\&quot;reference\\\\\\&quot;: \\\\\\&quot;GR00000000000000000000002\\\\\\&quot;,\\\\n        \\\\\\&quot;referenceForBeneficiary\\\\\\&quot;: \\\\\\&quot;GR00000000000000000000002\\\\\\&quot;,\\\\n        \\\\\\&quot;description\\\\\\&quot;: \\\\\\&quot;GR00000000000000000000001\\\\\\&quot;,\\\\n        \\\\\\&quot;updatedAt\\\\\\&quot;: \\\\\\&quot;2025-10-15T18:53:08+02:00\\\\\\&quot;,\\\\n        \\\\\\&quot;sequenceNumber\\\\\\&quot;: 3,\\\\n        \\\\\\&quot;balances\\\\\\&quot;: [\\\\n            {\\\\n                \\\\\\&quot;reserved\\\\\\&quot;: 0,\\\\n                \\\\\\&quot;balance\\\\\\&quot;: 1850000,\\\\n                \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;EUR\\\\\\&quot;,\\\\n                \\\\\\&quot;received\\\\\\&quot;: 0\\\\n            }\\\\n        ],\\\\n        \\\\\\&quot;events\\\\\\&quot;: [\\\\n            {\\\\n                \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;EV0000000000000000000000000001\\\\\\&quot;,\\\\n                \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;received\\\\\\&quot;,\\\\n                \\\\\\&quot;bookingDate\\\\\\&quot;: \\\\\\&quot;2025-10-15T18:53:08+02:00\\\\\\&quot;,\\\\n                \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;accounting\\\\\\&quot;,\\\\n                \\\\\\&quot;mutations\\\\\\&quot;: [\\\\n                    {\\\\n                        \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;EUR\\\\\\&quot;,\\\\n                        \\\\\\&quot;received\\\\\\&quot;: 1850000\\\\n                    }\\\\n                ]\\\\n            },\\\\n            {\\\\n                \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;EV0000000000000000000000000002\\\\\\&quot;,\\\\n                \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;authorised\\\\\\&quot;,\\\\n                \\\\\\&quot;bookingDate\\\\\\&quot;: \\\\\\&quot;2025-10-15T18:53:08+02:00\\\\\\&quot;,\\\\n                \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;accounting\\\\\\&quot;,\\\\n                \\\\\\&quot;mutations\\\\\\&quot;: [\\\\n                    {\\\\n                        \\\\\\&quot;reserved\\\\\\&quot;: 1850000,\\\\n                        \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;EUR\\\\\\&quot;,\\\\n                        \\\\\\&quot;received\\\\\\&quot;: -1850000\\\\n                    }\\\\n                ]\\\\n            },\\\\n            {\\\\n                \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;EV0000000000000000000000000003\\\\\\&quot;,\\\\n                \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;booked\\\\\\&quot;,\\\\n                \\\\\\&quot;transactionId\\\\\\&quot;: \\\\\\&quot;EV000000000000000000000000000EUR\\\\\\&quot;,\\\\n                \\\\\\&quot;bookingDate\\\\\\&quot;: \\\\\\&quot;2025-10-15T18:53:08+02:00\\\\\\&quot;,\\\\n                \\\\\\&quot;valueDate\\\\\\&quot;: \\\\\\&quot;2025-10-15T18:53:08+02:00\\\\\\&quot;,\\\\n                \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;accounting\\\\\\&quot;,\\\\n                \\\\\\&quot;mutations\\\\\\&quot;: [\\\\n                    {\\\\n                        \\\\\\&quot;reserved\\\\\\&quot;: -1850000,\\\\n                        \\\\\\&quot;balance\\\\\\&quot;: 1850000,\\\\n                        \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;EUR\\\\\\&quot;,\\\\n                        \\\\\\&quot;received\\\\\\&quot;: 0\\\\n                    }\\\\n                ]\\\\n            }\\\\n        ],\\\\n        \\\\\\&quot;eventId\\\\\\&quot;: \\\\\\&quot;EV0000000000000000000000000003\\\\\\&quot;\\\\n    },\\\\n    \\\\\\&quot;environment\\\\\\&quot;: \\\\\\&quot;test\\\\\\&quot;,\\\\n    \\\\\\&quot;timestamp\\\\\\&quot;: \\\\\\&quot;2025-10-15T16:53:11.36Z\\\\\\&quot;,\\\\n    \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;balancePlatform.transfer.updated\\\\\\&quot;\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Grant paid out&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;After Adyen pays out the funds to the receiving balance account or payment instrument, you receive a webhook message with the event type &lt;code&gt;balancePlatform.transaction.created&lt;\\\/code&gt;.&lt;\\\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Grant paid out webhook&#039;\\&quot; :id=\\&quot;&#039;&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n    \\\\\\&quot;data\\\\\\&quot;: {\\\\n        \\\\\\&quot;balancePlatform\\\\\\&quot;: \\\\\\&quot;TestBalancePlatform\\\\\\&quot;,\\\\n        \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;3JFBE65XIXOPZ30N\\\\\\&quot;,\\\\n        \\\\\\&quot;accountHolderId\\\\\\&quot;: \\\\\\&quot;AH00000000000000000000001\\\\\\&quot;,\\\\n        \\\\\\&quot;amount\\\\\\&quot;: {\\\\n            \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;EUR\\\\\\&quot;,\\\\n            \\\\\\&quot;value\\\\\\&quot;: -1850000\\\\n        },\\\\n        \\\\\\&quot;balanceAccountId\\\\\\&quot;: \\\\\\&quot;BA00000000000000000000001\\\\\\&quot;,\\\\n        \\\\\\&quot;bookingDate\\\\\\&quot;: \\\\\\&quot;2023-01-09T16:36:35+01:00\\\\\\&quot;,\\\\n        \\\\\\&quot;counterparty\\\\\\&quot;: {\\\\n            \\\\\\&quot;balanceAccountId\\\\\\&quot;: \\\\\\&quot;BA00000000000000000000002\\\\\\&quot;\\\\n        },\\\\n        \\\\\\&quot;createdAt\\\\\\&quot;: \\\\\\&quot;2023-01-09T16:36:34+01:00\\\\\\&quot;,\\\\n        \\\\\\&quot;description\\\\\\&quot;: \\\\\\&quot;GR00000000000000000000002\\\\\\&quot;,\\\\n        \\\\\\&quot;instructedAmount\\\\\\&quot;: {\\\\n            \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;EUR\\\\\\&quot;,\\\\n            \\\\\\&quot;value\\\\\\&quot;: -1850000\\\\n        },\\\\n        \\\\\\&quot;reference\\\\\\&quot;: \\\\\\&quot;GR00000000000000000000001\\\\\\&quot;,\\\\n        \\\\\\&quot;referenceForBeneficiary\\\\\\&quot;: \\\\\\&quot;GR00000000000000000000002\\\\\\&quot;,\\\\n        \\\\\\&quot;transferId\\\\\\&quot;: \\\\\\&quot;1OUUU768NUBED14V\\\\\\&quot;,\\\\n        \\\\\\&quot;valueDate\\\\\\&quot;: \\\\\\&quot;2025-10-15T18:54:08+02:00\\\\\\&quot;\\\\n    },\\\\n    \\\\\\&quot;environment\\\\\\&quot;: \\\\\\&quot;test\\\\\\&quot;,\\\\n    \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;balancePlatform.transaction.created\\\\\\&quot;\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Grant repaid&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;After the account holder fully repays the subsequent grant, you receive a webhook message with the event type &lt;code&gt;balancePlatform.grants.updated&lt;\\\/code&gt;.&lt;\\\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Grant repaid webhook&#039;\\&quot; :id=\\&quot;&#039;&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n    \\\\\\&quot;data\\\\\\&quot;: {\\\\n        \\\\\\&quot;balancePlatform\\\\\\&quot;: \\\\\\&quot;TestBalancePlatform\\\\\\&quot;,\\\\n        \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;GR00000000000000000000001\\\\\\&quot;,\\\\n        \\\\\\&quot;grant\\\\\\&quot;: {\\\\n            \\\\\\&quot;counterparty\\\\\\&quot;: {\\\\n                \\\\\\&quot;accountHolderId\\\\\\&quot;: \\\\\\&quot;AH00000000000000000000001\\\\\\&quot;,\\\\n                \\\\\\&quot;balanceAccountId\\\\\\&quot;: \\\\\\&quot;BA00000000000000000000001\\\\\\&quot;\\\\n            },\\\\n            \\\\\\&quot;grantAccountId\\\\\\&quot;: \\\\\\&quot;CG00000000000000000000001\\\\\\&quot;,\\\\n            \\\\\\&quot;grantOfferId\\\\\\&quot;: \\\\\\&quot;GO00000000000002\\\\\\&quot;,\\\\n            \\\\\\&quot;balances\\\\\\&quot;: {\\\\n                \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;EUR\\\\\\&quot;,\\\\n                \\\\\\&quot;fee\\\\\\&quot;: 0,\\\\n                \\\\\\&quot;principal\\\\\\&quot;: 0,\\\\n                \\\\\\&quot;total\\\\\\&quot;: 0\\\\n            },\\\\n            \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;GR00000000000000000000002\\\\\\&quot;,\\\\n            \\\\\\&quot;status\\\\\\&quot;: {\\\\n                \\\\\\&quot;code\\\\\\&quot;: \\\\\\&quot;Repaid\\\\\\&quot;\\\\n            }\\\\n        }\\\\n    },\\\\n    \\\\\\&quot;environment\\\\\\&quot;: \\\\\\&quot;test\\\\\\&quot;,\\\\n    \\\\\\&quot;timestamp\\\\\\&quot;: \\\\\\&quot;2026-01-21T19:59:10.153Z\\\\\\&quot;,\\\\n    \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;balancePlatform.grants.updated\\\\\\&quot;\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='false'>\n        <\/tabs>\n    <\/div>\n<\/div>\n","url":"https:\/\/docs.adyen.com\/capital\/renew-grant","articleFields":{"description":"Learn how to configure a subsequent grant that renews a partially repaid grant for your user.","feedback_component":true,"type":"page","status":"current","next_steps":[{"title":"Get grant details","description":"Learn how to get information about all grants in your balance platform.","url":"\/capital\/get-grant-balances","required":false},{"title":"Manage disbursements","description":"Learn how to get and update configurations of a disbursement.","url":"\/capital\/manage-disbursements","required":false}],"parameters":{"directoryPath":"\/capital","financialProduct":"capital"}},"algolia":{"url":"https:\/\/docs.adyen.com\/capital\/renew-grant","title":"Renew a grant","content":"Limited availability\nGrant renewal is currently in a pilot phase. To request access, reach out to your Adyen contact.\n\nUsers do not have to wait until the prior grant is fully repaid to receive additional financing. When a grant is partially paid off and meets eligibility requirements for grant renewal, you can configure a subsequent grant. Adyen disburses the full subsequent grant amount and reserves the outstanding principal of the prior grant for repayment.\nThis page covers the process of renewing a grant.\n\nThroughout this page, prior grant refers to the active grant that is being renewed, and subsequent grant refers to the new grant that renews it.\n\nRequirements\nBefore you begin, take into account the following requirements, limitations, and preparations.\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nYou must have an Adyen for Platforms integration that supports Capital.\n\n\nAPI credentials\nYou must have a Balance Platform API key (for example, ws[_123456]@BalancePlatform.[YourBalancePlatform]) to access the  Capital API.Your API credential must have the following roles: Balance Platform Capital Configuration roleBalance Platform Capital Grant Initiation role\n\n\nCapabilities\nMake sure that your user has the following capabilities: getGrantOffersreceiveGrants\n\n\nWebhooks\nSubscribe to the following webhooks:  Capital webhooks Transfer webhooks Transaction webhooks\n\n\nLimitations\nCurrently, only one disbursement per grant is allowed. We are working on enabling multiple disbursements to different balance accounts.\n\n\nSetup steps\nBefore you begin, make sure: You followed our compliance guidelines for Capital when creating user interfaces, marketing materials, and other processes.You reviewed the eligibility requirements and conditions for grant renewal.\n\n\n\nHow it works\nThe grant renewal process includes the following steps:\n\nGet a notification of grant eligibility for grant renewal.\nGet offers for the account holder and present those that meet the renewal minimum.\nPresent the user with the new Terms of Service.\nConfigure a subsequent grant.\nGet updates about the grant status.\n\n1. Get a notification of grant eligibility for grant renewal\nListen to the  balancePlatform.grants.updated webhook. When a grant becomes eligible for grant renewal, Adyen sends a webhook with the following key fields:\n\nrenewal.eligible: true\nrenewal.minimumAmount: The minimum financing amount the user must accept to renew the grant.\nid: The unique identifier of the grant that is eligible for renewal.\n\nAlternatively, you can get this information by making the GET  \/grants request.\nThe following example shows a webhook for a grant eligible for grant renewal.\n\n    \n\n2. Get financing offers\n\nThe renewal offer must be at least 150% of the outstanding balance of the prior grant. Available offers are recalculated weekly and expire after seven days.\n\n\nGet financing offers for the account holder. You can get either dynamic or static offers.\nIn your user interface, present the offers that meet the renewal.minimumAmount from the webhook.\n\n3. Present the user with the new Terms of Service\n\nAfter the user selects a renewal offer, the receiveGrants capability is disallowed until the Terms of Service are accepted again.\n\nFor grant renewal, underwriting follows specific credit assessment rules to determine the new repayment percentage, fee, and maximum amount. The new terms can differ from the prior grant. The user must re-accept the Terms of Service before the subsequent grant can be disbursed.\n\nGenerate a Terms of Service document.\nIn your user interface, present the Terms of Service for acceptance.\n\n4. Configure a subsequent grant\nTo configure a subsequent grant:\n\n\nMake a POST  \/grants request, specifying the following parameters:\n\n\n\nParameter\nType\nRequired\nDescription\n\n\n\n\n counterparty.balanceAccountId\nString\n\nThe unique identifier of the balance account that belongs to the receiving account holder. Pass this parameter if you choose to pay out to the balance account of the user.If balanceAccountId is not provided in the request, the grant is paid out to the account holder's  primaryBalanceAccount.\n\n\n counterparty.transferInstrumentId\nString\n\nThe unique identifier of the transfer instrument that belongs to the legal entity of the account holder. Pass this parameter if you choose to pay out to the transfer instrument of the user.\n\n\n grantAccountId\nString\n\nThe unique identifier of the grant account. Reach out to your Adyen contact to get this value.\n\n\n grantOfferId\nString\n\nThe unique identifier of the grant offer that has been selected by the user.\n\n\nrenewsGrantId\nString\n\nThe unique identifier of the prior grant to renew.\n\n\n\n Required  Conditionally required\nThe following example shows how to configure a grant to renew a prior grant.\n\n\n\n\n\nIn the response, note the following parameters:\n\n\n\nParameter\nDescription\n\n\n\n\n id\nThe unique identifier of the grant.\n\n\n grantAccountId\nThe identifier of the grant account used to account for the grant.\n\n\n grantOfferId\nThe unique identifier for the related grant offer, which determines the grant conditions.\n\n\n counterparty\nAn object that contains the details of the receiving account holder.\n\n\n status\nThe status of the grant.\n\n\nrenewsGrantId\nThe unique identifier of the prior grant that the current grant renews.\n\n\n\n\n\n\n\n\nAdyen processes POST  \/grants requests asynchronously. You receive a response to your API request, but you must wait for the webhook to know the final result.\n5. Get updates\nAdyen sends the webhook messages for the following event types to your server to update you about the grant and fund transfer status.\n\n\n\nEvent type\nDescription\n\n\n\n\n balancePlatform.grants.created\nThe grant has been configured.\n\n\n balancePlatform.grants.updated\nThe grant has been fully repaid, reconfigured, or written off in case the user did not pay back all outstanding funds.\n\n\n balancePlatform.transfer.created\nThe outgoing or incoming grant transfer request has been received.\n\n\n balancePlatform.transfer.updated\nThe outgoing or incoming grant transfer request has been authorized and\/or booked.\n\n\n balancePlatform.transaction.created\nThe funds have been paid out to the balance account or the payment instrument.\n\n\n\nTo keep track of webhooks, make sure that your server can receive and accept webhooks.\n\n\n    \n        \n        \n    \n\n","type":"page","locale":"en","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Capital","lvl2":"Renew a grant"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/capital","lvl2":"\/capital\/renew-grant"},"levels":3,"category":"","category_color":"","tags":["Renew","grant"]}}
