{"title":"Legal arrangements check","category":"Classic Platforms","creationDate":1776961628,"content":"<div class=\"sc-notice info\"><div>\n<p>This page is for classic Adyen for Platforms integrations. If you are just starting your implementation, refer to our <a href=\"\/pt\/adyen-for-platforms-model\">new integration guide<\/a> instead.<\/p>\n<\/div><\/div>\n<p>Account holders that conduct business with Adyen on behalf of another entity as established in a contractual agreement must also provide information about their agreement. We refer to contractual agreements as <em>legal arrangements<\/em>.<\/p>\n<p>Some examples of legal arrangements are:<\/p>\n<ul>\n<li>Involvement in a trust. For example, a business is a corporate trustee and is conducting business on behalf of the trust.<\/li>\n<li>Sole proprietorship. An individual is registered as a sole proprietor in the country they are operating in.<\/li>\n<\/ul>\n<p>You can onboard account holders with legal arrangements through:<\/p>\n<ul>\n<li><a href=\"\/pt\/classic-platforms\/onboard-users\/hosted-onboarding-page\">Hosted onboarding<\/a>: HOP supports collecting requirements by default.<\/li>\n<li>Your own onboarding flow: Follow the steps on this page to <a href=\"#required-information\">collect documents and additional information<\/a> in your UI and then <a href=\"#send-through-api\">send the information<\/a> to Adyen. This requires <strong>API version 6<\/strong>.<\/li>\n<\/ul>\n<p>The information that account holders provide will be part of the verification checks. Failing to declare legal arrangements can result in blocked payouts and account suspensions.<\/p>\n<h2>Types of legal arrangements<\/h2>\n<p>Account holders in your platform must provide additional information if they are part of the following legal arrangements.<\/p>\n<ul>\n<li>\n<p><strong>Association<\/strong><br \/>\nThe account holder, along with one or more associates, manages and shares profits of the business in accordance with agreed upon articles of association.<\/p>\n<\/li>\n<li>\n<p><strong>Partnership<\/strong><br \/>\nThe account holder, along with one or more legal entities (partners), manage, operate and share profits of their jointly-owned business. The account holder is wholly or partially liable for the debts of the partnership.<\/p>\n<\/li>\n<li>\n<p><strong>Sole proprietorship<\/strong><br \/>\nThe individual is registered as a sole proprietor, operates the business on their own, and is personally liable for the debts of the sole proprietorship.<\/p>\n<\/li>\n<li>\n<p><strong>Trust<\/strong><br \/>\nThe account holder (as the trustee) holds and manages assets for the beneficiaries in an agreement laid out in the trust deed.<\/p>\n<\/li>\n<\/ul>\n<h3 id=\"supported-countries\">Supported legal arrangements<\/h3>\n<p>Adyen supports different legal arrangements for account holders operating in the following countries.<\/p>\n<ul>\n<li><strong>Association<\/strong>: Both the account holder and the association must be operating and established in the US.<\/li>\n<li><strong>Partnership<\/strong>: Australia, Singapore<\/li>\n<li><strong>Sole proprietorship<\/strong>: Singapore<\/li>\n<li><strong>Trust<\/strong>: Australia, Singapore<\/li>\n<\/ul>\n<p>Except for associations, the country where the legal arrangement was established can be different from the account holder's country of operation.<\/p>\n<h2 id=\"required-information\">Step 1: Collect the required information<\/h2>\n<p>Account holders that are part of a legal arrangement must provide the following additional information.<\/p>\n\n<div id=\"tabUmpA7\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Association&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;If the account holder is a partner conducting business on behalf of the association, they need to provide:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;The name of the association.&lt;\\\/li&gt;\\n&lt;li&gt;The country where the association was established. This can be different from the country where the account holder is operating.&lt;\\\/li&gt;\\n&lt;li&gt;The registration number.&lt;\\\/li&gt;\\n&lt;li&gt;Information about other associates.\\n&lt;ul&gt;\\n&lt;li&gt;Their legal entity type. Can be individual, business, nonprofit, or public company.&lt;\\\/li&gt;\\n&lt;li&gt;Their name, birthdate, and address.&lt;\\\/li&gt;\\n&lt;li&gt;Their ID number.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&quot;,&quot;altTitle&quot;:&quot;association&quot;,&quot;oldTabId&quot;:&quot;required-association_1&quot;,&quot;relation&quot;:&quot;association&quot;},{&quot;title&quot;:&quot;Partnership&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;If the account holder is a partner conducting business on behalf of the partnership, they need to provide:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;The name of the partnership.&lt;\\\/li&gt;\\n&lt;li&gt;The type of partnership. Refer to  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/updateAccountHolder#request-accountHolderDetails-legalArrangements-legalForm\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;legalForm&lt;\\\/a&gt; for possible values.&lt;\\\/li&gt;\\n&lt;li&gt;The country where the partnership was established. This can be different from the country where the account holder is operating.&lt;\\\/li&gt;\\n&lt;li&gt;The registration number.&lt;\\\/li&gt;\\n&lt;li&gt;Information about other partners.\\n&lt;ul&gt;\\n&lt;li&gt;Their legal entity type. Can be individual, business, nonprofit, or public company.&lt;\\\/li&gt;\\n&lt;li&gt;Their name, birthdate, and address.&lt;\\\/li&gt;\\n&lt;li&gt;Their ID number.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&quot;,&quot;altTitle&quot;:&quot;partnership&quot;,&quot;oldTabId&quot;:&quot;required-partnership_2&quot;,&quot;relation&quot;:&quot;partnership&quot;},{&quot;title&quot;:&quot;Sole proprietorship&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;If the account holder is a sole proprietor, they need to provide:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;The name of the business.&lt;\\\/li&gt;\\n&lt;li&gt;The country where the sole proprietorship is registered. This can be different from the country where the account holder is operating.&lt;\\\/li&gt;\\n&lt;li&gt;The registration number.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&quot;,&quot;altTitle&quot;:&quot;sole-prop&quot;,&quot;oldTabId&quot;:&quot;required-sole-prop_3&quot;,&quot;relation&quot;:&quot;sole-prop&quot;},{&quot;title&quot;:&quot;Trust&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;If the account holder is a trustee conducting business on behalf of the trust, they need to provide:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;The name of the trust.&lt;\\\/li&gt;\\n&lt;li&gt;The type of the trust. Refer to  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/updateAccountHolder#request-accountHolderDetails-legalArrangements-legalForm\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;legalForm&lt;\\\/a&gt; for possible values.&lt;\\\/li&gt;\\n&lt;li&gt;The country where the trust was established. This can be different from the country where the account holder is operating.&lt;\\\/li&gt;\\n&lt;li&gt;The registration number of the trust.&lt;\\\/li&gt;\\n&lt;li&gt;A document that proves the trust (required for Australia).&lt;\\\/li&gt;\\n&lt;li&gt;Information about at least one member of the legal arrangement, such as other trustees, settlors, protectors, or beneficiaries.\\n&lt;ul&gt;\\n&lt;li&gt;Their legal entity type. Can be individual, business, nonprofit, or public company.&lt;\\\/li&gt;\\n&lt;li&gt;Their name, birthdate, and address.&lt;\\\/li&gt;\\n&lt;li&gt;Their ID number.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&quot;,&quot;altTitle&quot;:&quot;trust&quot;,&quot;oldTabId&quot;:&quot;required-trust_4&quot;,&quot;relation&quot;:&quot;trust&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<p>Adyen uses the information to run automatic verification checks on the legal arrangement and other parties involved. For example, in a partnership where the other partner is a private company, Adyen performs a company check. If the checks fail, Adyen might require the account holder to provide a document that proves the legal arrangement.<\/p>\n<h2 id=\"send-through-api\">Step 2: Update the account holder<\/h2>\n<p>Update an existing account holder and send the information that you received from them in the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Account\/latest\/post\/updateAccountHolder#request-accountHolderDetails-legalArrangements\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">legalArrangements<\/a> array.<\/p>\n\n<div id=\"taboIsF2\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Association&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;The following example shows how to update an existing account holder to include information about their association.&lt;\\\/p&gt;\\n&lt;p&gt;In your POST &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/#\\\/Account\\\/updateAccountHolder\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/updateAccountHolder&lt;\\\/a&gt; request, specify:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;The unique  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/createAccountHolder#request-accountHolderCode\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;accountHolderCode&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;The  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/createAccountHolder#request-accountHolderDetails-legalArrangements\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;legalArrangements&lt;\\\/a&gt; array containing:\\n&lt;ul&gt;\\n&lt;li&gt;The  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/createAccountHolder#request-accountHolderDetails-legalArrangements-legalArrangementReference\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;legalArrangementReference&lt;\\\/a&gt;&amp;#58; Your reference for the legal arrangement.&lt;\\\/li&gt;\\n&lt;li&gt;The  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/createAccountHolder#request-accountHolderDetails-legalArrangements-type\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;type&lt;\\\/a&gt;&amp;#58; Set to &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;Association&lt;\\\/strong&gt;&lt;\\\/span&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;The minimum required information you have collected from the account holder, such as the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/createAccountHolder#request-accountHolderDetails-legalArrangements-name\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;name&lt;\\\/a&gt; of the association,  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/createAccountHolder#request-accountHolderDetails-legalArrangements-address-country\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;address&lt;\\\/a&gt;, and  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/createAccountHolder#request-accountHolderDetails-legalArrangements-registrationNumber\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;registrationNumber&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;The  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/updateAccountHolder#request-accountHolderDetails-legalArrangements-legalArrangementEntities\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;legalArrangementEntities&lt;\\\/a&gt;&amp;#58; Contains information about other members of the legal arrangement.&lt;\\\/li&gt;\\n&lt;\\\/ul&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;Add information about an association&#039;\\&quot; :id=\\&quot;&#039;&#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:\\\\\\\/\\\\\\\/cal-test.adyen.com\\\\\\\/cal\\\\\\\/services\\\\\\\/Account\\\\\\\/v6\\\\\\\/updateAccountHolder \\\\\\\\\\\\n-H &#039;x-api-key: ADYEN_API_KEY&#039; \\\\\\\\\\\\n-H &#039;content-type: application\\\\\\\/json&#039; \\\\\\\\\\\\n-d &#039;{\\\\n  \\\\&amp;quot;accountHolderCode\\\\&amp;quot;:\\\\&amp;quot;ACCOUNT_HOLDER_CODE\\\\&amp;quot;,\\\\n  \\\\&amp;quot;accountHolderDetails\\\\&amp;quot;:{\\\\n    \\\\&amp;quot;legalArrangements\\\\&amp;quot;:[\\\\n      {\\\\n        \\\\&amp;quot;legalArrangementReference\\\\&amp;quot;:\\\\&amp;quot;YOUR_REFERENCE\\\\&amp;quot;,\\\\n        \\\\&amp;quot;name\\\\&amp;quot;:\\\\&amp;quot;NAME_OF_ASSOCIATION\\\\&amp;quot;,\\\\n        \\\\&amp;quot;type\\\\&amp;quot;:\\\\&amp;quot;Association\\\\&amp;quot;,\\\\n        \\\\&amp;quot;legalEntityType\\\\&amp;quot;:\\\\&amp;quot;Business\\\\&amp;quot;,\\\\n        \\\\&amp;quot;phoneNumber\\\\&amp;quot;:{\\\\n          \\\\&amp;quot;phoneCountryCode\\\\&amp;quot;:\\\\&amp;quot;US\\\\&amp;quot;,\\\\n          \\\\&amp;quot;phoneNumber\\\\&amp;quot;:\\\\&amp;quot;0207112304\\\\&amp;quot;,\\\\n          \\\\&amp;quot;phoneType\\\\&amp;quot;:\\\\&amp;quot;Mobile\\\\&amp;quot;\\\\n        },\\\\n        \\\\&amp;quot;registrationNumber\\\\&amp;quot;:\\\\&amp;quot;13134A\\\\&amp;quot;,\\\\n        \\\\&amp;quot;email\\\\&amp;quot;:\\\\&amp;quot;entity_001@example.com\\\\&amp;quot;,\\\\n        \\\\&amp;quot;address\\\\&amp;quot;:{\\\\n          \\\\&amp;quot;city\\\\&amp;quot;:\\\\&amp;quot;San Francisco\\\\&amp;quot;,\\\\n          \\\\&amp;quot;country\\\\&amp;quot;:\\\\&amp;quot;US\\\\&amp;quot;,\\\\n          \\\\&amp;quot;houseNumberOrName\\\\&amp;quot;:\\\\&amp;quot;274\\\\&amp;quot;,\\\\n          \\\\&amp;quot;postalCode\\\\&amp;quot;:\\\\&amp;quot;94107\\\\&amp;quot;,\\\\n          \\\\&amp;quot;stateOrProvince\\\\&amp;quot;:\\\\&amp;quot;CA\\\\&amp;quot;,\\\\n          \\\\&amp;quot;street\\\\&amp;quot;:\\\\&amp;quot;Association street\\\\&amp;quot;\\\\n        },\\\\n        \\\\&amp;quot;legalArrangementEntities\\\\&amp;quot;:[\\\\n          {\\\\n            \\\\&amp;quot;legalEntityType\\\\&amp;quot;:\\\\&amp;quot;Business\\\\&amp;quot;,\\\\n            \\\\&amp;quot;legalArrangementMembers\\\\&amp;quot;:[\\\\n              \\\\&amp;quot;ControllingPerson\\\\&amp;quot;,\\\\n              \\\\&amp;quot;Shareholder\\\\&amp;quot;\\\\n            ],\\\\n            \\\\&amp;quot;address\\\\&amp;quot;:{\\\\n              \\\\&amp;quot;city\\\\&amp;quot;:\\\\&amp;quot;Los Angeles\\\\&amp;quot;,\\\\n              \\\\&amp;quot;country\\\\&amp;quot;:\\\\&amp;quot;US\\\\&amp;quot;,\\\\n              \\\\&amp;quot;houseNumberOrName\\\\&amp;quot;:\\\\&amp;quot;Level 7 - 222\\\\&amp;quot;,\\\\n              \\\\&amp;quot;postalCode\\\\&amp;quot;:\\\\&amp;quot;30000\\\\&amp;quot;,\\\\n              \\\\&amp;quot;stateOrProvince\\\\&amp;quot;:\\\\&amp;quot;CA\\\\&amp;quot;,\\\\n              \\\\&amp;quot;street\\\\&amp;quot;:\\\\&amp;quot;Association Shareholder Street\\\\&amp;quot;\\\\n            },\\\\n            \\\\&amp;quot;businessDetails\\\\&amp;quot;:{\\\\n              \\\\&amp;quot;legalBusinessName\\\\&amp;quot;:\\\\&amp;quot;NAME_OF_SHAREHOLDER_BUSINESS\\\\&amp;quot;,\\\\n              \\\\&amp;quot;shareholders\\\\&amp;quot;:[\\\\n                {\\\\n                  \\\\&amp;quot;address\\\\&amp;quot;:{\\\\n                    \\\\&amp;quot;city\\\\&amp;quot;:\\\\&amp;quot;San Diego\\\\&amp;quot;,\\\\n                    \\\\&amp;quot;country\\\\&amp;quot;:\\\\&amp;quot;US\\\\&amp;quot;,\\\\n                    \\\\&amp;quot;houseNumberOrName\\\\&amp;quot;:\\\\&amp;quot;50\\\\&amp;quot;,\\\\n                    \\\\&amp;quot;postalCode\\\\&amp;quot;:\\\\&amp;quot;88319\\\\&amp;quot;,\\\\n                    \\\\&amp;quot;stateOrProvince\\\\&amp;quot;:\\\\&amp;quot;CA\\\\&amp;quot;,\\\\n                    \\\\&amp;quot;street\\\\&amp;quot;:\\\\&amp;quot;Partner Street\\\\&amp;quot;\\\\n                  },\\\\n                  \\\\&amp;quot;email\\\\&amp;quot;:\\\\&amp;quot;partnershareholder@example.com\\\\&amp;quot;,\\\\n                  \\\\&amp;quot;name\\\\&amp;quot;:{\\\\n                    \\\\&amp;quot;firstName\\\\&amp;quot;:\\\\&amp;quot;Jane\\\\&amp;quot;,\\\\n                    \\\\&amp;quot;lastName\\\\&amp;quot;:\\\\&amp;quot;Hopper\\\\&amp;quot;\\\\n                  },\\\\n                  \\\\&amp;quot;personalData\\\\&amp;quot;:{\\\\n                    \\\\&amp;quot;dateOfBirth\\\\&amp;quot;:\\\\&amp;quot;1970-01-01\\\\&amp;quot;,\\\\n                    \\\\&amp;quot;documentData\\\\&amp;quot;:[\\\\n                      {\\\\n                        \\\\&amp;quot;number\\\\&amp;quot;:\\\\&amp;quot;1994787577\\\\&amp;quot;,\\\\n                        \\\\&amp;quot;type\\\\&amp;quot;:\\\\&amp;quot;ID\\\\&amp;quot;\\\\n                      }\\\\n                    ],\\\\n                    \\\\&amp;quot;nationality\\\\&amp;quot;:\\\\&amp;quot;NL\\\\&amp;quot;\\\\n                  },\\\\n                  \\\\&amp;quot;phoneNumber\\\\&amp;quot;:{\\\\n                    \\\\&amp;quot;phoneCountryCode\\\\&amp;quot;:\\\\&amp;quot;NL\\\\&amp;quot;,\\\\n                    \\\\&amp;quot;phoneNumber\\\\&amp;quot;:\\\\&amp;quot;4515076\\\\&amp;quot;,\\\\n                    \\\\&amp;quot;phoneType\\\\&amp;quot;:\\\\&amp;quot;Mobile\\\\&amp;quot;\\\\n                  },\\\\n                  \\\\&amp;quot;shareholderCode\\\\&amp;quot;:\\\\&amp;quot;266af44b-733c-4c5e-90c8-f01f84d75ca8\\\\&amp;quot;\\\\n                }\\\\n              ]\\\\n            }\\\\n          }\\\\n        ]\\\\n      }\\\\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&quot;,&quot;altTitle&quot;:&quot;association&quot;,&quot;oldTabId&quot;:&quot;example-association_1&quot;,&quot;relation&quot;:&quot;association&quot;},{&quot;title&quot;:&quot;Partnership&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;The following example shows how to update an existing account holder to include information about their partnership.&lt;\\\/p&gt;\\n&lt;p&gt;In your POST &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/#\\\/Account\\\/updateAccountHolder\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/updateAccountHolder&lt;\\\/a&gt; request, specify:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;The unique  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/createAccountHolder#request-accountHolderCode\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;accountHolderCode&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;The  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/createAccountHolder#request-accountHolderDetails-legalArrangements\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;legalArrangements&lt;\\\/a&gt; array containing:\\n&lt;ul&gt;\\n&lt;li&gt;The  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/createAccountHolder#request-accountHolderDetails-legalArrangements-legalArrangementReference\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;legalArrangementReference&lt;\\\/a&gt;&amp;#58; Your reference for the legal arrangement.&lt;\\\/li&gt;\\n&lt;li&gt;The  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/createAccountHolder#request-accountHolderDetails-legalArrangements-type\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;type&lt;\\\/a&gt;&amp;#58; Set to &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;Partnership&lt;\\\/strong&gt;&lt;\\\/span&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;The  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/updateAccountHolder#request-accountHolderDetails-legalArrangements-legalForm\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;legalForm&lt;\\\/a&gt;. The structure of the partnership as defined according to the country&#039;s legislation.&lt;\\\/li&gt;\\n&lt;li&gt;The minimum required information you have collected from the account holder, such as the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/createAccountHolder#request-accountHolderDetails-legalArrangements-name\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;name&lt;\\\/a&gt; of the partnership,  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/createAccountHolder#request-accountHolderDetails-legalArrangements-address-country\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;address&lt;\\\/a&gt;, and  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/createAccountHolder#request-accountHolderDetails-legalArrangements-registrationNumber\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;registrationNumber&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;The  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/updateAccountHolder#request-accountHolderDetails-legalArrangements-legalArrangementEntities\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;legalArrangementEntities&lt;\\\/a&gt;&amp;#58; Contains information about other members of the legal arrangement.&lt;\\\/li&gt;\\n&lt;\\\/ul&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;Add information about a partnership&#039;\\&quot; :id=\\&quot;&#039;&#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:\\\\\\\/\\\\\\\/cal-test.adyen.com\\\\\\\/cal\\\\\\\/services\\\\\\\/Account\\\\\\\/v6\\\\\\\/updateAccountHolder \\\\\\\\\\\\n-H &#039;x-api-key: ADYEN_API_KEY&#039; \\\\\\\\\\\\n-H &#039;content-type: application\\\\\\\/json&#039; \\\\\\\\\\\\n-d &#039;{\\\\n  \\\\&amp;quot;accountHolderCode\\\\&amp;quot;:\\\\&amp;quot;ACCOUNT_HOLDER_CODE\\\\&amp;quot;,\\\\n  \\\\&amp;quot;accountHolderDetails\\\\&amp;quot;:{\\\\n    \\\\&amp;quot;legalArrangements\\\\&amp;quot;:[\\\\n      {\\\\n        \\\\&amp;quot;legalArrangementReference\\\\&amp;quot;:\\\\&amp;quot;YOUR_REFERENCE\\\\&amp;quot;,\\\\n        \\\\&amp;quot;legalForm\\\\&amp;quot;:\\\\&amp;quot;FamilyPartnership\\\\&amp;quot;,\\\\n        \\\\&amp;quot;name\\\\&amp;quot;:\\\\&amp;quot;NAME_OF_PARTNERSHIP\\\\&amp;quot;,\\\\n        \\\\&amp;quot;type\\\\&amp;quot;:\\\\&amp;quot;Partnership\\\\&amp;quot;,\\\\n        \\\\&amp;quot;legalEntityType\\\\&amp;quot;:\\\\&amp;quot;Business\\\\&amp;quot;,\\\\n        \\\\&amp;quot;phoneNumber\\\\&amp;quot;:{\\\\n          \\\\&amp;quot;phoneCountryCode\\\\&amp;quot;:\\\\&amp;quot;AU\\\\&amp;quot;,\\\\n          \\\\&amp;quot;phoneNumber\\\\&amp;quot;:\\\\&amp;quot;0207112304\\\\&amp;quot;,\\\\n          \\\\&amp;quot;phoneType\\\\&amp;quot;:\\\\&amp;quot;Mobile\\\\&amp;quot;\\\\n        },\\\\n        \\\\&amp;quot;registrationNumber\\\\&amp;quot;:\\\\&amp;quot;13134A\\\\&amp;quot;,\\\\n        \\\\&amp;quot;email\\\\&amp;quot;:\\\\&amp;quot;entity_001@example.com\\\\&amp;quot;,\\\\n        \\\\&amp;quot;address\\\\&amp;quot;:{\\\\n          \\\\&amp;quot;city\\\\&amp;quot;:\\\\&amp;quot;Sydney\\\\&amp;quot;,\\\\n          \\\\&amp;quot;country\\\\&amp;quot;:\\\\&amp;quot;AU\\\\&amp;quot;,\\\\n          \\\\&amp;quot;houseNumberOrName\\\\&amp;quot;:\\\\&amp;quot;50\\\\&amp;quot;,\\\\n          \\\\&amp;quot;postalCode\\\\&amp;quot;:\\\\&amp;quot;2010\\\\&amp;quot;,\\\\n          \\\\&amp;quot;stateOrProvince\\\\&amp;quot;:\\\\&amp;quot;NSW\\\\&amp;quot;,\\\\n          \\\\&amp;quot;street\\\\&amp;quot;:\\\\&amp;quot;Partnership street\\\\&amp;quot;\\\\n        },\\\\n        \\\\&amp;quot;legalArrangementEntities\\\\&amp;quot;:[\\\\n          {\\\\n            \\\\&amp;quot;legalEntityType\\\\&amp;quot;:\\\\&amp;quot;Business\\\\&amp;quot;,\\\\n            \\\\&amp;quot;legalArrangementMembers\\\\&amp;quot;:[\\\\n              \\\\&amp;quot;Partner\\\\&amp;quot;\\\\n            ],\\\\n            \\\\&amp;quot;address\\\\&amp;quot;:{\\\\n              \\\\&amp;quot;city\\\\&amp;quot;:\\\\&amp;quot;Melbourne\\\\&amp;quot;,\\\\n              \\\\&amp;quot;country\\\\&amp;quot;:\\\\&amp;quot;AU\\\\&amp;quot;,\\\\n              \\\\&amp;quot;houseNumberOrName\\\\&amp;quot;:\\\\&amp;quot;Level 7 - 222\\\\&amp;quot;,\\\\n              \\\\&amp;quot;postalCode\\\\&amp;quot;:\\\\&amp;quot;30000\\\\&amp;quot;,\\\\n              \\\\&amp;quot;stateOrProvince\\\\&amp;quot;:\\\\&amp;quot;VIC\\\\&amp;quot;,\\\\n              \\\\&amp;quot;street\\\\&amp;quot;:\\\\&amp;quot;Trust Legal Arrangement Street\\\\&amp;quot;\\\\n            },\\\\n            \\\\&amp;quot;businessDetails\\\\&amp;quot;:{\\\\n              \\\\&amp;quot;legalBusinessName\\\\&amp;quot;:\\\\&amp;quot;NAME_OF_PARTNER_BUSINESS\\\\&amp;quot;,\\\\n              \\\\&amp;quot;shareholders\\\\&amp;quot;:[\\\\n                {\\\\n                  \\\\&amp;quot;address\\\\&amp;quot;:{\\\\n                    \\\\&amp;quot;city\\\\&amp;quot;:\\\\&amp;quot;Melbourne\\\\&amp;quot;,\\\\n                    \\\\&amp;quot;country\\\\&amp;quot;:\\\\&amp;quot;AU\\\\&amp;quot;,\\\\n                    \\\\&amp;quot;houseNumberOrName\\\\&amp;quot;:\\\\&amp;quot;50\\\\&amp;quot;,\\\\n                    \\\\&amp;quot;postalCode\\\\&amp;quot;:\\\\&amp;quot;88319\\\\&amp;quot;,\\\\n                    \\\\&amp;quot;stateOrProvince\\\\&amp;quot;:\\\\&amp;quot;VIC\\\\&amp;quot;,\\\\n                    \\\\&amp;quot;street\\\\&amp;quot;:\\\\&amp;quot;Partner Street\\\\&amp;quot;\\\\n                  },\\\\n                  \\\\&amp;quot;email\\\\&amp;quot;:\\\\&amp;quot;partnershareholder@example.com\\\\&amp;quot;,\\\\n                  \\\\&amp;quot;name\\\\&amp;quot;:{\\\\n                    \\\\&amp;quot;firstName\\\\&amp;quot;:\\\\&amp;quot;Jane\\\\&amp;quot;,\\\\n                    \\\\&amp;quot;lastName\\\\&amp;quot;:\\\\&amp;quot;Hopper\\\\&amp;quot;\\\\n                  },\\\\n                  \\\\&amp;quot;personalData\\\\&amp;quot;:{\\\\n                    \\\\&amp;quot;dateOfBirth\\\\&amp;quot;:\\\\&amp;quot;1970-01-01\\\\&amp;quot;,\\\\n                    \\\\&amp;quot;documentData\\\\&amp;quot;:[\\\\n                      {\\\\n                        \\\\&amp;quot;number\\\\&amp;quot;:\\\\&amp;quot;1994787577\\\\&amp;quot;,\\\\n                        \\\\&amp;quot;type\\\\&amp;quot;:\\\\&amp;quot;ID\\\\&amp;quot;\\\\n                      }\\\\n                    ],\\\\n                    \\\\&amp;quot;nationality\\\\&amp;quot;:\\\\&amp;quot;NL\\\\&amp;quot;\\\\n                  },\\\\n                  \\\\&amp;quot;phoneNumber\\\\&amp;quot;:{\\\\n                    \\\\&amp;quot;phoneCountryCode\\\\&amp;quot;:\\\\&amp;quot;NL\\\\&amp;quot;,\\\\n                    \\\\&amp;quot;phoneNumber\\\\&amp;quot;:\\\\&amp;quot;4515076\\\\&amp;quot;,\\\\n                    \\\\&amp;quot;phoneType\\\\&amp;quot;:\\\\&amp;quot;Mobile\\\\&amp;quot;\\\\n                  },\\\\n                  \\\\&amp;quot;shareholderCode\\\\&amp;quot;:\\\\&amp;quot;YOUR_SHAREHOLDER_REFERENCE\\\\&amp;quot;\\\\n                }\\\\n              ]\\\\n            }\\\\n          }\\\\n        ]\\\\n      }\\\\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&quot;,&quot;altTitle&quot;:&quot;partnership&quot;,&quot;oldTabId&quot;:&quot;example-partnership_2&quot;,&quot;relation&quot;:&quot;partnership&quot;},{&quot;title&quot;:&quot;Sole proprietorship&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;The following example shows how to update an individual account holder to include details about their sole proprietorship.&lt;\\\/p&gt;\\n&lt;p&gt;In your POST &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/#\\\/Account\\\/updateAccountHolder\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/updateAccountHolder&lt;\\\/a&gt; request, specify:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;The unique  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/createAccountHolder#request-accountHolderCode\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;accountHolderCode&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;The  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/createAccountHolder#request-accountHolderDetails-legalArrangements\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;legalArrangements&lt;\\\/a&gt; array containing:\\n&lt;ul&gt;\\n&lt;li&gt;The  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/createAccountHolder#request-accountHolderDetails-legalArrangements-legalArrangementReference\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;legalArrangementReference&lt;\\\/a&gt;&amp;#58; Your reference for the legal arrangement.&lt;\\\/li&gt;\\n&lt;li&gt;The  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/createAccountHolder#request-accountHolderDetails-legalArrangements-type\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;type&lt;\\\/a&gt;&amp;#58; Set to &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;SoleProprietorship&lt;\\\/strong&gt;&lt;\\\/span&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;The minimum required information you have collected from the account holder, such as the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/createAccountHolder#request-accountHolderDetails-legalArrangements-name\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;name&lt;\\\/a&gt; of their business, the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/createAccountHolder#request-accountHolderDetails-legalArrangements-address-country\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;address&lt;\\\/a&gt;, and the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/createAccountHolder#request-accountHolderDetails-legalArrangements-registrationNumber\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;registrationNumber&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ul&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;Add information for sole proprietor&#039;\\&quot; :id=\\&quot;&#039;&#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:\\\\\\\/\\\\\\\/cal-test.adyen.com\\\\\\\/cal\\\\\\\/services\\\\\\\/Account\\\\\\\/v6\\\\\\\/updateAccountHolder \\\\\\\\\\\\n-H &#039;x-api-key: ADYEN_API_KEY&#039; \\\\\\\\\\\\n-H &#039;content-type: application\\\\\\\/json&#039; \\\\\\\\\\\\n-d &#039;{\\\\n   \\\\&amp;quot;accountHolderCode\\\\&amp;quot;:\\\\&amp;quot;ACCOUNT_HOLDER_CODE\\\\&amp;quot;,\\\\n   \\\\&amp;quot;accountHolderDetails\\\\&amp;quot;:{\\\\n     \\\\&amp;quot;legalArrangements\\\\&amp;quot;:[\\\\n       {\\\\n         \\\\&amp;quot;legalArrangementReference\\\\&amp;quot;:\\\\&amp;quot;YOUR_REFERENCE\\\\&amp;quot;,\\\\n         \\\\&amp;quot;type\\\\&amp;quot;:\\\\&amp;quot;SoleProprietorship\\\\&amp;quot;,\\\\n         \\\\&amp;quot;name\\\\&amp;quot;:\\\\&amp;quot;ABC Business\\\\&amp;quot;,\\\\n         \\\\&amp;quot;address\\\\&amp;quot;:{\\\\n           \\\\&amp;quot;city\\\\&amp;quot;:\\\\&amp;quot;Melbourne\\\\&amp;quot;,\\\\n           \\\\&amp;quot;country\\\\&amp;quot;:\\\\&amp;quot;AU\\\\&amp;quot;,\\\\n           \\\\&amp;quot;houseNumberOrName\\\\&amp;quot;:\\\\&amp;quot;Level 7 - 222\\\\&amp;quot;,\\\\n           \\\\&amp;quot;postalCode\\\\&amp;quot;:\\\\&amp;quot;30000\\\\&amp;quot;,\\\\n           \\\\&amp;quot;stateOrProvince\\\\&amp;quot;:\\\\&amp;quot;VIC\\\\&amp;quot;,\\\\n           \\\\&amp;quot;street\\\\&amp;quot;:\\\\&amp;quot;Exhibition Street\\\\&amp;quot;\\\\n         },\\\\n         \\\\&amp;quot;registrationNumber\\\\&amp;quot;:\\\\&amp;quot;13134A\\\\&amp;quot;\\\\n       }\\\\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&quot;,&quot;altTitle&quot;:&quot;sole-prop&quot;,&quot;oldTabId&quot;:&quot;example-sole-prop_3&quot;,&quot;relation&quot;:&quot;sole-prop&quot;},{&quot;title&quot;:&quot;Trust&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;The following example shows how to update an existing account holder to include information about a trust. In this example, the trust has  two additional members - a business settlor and an individual protector.&lt;\\\/p&gt;\\n&lt;p&gt;In your POST &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/#\\\/Account\\\/updateAccountHolder\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/updateAccountHolder&lt;\\\/a&gt; request, specify:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;The unique  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/createAccountHolder#request-accountHolderCode\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;accountHolderCode&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;The  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/createAccountHolder#request-accountHolderDetails-legalArrangements\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;legalArrangements&lt;\\\/a&gt; array containing:\\n&lt;ul&gt;\\n&lt;li&gt;The  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/createAccountHolder#request-accountHolderDetails-legalArrangements-legalArrangementReference\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;legalArrangementReference&lt;\\\/a&gt;&amp;#58; Your reference for the legal arrangement.&lt;\\\/li&gt;\\n&lt;li&gt;The  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/createAccountHolder#request-accountHolderDetails-legalArrangements-type\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;type&lt;\\\/a&gt;&amp;#58; Set to &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;Trust&lt;\\\/strong&gt;&lt;\\\/span&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;The  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/6\\\/post\\\/updateAccountHolder#request-accountHolderDetails-legalArrangements-legalForm\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;legalForm&lt;\\\/a&gt;. The structure of the trust as defined according to the country&#039;s legislation.&lt;\\\/li&gt;\\n&lt;li&gt;The minimum required information you have collected from the account holder, such as the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/createAccountHolder#request-accountHolderDetails-legalArrangements-name\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;name&lt;\\\/a&gt; of the trust,  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/createAccountHolder#request-accountHolderDetails-legalArrangements-address-country\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;address&lt;\\\/a&gt;, and  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/createAccountHolder#request-accountHolderDetails-legalArrangements-registrationNumber\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;registrationNumber&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;The  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Account\\\/latest\\\/post\\\/updateAccountHolder#request-accountHolderDetails-legalArrangements-legalArrangementEntities\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;legalArrangementEntities&lt;\\\/a&gt;&amp;#58; Contains information about other members of the legal arrangement.&lt;\\\/li&gt;\\n&lt;\\\/ul&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;Add information about a trust&#039;\\&quot; :id=\\&quot;&#039;&#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:\\\\\\\/\\\\\\\/cal-test.adyen.com\\\\\\\/cal\\\\\\\/services\\\\\\\/Account\\\\\\\/v6\\\\\\\/updateAccountHolder \\\\\\\\\\\\n-H &#039;x-api-key: ADYEN_API_KEY&#039; \\\\\\\\\\\\n-H &#039;content-type: application\\\\\\\/json&#039; \\\\\\\\\\\\n-d &#039;{\\\\n  \\\\&amp;quot;accountHolderCode\\\\&amp;quot;:\\\\&amp;quot;ACCOUNT_HOLDER_CODE\\\\&amp;quot;,\\\\n  \\\\&amp;quot;accountHolderDetails\\\\&amp;quot;:{\\\\n    \\\\&amp;quot;legalArrangements\\\\&amp;quot;:[\\\\n      {\\\\n        \\\\&amp;quot;legalArrangementReference\\\\&amp;quot;:\\\\&amp;quot;YOUR_REFERENCE\\\\&amp;quot;,\\\\n        \\\\&amp;quot;legalForm\\\\&amp;quot;:\\\\&amp;quot;CashManagementTrust\\\\&amp;quot;,\\\\n        \\\\&amp;quot;name\\\\&amp;quot;:\\\\&amp;quot;NAME_OF_TRUST\\\\&amp;quot;,\\\\n        \\\\&amp;quot;type\\\\&amp;quot;:\\\\&amp;quot;Trust\\\\&amp;quot;,\\\\n        \\\\&amp;quot;registrationNumber\\\\&amp;quot;:\\\\&amp;quot;13134A\\\\&amp;quot;,\\\\n        \\\\&amp;quot;email\\\\&amp;quot;:\\\\&amp;quot;trustarrangement@example.com\\\\&amp;quot;,\\\\n        \\\\&amp;quot;phoneNumber\\\\&amp;quot;:{\\\\n          \\\\&amp;quot;phoneCountryCode\\\\&amp;quot;:\\\\&amp;quot;AU\\\\&amp;quot;,\\\\n          \\\\&amp;quot;phoneNumber\\\\&amp;quot;:\\\\&amp;quot;0207112304\\\\&amp;quot;,\\\\n          \\\\&amp;quot;phoneType\\\\&amp;quot;:\\\\&amp;quot;Mobile\\\\&amp;quot;\\\\n        },\\\\n        \\\\&amp;quot;address\\\\&amp;quot;:{\\\\n          \\\\&amp;quot;city\\\\&amp;quot;:\\\\&amp;quot;Melbourne\\\\&amp;quot;,\\\\n          \\\\&amp;quot;country\\\\&amp;quot;:\\\\&amp;quot;AU\\\\&amp;quot;,\\\\n          \\\\&amp;quot;houseNumberOrName\\\\&amp;quot;:\\\\&amp;quot;Level 7 - 222\\\\&amp;quot;,\\\\n          \\\\&amp;quot;postalCode\\\\&amp;quot;:\\\\&amp;quot;30000\\\\&amp;quot;,\\\\n          \\\\&amp;quot;stateOrProvince\\\\&amp;quot;:\\\\&amp;quot;VIC\\\\&amp;quot;,\\\\n          \\\\&amp;quot;street\\\\&amp;quot;:\\\\&amp;quot;Trust Legal Arrangement Street\\\\&amp;quot;\\\\n        },\\\\n        \\\\&amp;quot;legalArrangementEntities\\\\&amp;quot;:[\\\\n          {\\\\n            \\\\&amp;quot;legalArrangementEntityReference\\\\&amp;quot;:\\\\&amp;quot;YOUR_ENTITY_REFERENCE\\\\&amp;quot;,\\\\n            \\\\&amp;quot;legalArrangementMembers\\\\&amp;quot;:[\\\\n              \\\\&amp;quot;Settlor\\\\&amp;quot;,\\\\n              \\\\&amp;quot;Protector\\\\&amp;quot;\\\\n            ],\\\\n            \\\\&amp;quot;legalEntityType\\\\&amp;quot;:\\\\&amp;quot;Business\\\\&amp;quot;,\\\\n            \\\\&amp;quot;address\\\\&amp;quot;:{\\\\n              \\\\&amp;quot;city\\\\&amp;quot;:\\\\&amp;quot;Sydney\\\\&amp;quot;,\\\\n              \\\\&amp;quot;country\\\\&amp;quot;:\\\\&amp;quot;AU\\\\&amp;quot;,\\\\n              \\\\&amp;quot;houseNumberOrName\\\\&amp;quot;:\\\\&amp;quot;1\\\\\\\/255\\\\&amp;quot;,\\\\n              \\\\&amp;quot;postalCode\\\\&amp;quot;:\\\\&amp;quot;2010\\\\&amp;quot;,\\\\n              \\\\&amp;quot;stateOrProvince\\\\&amp;quot;:\\\\&amp;quot;NSW\\\\&amp;quot;,\\\\n              \\\\&amp;quot;street\\\\&amp;quot;:\\\\&amp;quot;Settlor street\\\\&amp;quot;\\\\n            },\\\\n            \\\\&amp;quot;businessDetails\\\\&amp;quot;:{\\\\n              \\\\&amp;quot;legalBusinessName\\\\&amp;quot;:\\\\&amp;quot;NAME_OF_SETTLOR_BUSINESS\\\\&amp;quot;,\\\\n              \\\\&amp;quot;shareholders\\\\&amp;quot;:[\\\\n                {\\\\n                  \\\\&amp;quot;address\\\\&amp;quot;:{\\\\n                    \\\\&amp;quot;city\\\\&amp;quot;:\\\\&amp;quot;Sydney\\\\&amp;quot;,\\\\n                    \\\\&amp;quot;country\\\\&amp;quot;:\\\\&amp;quot;AU\\\\&amp;quot;,\\\\n                    \\\\&amp;quot;houseNumberOrName\\\\&amp;quot;:\\\\&amp;quot;50\\\\&amp;quot;,\\\\n                    \\\\&amp;quot;postalCode\\\\&amp;quot;:\\\\&amp;quot;2010\\\\&amp;quot;,\\\\n                    \\\\&amp;quot;stateOrProvince\\\\&amp;quot;:\\\\&amp;quot;NSW\\\\&amp;quot;,\\\\n                    \\\\&amp;quot;street\\\\&amp;quot;:\\\\&amp;quot;Settlor shareholder street\\\\&amp;quot;\\\\n                  },\\\\n                  \\\\&amp;quot;email\\\\&amp;quot;:\\\\&amp;quot;shareholder@example.com\\\\&amp;quot;,\\\\n                  \\\\&amp;quot;name\\\\&amp;quot;:{\\\\n                    \\\\&amp;quot;firstName\\\\&amp;quot;:\\\\&amp;quot;John\\\\&amp;quot;,\\\\n                    \\\\&amp;quot;lastName\\\\&amp;quot;:\\\\&amp;quot;Smith\\\\&amp;quot;\\\\n                  },\\\\n                  \\\\&amp;quot;personalData\\\\&amp;quot;:{\\\\n                    \\\\&amp;quot;dateOfBirth\\\\&amp;quot;:\\\\&amp;quot;1970-01-01\\\\&amp;quot;,\\\\n                    \\\\&amp;quot;documentData\\\\&amp;quot;:[\\\\n                      {\\\\n                        \\\\&amp;quot;number\\\\&amp;quot;:\\\\&amp;quot;1994787577\\\\&amp;quot;,\\\\n                        \\\\&amp;quot;type\\\\&amp;quot;:\\\\&amp;quot;ID\\\\&amp;quot;\\\\n                      }\\\\n                    ],\\\\n                    \\\\&amp;quot;nationality\\\\&amp;quot;:\\\\&amp;quot;NL\\\\&amp;quot;\\\\n                  },\\\\n                  \\\\&amp;quot;phoneNumber\\\\&amp;quot;:{\\\\n                    \\\\&amp;quot;phoneCountryCode\\\\&amp;quot;:\\\\&amp;quot;NL\\\\&amp;quot;,\\\\n                    \\\\&amp;quot;phoneNumber\\\\&amp;quot;:\\\\&amp;quot;4515076\\\\&amp;quot;,\\\\n                    \\\\&amp;quot;phoneType\\\\&amp;quot;:\\\\&amp;quot;Mobile\\\\&amp;quot;\\\\n                  },\\\\n                  \\\\&amp;quot;shareholderCode\\\\&amp;quot;:\\\\&amp;quot;YOUR_SHAREHOLDER_REFERENCE\\\\&amp;quot;\\\\n                }\\\\n              ]\\\\n            }\\\\n          },\\\\n          {\\\\n            \\\\&amp;quot;legalArrangementEntityReference\\\\&amp;quot;:\\\\&amp;quot;YOUR_ENTITY_REFERENCE_2\\\\&amp;quot;,\\\\n            \\\\&amp;quot;legalArrangementMembers\\\\&amp;quot;:[\\\\n              \\\\&amp;quot;Trustee\\\\&amp;quot;\\\\n            ],\\\\n            \\\\&amp;quot;legalEntityType\\\\&amp;quot;:\\\\&amp;quot;Individual\\\\&amp;quot;,\\\\n            \\\\&amp;quot;phoneNumber\\\\&amp;quot;:{\\\\n              \\\\&amp;quot;phoneCountryCode\\\\&amp;quot;:\\\\&amp;quot;NL\\\\&amp;quot;,\\\\n              \\\\&amp;quot;phoneNumber\\\\&amp;quot;:\\\\&amp;quot;0207112311\\\\&amp;quot;,\\\\n              \\\\&amp;quot;phoneType\\\\&amp;quot;:\\\\&amp;quot;Mobile\\\\&amp;quot;\\\\n            },\\\\n            \\\\&amp;quot;address\\\\&amp;quot;:{\\\\n              \\\\&amp;quot;city\\\\&amp;quot;:\\\\&amp;quot;Sydney\\\\&amp;quot;,\\\\n              \\\\&amp;quot;country\\\\&amp;quot;:\\\\&amp;quot;AU\\\\&amp;quot;,\\\\n              \\\\&amp;quot;houseNumberOrName\\\\&amp;quot;:\\\\&amp;quot;60\\\\&amp;quot;,\\\\n              \\\\&amp;quot;postalCode\\\\&amp;quot;:\\\\&amp;quot;85058\\\\&amp;quot;,\\\\n              \\\\&amp;quot;stateOrProvince\\\\&amp;quot;:\\\\&amp;quot;NSW\\\\&amp;quot;,\\\\n              \\\\&amp;quot;street\\\\&amp;quot;:\\\\&amp;quot;Protector Street\\\\&amp;quot;\\\\n            },\\\\n            \\\\&amp;quot;email\\\\&amp;quot;:\\\\&amp;quot;entity_002@example.com\\\\&amp;quot;,\\\\n            \\\\&amp;quot;individualDetails\\\\&amp;quot;:{\\\\n              \\\\&amp;quot;name\\\\&amp;quot;:{\\\\n                \\\\&amp;quot;firstName\\\\&amp;quot;:\\\\&amp;quot;Jane\\\\&amp;quot;,\\\\n                \\\\&amp;quot;lastName\\\\&amp;quot;:\\\\&amp;quot;Hopper\\\\&amp;quot;\\\\n              },\\\\n              \\\\&amp;quot;personalData\\\\&amp;quot;:{\\\\n                \\\\&amp;quot;dateOfBirth\\\\&amp;quot;:\\\\&amp;quot;1970-01-01\\\\&amp;quot;,\\\\n                \\\\&amp;quot;documentData\\\\&amp;quot;:[\\\\n                  {\\\\n                    \\\\&amp;quot;number\\\\&amp;quot;:\\\\&amp;quot;2001185217\\\\&amp;quot;,\\\\n                    \\\\&amp;quot;type\\\\&amp;quot;:\\\\&amp;quot;ID\\\\&amp;quot;\\\\n                  }\\\\n                ],\\\\n                \\\\&amp;quot;nationality\\\\&amp;quot;:\\\\&amp;quot;NL\\\\&amp;quot;\\\\n              }\\\\n            }\\\\n          }\\\\n        ]\\\\n      }\\\\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&quot;,&quot;altTitle&quot;:&quot;trust&quot;,&quot;oldTabId&quot;:&quot;example-trust_4&quot;,&quot;relation&quot;:&quot;trust&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<p>Requests using <a href=\"https:\/\/docs.adyen.com\/api-explorer\/#\/Account\/updateAccountHolder\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/updateAccountHolder<\/a> are processed asynchronously. You'll receive a response to your API request, but you must rely on notification webhooks  to know the final result of a request.<\/p>\n<ul>\n<li>The  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Notification\/latest\/post\/ACCOUNT_HOLDER_CREATED\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">ACCOUNT_HOLDER_CREATED<\/a> or  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Notification\/latest\/post\/ACCOUNT_HOLDER_UPDATED\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">ACCOUNT_HOLDER_UPDATED<\/a> webhook: Informs you when the account holder has been successfully updated. You'll get the status of the checks in the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Notification\/latest\/post\/ACCOUNT_HOLDER_CREATED#request-content-verification\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">verification<\/a> object under the <code>legalArrangements<\/code> and <code>legalArrangementsEntities<\/code> arrays.<\/li>\n<li> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Notification\/latest\/post\/ACCOUNT_HOLDER_VERIFICATION\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">ACCOUNT_HOLDER_VERIFICATION<\/a>&#58; Informs you of the status of the verification checks. For legal arrangement checks, refer to the <code>kyCheckStatusData<\/code> object with the <code>type<\/code> <span translate=\"no\"><strong>LEGAL_ARRANGEMENT_VERIFICATION<\/strong><\/span>.<\/li>\n<\/ul>\n<p>The API response and the webhooks contain the Adyen-generated <code>legalArrangementCode<\/code> and <code>legalArrangementEntityCode<\/code> which you'll use to update the entries or upload documents.<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Example ACCOUNT_HOLDER_VERIFICATION notification for legal arrangements'\" :id=\"'legal-arrangement-webhook'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n  \\\"eventDate\\\": \\\"2019-01-01T01:00:00+01:00\\\",\\n  \\\"eventType\\\": \\\"ACCOUNT_HOLDER_VERIFICATION\\\",\\n  \\\"executingUserKey\\\": \\\"executing-user-key\\\",\\n  \\\"live\\\": false,\\n  \\\"pspReference\\\": \\\"TSTPSPR0001\\\",\\n  \\\"content\\\": {\\n    \\\"accountHolderCode\\\": \\\"ACCOUNT_HOLDER_CODE\\\",\\n    \\\"payoutMethodCode\\\": \\\"00000000-0000-0000-0000-000000000000\\\",\\n    \\\"kycCheckStatusData\\\": {\\n      \\\"type\\\": \\\"LEGAL_ARRANGEMENT_VERIFICATION\\\",\\n      \\\"status\\\": \\\"PENDING\\\",\\n      \\\"summary\\\": {\\n        \\\"kycCheckCode\\\": 100,\\n        \\\"kycCheckDescription\\\": \\\"Verification check summary description\\\"\\n      },\\n      \\\"requiredFields\\\": [\\n        \\\"field.missing\\\"\\n      ]\\n    },\\n    \\\"shareholderCode\\\": \\\"SH00000001\\\",\\n    \\\"legalArrangementEntityCode\\\": \\\"ADYEN-UUID-LAEC-1234-5678\\\",\\n    \\\"legalArrangementCode\\\": \\\"ADYEN-UUID-LA-1234-5678\\\"\\n  }\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<h2 id=\"upload-a-document-for-the-legal-arrangement\">Step 3: Upload a document<\/h2>\n<p>You only need to upload a document if:<\/p>\n<ul>\n<li>The account holder is part of a trust in Australia.<\/li>\n<li>The automatic verification failed and Adyen required the account holder to provide a document.<\/li>\n<\/ul>\n<p>The document must prove the account holder's contractual agreement such as a registration or a constitutional document.<\/p>\n<p>To upload a document, make a POST <a href=\"https:\/\/docs.adyen.com\/api-explorer\/#\/Account\/uploadDocument\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/uploadDocument<\/a> request specifying:<\/p>\n<ul>\n<li> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Account\/latest\/post\/uploadDocument#request-documentDetail-documentType\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">documentType<\/a> set to <span translate=\"no\"><strong>CONSTITUTIONAL_DOCUMENT<\/strong><\/span>.<\/li>\n<li>The <code>legalArrangementCode<\/code> to which the document must be linked.<\/li>\n<li>The <code>documentContent<\/code> containing the document in Base64-encoded format.<\/li>\n<\/ul>\n<p>In case Adyen is unable to verify the identity of the other members of the legal arrangement, then you'll also be required to upload documents for the member identified by the <code>legalArrangementEntityCode<\/code>.<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Upload a constitutional document'\" :id=\"'upload-doc'\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/cal-test.adyen.com\\\/cal\\\/services\\\/Account\\\/v6\\\/uploadDocument \\\\\\n-H 'x-api-key: ADYEN_API_KEY' \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-d '{\\n     \\&quot;documentContent\\&quot;:\\&quot;dGVzdCBkb2N1bWVudCBjb250ZW50...VcdCB=\\&quot;,\\n     \\&quot;documentDetail\\&quot;:{\\n      \\&quot;accountHolderCode\\&quot;:\\&quot;ACCOUNT_HOLDER_CODE\\&quot;,\\n      \\&quot;documentType\\&quot;:\\&quot;CONSTITUTIONAL_DOCUMENT\\&quot;,\\n      \\&quot;filename\\&quot;: \\&quot;constitutionalDocument.pdf\\&quot;\\n     }\\n   }'&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<p>Requests using <a href=\"https:\/\/docs.adyen.com\/api-explorer\/#\/Account\/uploadDocument\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/uploadDocument<\/a> are processed asynchronously. You'll receive a response to your API request, but you must rely on notification webhooks  to know the final result of a request.<\/p>\n<ul>\n<li> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Notification\/latest\/post\/ACCOUNT_HOLDER_VERIFICATION\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">ACCOUNT_HOLDER_VERIFICATION<\/a>&#58; Informs you of the status of the verification checks. For legal arrangement checks, refer to the <code>kyCheckStatusData<\/code> object with the <code>type<\/code> <span translate=\"no\"><strong>LEGAL_ARRANGEMENT_VERIFICATION<\/strong><\/span>.<\/li>\n<\/ul>\n<h2 id=\"see-also\">See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/classic-platforms\/verification-process\"\n                        target=\"_self\"\n                        >\n                    Verification process\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/classic-platforms\/verification-process\/legal-arrangements","articleFields":{"description":"Include information about an account holder's legal arrangements.","search_category":"Classic Platforms","feedback_component":true,"id":"36193558","type":"page","operations":"","status":"current","last_edit_on":"27-07-2021 18:50","parameters":{"directoryPath":"\/classic-platforms"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/classic-platforms\/verification-process\/legal-arrangements","title":"Legal arrangements check","content":"\nThis page is for classic Adyen for Platforms integrations. If you are just starting your implementation, refer to our new integration guide instead.\n\nAccount holders that conduct business with Adyen on behalf of another entity as established in a contractual agreement must also provide information about their agreement. We refer to contractual agreements as legal arrangements.\nSome examples of legal arrangements are:\n\nInvolvement in a trust. For example, a business is a corporate trustee and is conducting business on behalf of the trust.\nSole proprietorship. An individual is registered as a sole proprietor in the country they are operating in.\n\nYou can onboard account holders with legal arrangements through:\n\nHosted onboarding: HOP supports collecting requirements by default.\nYour own onboarding flow: Follow the steps on this page to collect documents and additional information in your UI and then send the information to Adyen. This requires API version 6.\n\nThe information that account holders provide will be part of the verification checks. Failing to declare legal arrangements can result in blocked payouts and account suspensions.\nTypes of legal arrangements\nAccount holders in your platform must provide additional information if they are part of the following legal arrangements.\n\n\nAssociation\nThe account holder, along with one or more associates, manages and shares profits of the business in accordance with agreed upon articles of association.\n\n\nPartnership\nThe account holder, along with one or more legal entities (partners), manage, operate and share profits of their jointly-owned business. The account holder is wholly or partially liable for the debts of the partnership.\n\n\nSole proprietorship\nThe individual is registered as a sole proprietor, operates the business on their own, and is personally liable for the debts of the sole proprietorship.\n\n\nTrust\nThe account holder (as the trustee) holds and manages assets for the beneficiaries in an agreement laid out in the trust deed.\n\n\nSupported legal arrangements\nAdyen supports different legal arrangements for account holders operating in the following countries.\n\nAssociation: Both the account holder and the association must be operating and established in the US.\nPartnership: Australia, Singapore\nSole proprietorship: Singapore\nTrust: Australia, Singapore\n\nExcept for associations, the country where the legal arrangement was established can be different from the account holder's country of operation.\nStep 1: Collect the required information\nAccount holders that are part of a legal arrangement must provide the following additional information.\n\n\n    \n        \n        \n    \n\n\nAdyen uses the information to run automatic verification checks on the legal arrangement and other parties involved. For example, in a partnership where the other partner is a private company, Adyen performs a company check. If the checks fail, Adyen might require the account holder to provide a document that proves the legal arrangement.\nStep 2: Update the account holder\nUpdate an existing account holder and send the information that you received from them in the  legalArrangements array.\n\n\n    \n        \n        \n    \n\n\nRequests using \/updateAccountHolder are processed asynchronously. You'll receive a response to your API request, but you must rely on notification webhooks  to know the final result of a request.\n\nThe  ACCOUNT_HOLDER_CREATED or  ACCOUNT_HOLDER_UPDATED webhook: Informs you when the account holder has been successfully updated. You'll get the status of the checks in the  verification object under the legalArrangements and legalArrangementsEntities arrays.\n ACCOUNT_HOLDER_VERIFICATION&#58; Informs you of the status of the verification checks. For legal arrangement checks, refer to the kyCheckStatusData object with the type LEGAL_ARRANGEMENT_VERIFICATION.\n\nThe API response and the webhooks contain the Adyen-generated legalArrangementCode and legalArrangementEntityCode which you'll use to update the entries or upload documents.\n\n    \n\nStep 3: Upload a document\nYou only need to upload a document if:\n\nThe account holder is part of a trust in Australia.\nThe automatic verification failed and Adyen required the account holder to provide a document.\n\nThe document must prove the account holder's contractual agreement such as a registration or a constitutional document.\nTo upload a document, make a POST \/uploadDocument request specifying:\n\n documentType set to CONSTITUTIONAL_DOCUMENT.\nThe legalArrangementCode to which the document must be linked.\nThe documentContent containing the document in Base64-encoded format.\n\nIn case Adyen is unable to verify the identity of the other members of the legal arrangement, then you'll also be required to upload documents for the member identified by the legalArrangementEntityCode.\n\n    \n\nRequests using \/uploadDocument are processed asynchronously. You'll receive a response to your API request, but you must rely on notification webhooks  to know the final result of a request.\n\n ACCOUNT_HOLDER_VERIFICATION&#58; Informs you of the status of the verification checks. For legal arrangement checks, refer to the kyCheckStatusData object with the type LEGAL_ARRANGEMENT_VERIFICATION.\n\nSee also\n\n\n                    Verification process\n                \n","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Classic integration","lvl2":"Verification process","lvl3":"Legal arrangements check"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/classic-platforms","lvl2":"https:\/\/docs.adyen.com\/pt\/classic-platforms\/verification-process","lvl3":"\/pt\/classic-platforms\/verification-process\/legal-arrangements"},"levels":4,"category":"Classic Platforms","category_color":"green","tags":["Legal","arrangements","check"]}}