{"title":"Changing the legal entity type","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 sometimes sign up with the incorrect legal entity type. To fix this, change the legal entity type with an <a href=\"https:\/\/docs.adyen.com\/api-explorer\/#\/Account\/updateAccountHolder\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/updateAccountHolder<\/a> request.<\/p>\n<p>When you change the legal entity type, the account holder retains the <code>accountHolderCode<\/code>, <code>accountCode<\/code> and the transaction history.<\/p>\n<p>To change the legal entity type, you can:<\/p>\n<ul>\n<li><a href=\"#migrate-existing\">Migrate existing details<\/a>, including the verification checks.<\/li>\n<li>Or <a href=\"#provide-new-details\">provide new details<\/a>.<\/li>\n<\/ul>\n<div class=\"sc-notice info\"><div>\n<p>This feature is supported from <strong>v5 and later<\/strong> of the <a href=\"https:\/\/docs.adyen.com\/api-explorer\/#\/Account\/updateAccountHolder\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/updateAccountHolder<\/a> endpoint.<\/p>\n<\/div><\/div>\n<h2 id=\"migrate-existing\">Migrating existing details<\/h2>\n<p>If you choose to migrate existing details, we also migrate the identity check status and the passport verification from the previous legal entity to the new one. We will perform the bank account verification again if required for the new legal entity.<\/p>\n<p>After we complete the update, you get the  <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> notification, containing the migrated and new verification check statuses or requirements.<\/p>\n<h3>Changing from Individual to Business<\/h3>\n<p>To change from <span translate=\"no\"><strong>Individual<\/strong><\/span> to <span translate=\"no\"><strong>Business<\/strong><\/span>, make an <a href=\"https:\/\/docs.adyen.com\/api-explorer\/#\/Account\/updateAccountHolder\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/updateAccountHolder<\/a> request and provide the following parameters:<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Update legal entity to business'\" :id=\"''\" :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\\\/updateAccountHolder \\\\\\n-H 'x-api-key: ADYEN_API_KEY' \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-d '{\\n  \\&quot;accountHolderCode\\&quot;: \\&quot;YOUR_UNIQUE_ACCOUNT_HOLDER_CODE\\&quot;,\\n  \\&quot;accountHolderDetails\\&quot;: {\\n    \\&quot;businessDetails\\&quot;:{\\n      \\&quot;legalBusinessName\\&quot;: \\&quot;ACCOUNT_HOLDER_BUSINESS_NAME\\&quot;,\\n      \\&quot;registrationNumber\\&quot;: \\&quot;123456789\\&quot;\\n    }\\n  },\\n  \\&quot;legalEntity\\&quot;: \\&quot;Business\\&quot;\\n}'&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<h3>Changing from Business to Individual<\/h3>\n<div class=\"sc-notice note\"><div>\n<p>You can only migrate data if the business account holder has only one shareholder. If the account holder has multiple shareholders, the request is rejected.<\/p>\n<\/div><\/div>\n<p>To change from <span translate=\"no\"><strong>Business<\/strong><\/span> to <span translate=\"no\"><strong>Individual<\/strong><\/span>, make an <code>\/updateAccountHolder<\/code> request and provide the following fields:<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Update legal entity to individual'\" :id=\"''\" :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\\\/updateAccountHolder \\\\\\n-H 'x-api-key: ADYEN_API_KEY' \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-d '{\\n  \\&quot;accountHolderCode\\&quot;: \\&quot;YOUR_UNIQUE_ACCOUNT_HOLDER_CODE\\&quot;,\\n  \\&quot;legalEntity\\&quot;: \\&quot;Individual\\&quot;\\n}'&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<h2 id=\"provide-new-details\">Providing new details<\/h2>\n<p>Alternatively, you can provide new details when changing the legal entity of an account holder.<\/p>\n<p>After we complete the update, you get the  <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> notification, containing new verification check statuses or requirements.<\/p>\n<h3>Changing from Individual to Business<\/h3>\n<p>To change from <span translate=\"no\"><strong>Individual<\/strong><\/span> to <span translate=\"no\"><strong>Business<\/strong><\/span>, make an <code>\/updateAccountHolder<\/code> request and provide the following parameters:<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Update to business and provide new details'\" :id=\"''\" :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\\\/updateAccountHolder \\\\\\n-H 'x-api-key: ADYEN_API_KEY' \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-d '{\\n   \\&quot;accountHolderCode\\&quot; : \\&quot;YOUR_UNIQUE_ACCOUNT_HOLDER_CODE\\&quot;,\\n   \\&quot;legalEntity\\&quot;: \\&quot;Business\\&quot;,\\n   \\&quot;accountHolderDetails\\&quot;:{\\n     \\&quot;businessDetails\\&quot;: {\\n       \\&quot;legalBusinessName\\&quot;: \\&quot;ACCOUNT_HOLDER_BUSINESS_NAME\\&quot;,\\n       \\&quot;registrationNumber\\&quot;: \\&quot;RegNumber12712\\&quot;,\\n       \\&quot;shareholders\\&quot;: [\\n         {\\n           \\&quot;address\\&quot;: {\\n             \\&quot;city\\&quot;: \\&quot;San Francisco\\&quot;,\\n             \\&quot;country\\&quot;: \\&quot;US\\&quot;,\\n             \\&quot;houseNumberOrName\\&quot;: \\&quot;9\\&quot;,\\n             \\&quot;postalCode\\&quot;: \\&quot;10621\\&quot;,\\n             \\&quot;stateOrProvince\\&quot;: \\&quot;CA\\&quot;,\\n             \\&quot;street\\&quot;: \\&quot;AwesomeStreet\\&quot;\\n           },\\n           \\&quot;email\\&quot;: \\&quot;test@email.com\\&quot;,\\n           \\&quot;name\\&quot;: {\\n             \\&quot;firstName\\&quot;: \\&quot;Simon\\&quot;,\\n             \\&quot;gender\\&quot;: \\&quot;UNKNOWN\\&quot;,\\n             \\&quot;lastName\\&quot;: \\&quot;Hopper\\&quot;\\n           },\\n           \\&quot;personalData\\&quot;: {\\n             \\&quot;dateOfBirth\\&quot;: \\&quot;1990-09-30\\&quot;,\\n             \\&quot;documentData\\&quot;: [\\n                {\\n                  \\&quot;number\\&quot;: \\&quot;fa141fa2\\&quot;,\\n                  \\&quot;type\\&quot;: \\&quot;ID\\&quot;\\n                }\\n             ]\\n           }\\n         }\\n      ]\\n    }\\n  }\\n}'&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<h3>Changing from Business to Individual<\/h3>\n<p>To change from <span translate=\"no\"><strong>Business<\/strong><\/span> to <span translate=\"no\"><strong>Individual<\/strong><\/span>, make an <code>\/updateAccountHolder<\/code> request and provide the following parameters:<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Update to individual and provide new details'\" :id=\"''\" :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\\\/updateAccountHolder \\\\\\n-H 'x-api-key: ADYEN_API_KEY' \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-d '{\\n   \\&quot;accountHolderCode\\&quot; : \\&quot;YOUR_UNIQUE_ACCOUNT_HOLDER_CODE\\&quot;,\\n   \\&quot;legalEntity\\&quot;: \\&quot;Individual\\&quot;,\\n   \\&quot;accountHolderDetails\\&quot;:{\\n     \\&quot;individualDetails\\&quot;: {\\n       \\&quot;name\\&quot;: {\\n         \\&quot;firstName\\&quot;: \\&quot;Simon\\&quot;,\\n         \\&quot;gender\\&quot;: \\&quot;UNKNOWN\\&quot;,\\n         \\&quot;lastName\\&quot;: \\&quot;Hopper\\&quot;\\n       },\\n       \\&quot;personalData\\&quot;: {\\n         \\&quot;dateOfBirth\\&quot;: \\&quot;1990-09-30\\&quot;,\\n         \\&quot;documentData\\&quot;: [\\n           {\\n             \\&quot;number\\&quot;: \\&quot;IdNumber42382\\&quot;,\\n             \\&quot;type\\&quot;: \\&quot;ID\\&quot;\\n           }\\n         ]\\n       }\\n     }\\n   }\\n }'&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>","url":"https:\/\/docs.adyen.com\/pt\/classic-platforms\/account-holders-and-accounts\/change-legal-entity","articleFields":{"description":"Modify the account holder's legal entity type to onboard them with the correct verification process.","search_category":"Classic Platforms","last_edit_on":"01-09-2020 12:27","parameters":{"directoryPath":"\/classic-platforms"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/classic-platforms\/account-holders-and-accounts\/change-legal-entity","title":"Changing the legal entity type","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 sometimes sign up with the incorrect legal entity type. To fix this, change the legal entity type with an \/updateAccountHolder request.\nWhen you change the legal entity type, the account holder retains the accountHolderCode, accountCode and the transaction history.\nTo change the legal entity type, you can:\n\nMigrate existing details, including the verification checks.\nOr provide new details.\n\n\nThis feature is supported from v5 and later of the \/updateAccountHolder endpoint.\n\nMigrating existing details\nIf you choose to migrate existing details, we also migrate the identity check status and the passport verification from the previous legal entity to the new one. We will perform the bank account verification again if required for the new legal entity.\nAfter we complete the update, you get the  ACCOUNT_HOLDER_VERIFICATION notification, containing the migrated and new verification check statuses or requirements.\nChanging from Individual to Business\nTo change from Individual to Business, make an \/updateAccountHolder request and provide the following parameters:\n\n    \n\nChanging from Business to Individual\n\nYou can only migrate data if the business account holder has only one shareholder. If the account holder has multiple shareholders, the request is rejected.\n\nTo change from Business to Individual, make an \/updateAccountHolder request and provide the following fields:\n\n    \n\nProviding new details\nAlternatively, you can provide new details when changing the legal entity of an account holder.\nAfter we complete the update, you get the  ACCOUNT_HOLDER_VERIFICATION notification, containing new verification check statuses or requirements.\nChanging from Individual to Business\nTo change from Individual to Business, make an \/updateAccountHolder request and provide the following parameters:\n\n    \n\nChanging from Business to Individual\nTo change from Business to Individual, make an \/updateAccountHolder request and provide the following parameters:\n\n    \n","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Classic integration","lvl2":"Account holders and accounts","lvl3":"Changing the legal entity type"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/classic-platforms","lvl2":"https:\/\/docs.adyen.com\/pt\/classic-platforms\/account-holders-and-accounts","lvl3":"\/pt\/classic-platforms\/account-holders-and-accounts\/change-legal-entity"},"levels":4,"category":"Classic Platforms","category_color":"green","tags":["Changing","legal","entity"]}}