{"title":"Manage user capabilities","category":"default","creationDate":1776961628,"content":"<p>Your users are represented by an account holder resource in your balance platform. Each account holder is associated with a set of capabilities that determine what they can do on your platform. To access business financing with Adyen Capital, users must have <em>capital capabilities<\/em>.<\/p>\n<p>In most cases, Adyen configures the necessary capabilities during the <a href=\"\/pt\/capital\/get-started#design-implementation\">design phase<\/a> of your Capital integration. These capabilities are then automatically requested for your users when you create account holders for them. However, you can request these capabilities later and enable or disable them for individual account holders if needed.<\/p>\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 with the Capital financial product enabled.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>API credentials<\/strong><\/td>\n<td style=\"text-align: left;\">To manage user capabilities through the API, you must have a <a href=\"\/pt\/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\/balanceplatform\/latest\/overview\" class=\" external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Configuration API<\/a>.<br\/><br\/>Your API credential must have the following role: <ul><li markdown=\"1\"><strong>Balance Platform BCL role<\/strong><\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Customer Area roles<\/strong><\/td>\n<td style=\"text-align: left;\">To manage user capabilities in the Customer Area, you must have the following <a href=\"\/pt\/account\/user-roles#platforms\">user role<\/a>:<ul><li markdown=\"1\"><strong>Manage account holder capabilities<\/strong><\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Limitations<\/strong><\/td>\n<td style=\"text-align: left;\">Your user must operate in one of the <a href=\"\/pt\/capital#supported-countriesregions\">supported countries\/regions<\/a>.<\/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 reached out to your Adyen contact to set up the necessary configurations to add the Capital financial product to your integration. For more details, see our <a href=\"\/pt\/capital\/integration-checklist\">Integration checklist<\/a>.<\/li><li markdown=\"1\">You followed our <a href=\"\/pt\/capital\/compliance-guidelines\">compliance guidelines for Capital<\/a> when creating user interfaces, marketing materials, and other processes.<\/li><li markdown=\"1\">You read our documentation about <a href=\"\/pt\/platforms\/verification-overview\/capabilities#capability-settings\">capability settings<\/a> and <a href=\"\/pt\/platforms\/verification-overview\/capabilities#verification-status-of-a-capability\">capability verification statuses<\/a>.<\/li><\/ul><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>Capital capabilities<\/h2>\n<p>Adyen Capital requires your user's account holder to have the following capabilities:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\"><div style=\"width:150px\">Capability name<\/div><\/th>\n<th style=\"text-align: left;\"><div style=\"width:250px\">Display name in Customer Area<\/div><\/th>\n<th style=\"text-align: left;\"><div style=\"width:50px\">Description<\/div><\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><strong>getGrantOffers<\/strong><\/td>\n<td style=\"text-align: left;\">Receive grant offers<\/td>\n<td style=\"text-align: left;\">Allows users to receive offers for business financing based on the volume of their payment processing.<\/br><\/br>When you request this capability for a user, Adyen evaluates their eligibility for business financing. When the user qualifies and the capability is <a href=\"\/pt\/platforms\/verification-overview\/capabilities#capability-settings\">allowed<\/a>, Adyen generates <a href=\"\/pt\/capital\/get-grant-offers\">grant offers<\/a> for them.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>receiveGrants<\/strong><\/td>\n<td style=\"text-align: left;\">Receive grants<\/td>\n<td style=\"text-align: left;\">Allows users to receive business financing funds from Adyen.<\/br><\/br>When you request this capability, Adyen verifies whether the account holder has signed the <a href=\"\/pt\/capital\/terms-of-service\">Terms of Service<\/a>. When they have and both <code>getGrantOffers<\/code> and <code>receiveGrants<\/code> capabilities are <a href=\"\/pt\/platforms\/verification-overview\/capabilities#capability-settings\">allowed<\/a>, you can proceed to <a href=\"\/pt\/capital\/make-grant-request\">disburse the funds<\/a> to your user.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"request-capability\">Request a capability<\/h2>\n<p>If needed, you can request capabilities for your account holders in your Customer Area or using the Configuration API.<\/p>\n<p>The following tabs show how to request a capability.<\/p>\n\n<div id=\"tabhqO4w\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Customer Area&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;To request a capability for an account holder in your &lt;a href=\\&quot;https:\\\/\\\/ca-test.adyen.com\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Customer Area&lt;\\\/a&gt;:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n  &lt;li&gt;\\n   Do one of the following:\\n   &lt;ul&gt;\\n      &lt;li&gt;\\n&lt;p&gt;Go to &lt;b&gt;Accounts &amp;amp; balances&lt;\\\/b&gt; &amp;gt; &lt;b&gt;Account holders&lt;\\\/b&gt; and select an account holder ID from the table.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n      &lt;li&gt;\\n&lt;p&gt;Search for an account holder by selecting &lt;b&gt;Search&lt;\\\/b&gt;. You can use the account holder ID, account holder reference, or the ID of the linked legal entity.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n   &lt;\\\/ul&gt;\\n&lt;\\\/li&gt;\\n  &lt;li&gt;\\n&lt;p&gt;On the &lt;strong&gt;Account holder details&lt;\\\/strong&gt; page, select the &lt;strong&gt;Capabilities&lt;\\\/strong&gt; tab and select &lt;strong&gt;+ Request new capability&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n  &lt;li&gt;\\n&lt;p&gt;From the dropdown menu, select a capability and, if applicable, its level.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n  &lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Submit&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n  &lt;li&gt;\\n&lt;p&gt;On the confirmation window, select &lt;strong&gt;Submit request&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;p&gt;The capability request is sent to Adyen for approval.&lt;\\\/p&gt;\\n&quot;,&quot;altTitle&quot;:&quot;ca&quot;,&quot;oldTabId&quot;:&quot;CA-1_1&quot;,&quot;relation&quot;:&quot;ca&quot;},{&quot;title&quot;:&quot;API&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;To request a capability for an account holder using the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/overview\\&quot; class=\\&quot; external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;Configuration API&lt;\\\/a&gt;:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;Make a PATCH  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/patch\\\/accountHolders\\\/(id)\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/accountHolders\\\/{id}&lt;\\\/a&gt; request, specifying the key-value pairs for each capability in the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/patch\\\/accountHolders\\\/(id)#responses-200-capabilities\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;capabilities&lt;\\\/a&gt; object. Set the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/patch\\\/accountHolders\\\/(id)#request-capabilities-requested\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;requested&lt;\\\/a&gt; parameter to &lt;strong&gt;true&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;p&gt;Here is an example of how to request the &lt;code&gt;getGrantOffers&lt;\\\/code&gt; capability for an existing user. If you are requesting multiple capabilities, add another set of key-value pairs.&lt;\\\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n&lt;code-sample :title=\\&quot;&#039;Request a capability&#039;\\&quot; :id=\\&quot;&#039;request-capability-capital&#039;\\&quot; :code-data=\\&quot;[{&amp;quot;language&amp;quot;:&amp;quot;bash&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;curl https:\\\\\\\/\\\\\\\/balanceplatform-api-test.adyen.com\\\\\\\/bcl\\\\\\\/v2\\\\\\\/accountHolders\\\\\\\/AH00000000000000000000001 \\\\\\\\\\\\n-H &#039;x-api-key: ADYEN_BALANCE_PLATFORM_API_KEY&#039; \\\\\\\\\\\\n-H &#039;content-type: application\\\\\\\/json&#039; \\\\\\\\\\\\n-X PATCH \\\\\\\\\\\\n-d &#039;{\\\\n  \\\\&amp;quot;capabilities\\\\&amp;quot; : {\\\\n    \\\\&amp;quot;getGrantOffers\\\\&amp;quot; : {\\\\n      \\\\&amp;quot;requested\\\\&amp;quot; : true\\\\n    }\\\\n  }\\\\n}&#039;&amp;quot;}]\\&quot; :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&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;In the response, note the following parameters and their respective values for the capability:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;&lt;code&gt;requested&lt;\\\/code&gt;: &lt;strong&gt;true&lt;\\\/strong&gt;&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;allowed&lt;\\\/code&gt;: &lt;strong&gt;false&lt;\\\/strong&gt;&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;verification status&lt;\\\/code&gt;: &lt;strong&gt;pending&lt;\\\/strong&gt;&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n&lt;code-sample :title=\\&quot;&#039;Response&#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;balancePlatform\\\\\\&quot;: \\\\\\&quot;YOUR_BALANCE_PLATFORM\\\\\\&quot;,\\\\n  \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;AH00000000000000000000001\\\\\\&quot;,\\\\n  \\\\\\&quot;legalEntityId\\\\\\&quot;: \\\\\\&quot;LE00000000000000000000001\\\\\\&quot;,\\\\n  \\\\\\&quot;description\\\\\\&quot;: \\\\\\&quot;S.Hopper\\\\\\&quot;,\\\\n  \\\\\\&quot;capabilities\\\\\\&quot;: {\\\\n    \\\\\\&quot;getGrantOffers\\\\\\&quot;: {\\\\n      \\\\\\&quot;requested\\\\\\&quot;: true,\\\\n      \\\\\\&quot;allowed\\\\\\&quot;: false,\\\\n      \\\\\\&quot;verificationStatus\\\\\\&quot;: \\\\\\&quot;pending\\\\\\&quot;\\\\n    }\\\\n  }\\\\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;:&quot;api&quot;,&quot;oldTabId&quot;:&quot;API-1_2&quot;,&quot;relation&quot;:&quot;api&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<h2 id=\"view-capability\">View capabilities<\/h2>\n<p>You can view an account holder's capabilities and their verification status in your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a> or by making a GET  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/balanceplatform\/latest\/get\/accountHolders\/(id)\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/accountHolders\/{id}<\/a> request. The following tabs explain both methods.<\/p>\n\n<div id=\"tabu5JvZ\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Customer Area&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;To view capabilities of an account holder in your &lt;a href=\\&quot;https:\\\/\\\/ca-test.adyen.com\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Customer Area&lt;\\\/a&gt;:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n  &lt;li&gt;\\n   Do one of the following:\\n   &lt;ul&gt;\\n      &lt;li&gt;\\n&lt;p&gt;Go to &lt;b&gt;Accounts &amp;amp; balances&lt;\\\/b&gt; &amp;gt; &lt;b&gt;Account holders&lt;\\\/b&gt; and select an account holder ID from the table.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n      &lt;li&gt;\\n&lt;p&gt;Search for an account holder by selecting &lt;b&gt;Search&lt;\\\/b&gt;. You can use the account holder ID, account holder reference, or the ID of the linked legal entity.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n   &lt;\\\/ul&gt;\\n&lt;\\\/li&gt;\\n  &lt;li&gt;\\n    On the &lt;b&gt;Account holder details&lt;\\\/b&gt; page, select the &lt;b&gt;Capabilities&lt;\\\/b&gt; tab. You can view the capabilities that are enabled, allowed and their verification status.\\n    &lt;ul&gt;\\n    &lt;\\\/ul&gt;\\n  &lt;\\\/li&gt;&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:&quot;ca&quot;,&quot;oldTabId&quot;:&quot;CA-2_1&quot;,&quot;relation&quot;:&quot;ca&quot;},{&quot;title&quot;:&quot;API&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;To view the capabilities of an account holder using the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/overview\\&quot; class=\\&quot; external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;Configuration API&lt;\\\/a&gt;:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;Make a GET  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/get\\\/accountHolders\\\/(id)\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/accountHolders\\\/{id}&lt;\\\/a&gt; request.&lt;\\\/li&gt;\\n&lt;li&gt;In the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/get\\\/accountHolders\\\/(id)#responses-200-capabilities\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;capabilities&lt;\\\/a&gt; object of the response, note the following parameters and values that are listed for each capability:\\n&lt;ul&gt;\\n&lt;li&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/get\\\/accountHolders\\\/(id)#responses-200-capabilities-allowed\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;allowed&lt;\\\/a&gt;&amp;#58; Boolean that indicates whether the capability is allowed. The possible values are &lt;strong&gt;true&lt;\\\/strong&gt; or &lt;strong&gt;false&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/get\\\/accountHolders\\\/(id)#responses-200-capabilities-enabled\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;enabled&lt;\\\/a&gt;&amp;#58; Boolean that indicates whether the user can use the capability. The possible values are &lt;strong&gt;true&lt;\\\/strong&gt; or &lt;strong&gt;false&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/get\\\/accountHolders\\\/(id)#responses-200-capabilities-verificationStatus\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;verificationStatus&lt;\\\/a&gt;&amp;#58; The status of the checks. The possible values are &lt;strong&gt;invalid&lt;\\\/strong&gt;, &lt;strong&gt;pending&lt;\\\/strong&gt;, &lt;strong&gt;rejected&lt;\\\/strong&gt;, or &lt;strong&gt;valid&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/get\\\/accountHolders\\\/(id)#responses-200-capabilities-problems\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;problems&lt;\\\/a&gt; array: When this array is not empty, this means that there are errors that you need to address. Refer to &lt;a href=\\&quot;\\\/pt\\\/capital\\\/kyc-verification-codes\\&quot;&gt;verification error codes&lt;\\\/a&gt; for a list of verification errors.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:&quot;api&quot;,&quot;oldTabId&quot;:&quot;API-2_2&quot;,&quot;relation&quot;:&quot;api&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<h2 id=\"deactivate-capability\">Enable or disable a capability<\/h2>\n<p>To allow or prevent an account holder from using a capability, update the capability in your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a> or make an API request. The following tabs explain both methods.<\/p>\n\n<div id=\"tabSzDJ3\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Customer Area&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;To enable or disable a capability for an account holder in your &lt;a href=\\&quot;https:\\\/\\\/ca-test.adyen.com\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Customer Area&lt;\\\/a&gt;:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n   &lt;li&gt;\\n      Do one of the following:\\n      &lt;ul&gt;\\n        &lt;li&gt;\\n&lt;p&gt;Go to &lt;b&gt;Accounts &amp;amp; balances&lt;\\\/b&gt; &amp;gt; &lt;b&gt;Account holders&lt;\\\/b&gt; and select an account holder ID from the table.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n         &lt;li&gt;\\n&lt;p&gt;Search for an account holder by selecting &lt;b&gt;Search&lt;\\\/b&gt;. You can use the account holder ID, account holder reference, or the ID of the linked legal entity.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n      &lt;\\\/ul&gt;\\n   &lt;\\\/li&gt;\\n   &lt;li&gt;\\n&lt;p&gt;On the &lt;strong&gt;Account holder details&lt;\\\/strong&gt; page, select the &lt;strong&gt;Capabilities&lt;\\\/strong&gt; tab and select &lt;strong&gt;Edit&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n   &lt;li&gt;\\n      In the &lt;b&gt;Enabled&lt;\\\/b&gt; column:\\n      &lt;ul&gt;\\n         &lt;li&gt;\\n&lt;p&gt;Select the corresponding checkbox to &lt;em&gt;enable&lt;\\\/em&gt; the capability.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n         &lt;li&gt;\\n&lt;p&gt;Clear the corresponding checkbox to &lt;em&gt;disable&lt;\\\/em&gt; the capability.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n      &lt;\\\/ul&gt;\\n   &lt;\\\/li&gt;\\n   &lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Save&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n   &lt;li&gt;\\n&lt;p&gt;On the confirmation window, select &lt;strong&gt;Save changes&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:&quot;ca&quot;,&quot;oldTabId&quot;:&quot;CA-3_1&quot;,&quot;relation&quot;:&quot;ca&quot;},{&quot;title&quot;:&quot;API&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;To enable or disable a capability for an account holder using the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/overview\\&quot; class=\\&quot; external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;Configuration API&lt;\\\/a&gt;:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;Make a PATCH  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/patch\\\/accountHolders\\\/(id)\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/accountHolders\\\/{id}&lt;\\\/a&gt; request specifying the following parameter for a capability:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/get\\\/accountHolders\\\/(id)#responses-200-capabilities-enabled\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;enabled&lt;\\\/a&gt;&amp;#58; Set this to &lt;strong&gt;true&lt;\\\/strong&gt; or &lt;strong&gt;false&lt;\\\/strong&gt; to enable or disable the capability, respectively.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;Here is an example of how to disable the &lt;code&gt;getGrantOffers&lt;\\\/code&gt; capability for an account holder. If you are requesting multiple capabilities, add another set of key-value pairs.&lt;\\\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n&lt;code-sample :title=\\&quot;&#039;Disable a capability&#039;\\&quot; :id=\\&quot;&#039;deactivate-capability-capital&#039;\\&quot; :code-data=\\&quot;[{&amp;quot;language&amp;quot;:&amp;quot;bash&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;curl https:\\\\\\\/\\\\\\\/balanceplatform-api-test.adyen.com\\\\\\\/bcl\\\\\\\/v2\\\\\\\/accountHolders\\\\\\\/AH00000000000000000000001 \\\\\\\\\\\\n-H &#039;x-api-key: ADYEN_BALANCE_PLATFORM_API_KEY&#039; \\\\\\\\\\\\n-H &#039;content-type: application\\\\\\\/json&#039; \\\\\\\\\\\\n-X PATCH \\\\\\\\\\\\n-d &#039;{\\\\n\\\\t\\\\&amp;quot;capabilities\\\\&amp;quot;: {\\\\n    \\\\t\\\\&amp;quot;getGrantOffers\\\\&amp;quot;: {\\\\n        \\\\t\\\\&amp;quot;enabled\\\\&amp;quot;: false\\\\n    \\\\t}\\\\n\\\\t}\\\\n}&#039;&amp;quot;}]\\&quot; :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&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;In the response, note the following parameters and their respective values for each capability:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;&lt;code&gt;enabled&lt;\\\/code&gt;: &lt;strong&gt;false&lt;\\\/strong&gt;&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;allowed&lt;\\\/code&gt;: &lt;strong&gt;true&lt;\\\/strong&gt;&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;verification status&lt;\\\/code&gt;: &lt;strong&gt;valid&lt;\\\/strong&gt;&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n&lt;code-sample :title=\\&quot;&#039;Response&#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;balancePlatform\\\\\\&quot;: \\\\\\&quot;YOUR_BALANCE_PLATFORM\\\\\\&quot;,\\\\n  \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;AH00000000000000000000001\\\\\\&quot;,\\\\n  \\\\\\&quot;legalEntityId\\\\\\&quot;: \\\\\\&quot;LE00000000000000000000001\\\\\\&quot;,\\\\n  \\\\\\&quot;description\\\\\\&quot;: \\\\\\&quot;S.Hopper\\\\\\&quot;,\\\\n  \\\\\\&quot;capabilities\\\\\\&quot;: {\\\\n    \\\\\\&quot;getGrantOffers\\\\\\&quot;: {\\\\n      \\\\\\&quot;enabled\\\\\\&quot;: false,\\\\n      \\\\\\&quot;allowed\\\\\\&quot;: true,\\\\n      \\\\\\&quot;verificationStatus\\\\\\&quot;: \\\\\\&quot;valid\\\\\\&quot;\\\\n    }\\\\n  }\\\\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;:&quot;api&quot;,&quot;oldTabId&quot;:&quot;API-3_2&quot;,&quot;relation&quot;:&quot;api&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/capital\/manage-user-capabilities","articleFields":{"description":"Learn about the capabilities your user must have to get business financing and how to manage them.","feedback_component":true,"id":"25142879","type":"page","_expandable":{"operations":""},"status":"current","next_steps":[{"title":"Integrate with components","description":"Learn how to integrate our prebuilt UI components to accelerate your Capital integration process.","url":"\/capital\/terms-of-service","required":false},{"title":"Integrate using APIs","description":"Learn how to use our APIs to build your Capital integration from scratch.","url":"\/capital\/make-grant-request","required":false}],"parameters":{"financialProduct":"capital","model":"balance platform","directoryPath":"\/capital"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/capital\/manage-user-capabilities","title":"Manage user capabilities","content":"Your users are represented by an account holder resource in your balance platform. Each account holder is associated with a set of capabilities that determine what they can do on your platform. To access business financing with Adyen Capital, users must have capital capabilities.\nIn most cases, Adyen configures the necessary capabilities during the design phase of your Capital integration. These capabilities are then automatically requested for your users when you create account holders for them. However, you can request these capabilities later and enable or disable them for individual account holders if needed.\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 with the Capital financial product enabled.\n\n\nAPI credentials\nTo manage user capabilities through the API, you must have a Balance Platform API key (for example, ws[_123456]@BalancePlatform.[YourBalancePlatform]) to access the  Configuration API.Your API credential must have the following role: Balance Platform BCL role\n\n\nCustomer Area roles\nTo manage user capabilities in the Customer Area, you must have the following user role:Manage account holder capabilities\n\n\nLimitations\nYour user must operate in one of the supported countries\/regions.\n\n\nSetup steps\nBefore you begin, make sure: You reached out to your Adyen contact to set up the necessary configurations to add the Capital financial product to your integration. For more details, see our Integration checklist.You followed our compliance guidelines for Capital when creating user interfaces, marketing materials, and other processes.You read our documentation about capability settings and capability verification statuses.\n\n\n\nCapital capabilities\nAdyen Capital requires your user's account holder to have the following capabilities:\n\n\n\nCapability name\nDisplay name in Customer Area\nDescription\n\n\n\n\ngetGrantOffers\nReceive grant offers\nAllows users to receive offers for business financing based on the volume of their payment processing.When you request this capability for a user, Adyen evaluates their eligibility for business financing. When the user qualifies and the capability is allowed, Adyen generates grant offers for them.\n\n\nreceiveGrants\nReceive grants\nAllows users to receive business financing funds from Adyen.When you request this capability, Adyen verifies whether the account holder has signed the Terms of Service. When they have and both getGrantOffers and receiveGrants capabilities are allowed, you can proceed to disburse the funds to your user.\n\n\n\nRequest a capability\nIf needed, you can request capabilities for your account holders in your Customer Area or using the Configuration API.\nThe following tabs show how to request a capability.\n\n\n    \n        \n        \n    \n\n\nView capabilities\nYou can view an account holder's capabilities and their verification status in your Customer Area or by making a GET  \/accountHolders\/{id} request. The following tabs explain both methods.\n\n\n    \n        \n        \n    \n\n\nEnable or disable a capability\nTo allow or prevent an account holder from using a capability, update the capability in your Customer Area or make an API request. The following tabs explain both methods.\n\n\n    \n        \n        \n    \n\n","type":"page","locale":"pt","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Capital","lvl2":"Manage user capabilities"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/capital","lvl2":"\/pt\/capital\/manage-user-capabilities"},"levels":3,"category":"","category_color":"","tags":["Manage","capabilities"]}}
