{"title":"Onboarding v4","category":"default","creationDate":1739181240,"content":"<p>This page provides an overview of the changes in onboarding v4. For more information about onboarding versioning, see <a href=\"\/pt\/platforms\/onboard-users\/onboarding-versions#onboard-versions\">here<\/a>.<\/p>\n<div class=\"notices green\">\n<p>To see the difference between Legal Entity Management API versions, use the <a href=\"https:\/\/docs.adyen.com\/api-explorer\/api-diff-tool\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">API Diff Tool<\/a>.<\/p>\n<\/div>\n<ul>\n<li><a href=\"#po-box\">Limitations on using PO box as address<\/a><\/li>\n<li><a href=\"#lem-improvements\">Improvements for LEM API<\/a><\/li>\n<li><a href=\"#id-validation\">Improved validation for ID document uploads<\/a><\/li>\n<li><a href=\"#validations\">New validations on fields<\/a><\/li>\n<li><a href=\"#underage-users\">Onboarding underage users<\/a><\/li>\n<li><a href=\"#unincorporated-partnerships\">Onboarding unincorporated partnerships<\/a><\/li>\n<li><a href=\"#registration-number\">Providing registration number before first payment<\/a><\/li>\n<li><a href=\"#doing-business-as\">Requirement for doing business as name<\/a><\/li>\n<li><a href=\"#principal-place\">Requirement for principal place of business<\/a><\/li>\n<li><a href=\"#countries-regions\">Requirements for specific countries\/regions<\/a><\/li>\n<li><a href=\"#support-contact\">Support phone number and phone from users<\/a><\/li>\n<li><a href=\"#hosted-onboarding\">Updates for hosted onboarding<\/a><\/li>\n<\/ul>\n<h3>Changes in v4 for financial products<\/h3>\n<ul>\n<li><a href=\"#business-lines\">Requirement for business lines and industry codes for issuing<\/a><\/li>\n<li><a href=\"#source-funds\">Source of funds for issuing and business accounts<\/a><\/li>\n<\/ul>\n<h2 id=\"po-box\">Limitations on using a PO Box as an address<\/h2>\n<ul>\n<li>\n<p>An individual user cannot use a PO box as their residential address.<\/p>\n<\/li>\n<li>\n<p>An organization can use a PO box as their registered address. However, they must also provide an alternative address for their principal place of business. The address for the principal place of business cannot be a PO box.<\/p>\n<\/li>\n<\/ul>\n<p>You can <a href=\"\/pt\/platforms\/test-verification-errors\/\">test your error handling flow<\/a> for the new verification error messages.<\/p>\n<table>\n<thead>\n<tr>\n<th>Error Code<\/th>\n<th>Error Message<\/th>\n<th>Sub Error Code<\/th>\n<th>Sub error Message<\/th>\n<th>Remediating action Code<\/th>\n<th>Remediating action<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>1_50<\/td>\n<td>Organization details couldn't be verified<\/td>\n<td>1_5093<\/td>\n<td>The business address details couldn\u2019t be verified<\/td>\n<td>1_524<\/td>\n<td>Make sure the registered business address is correct, and that the principal place of business address is a physical, non-PO box address<\/td>\n<\/tr>\n<tr>\n<td><\/td>\n<td><\/td>\n<td>1_5094<\/td>\n<td>The principal place of business was missing<\/td>\n<td>1_525<\/td>\n<td>Add the physical address of the principal place of business<\/td>\n<\/tr>\n<tr>\n<td>1_30<\/td>\n<td>Individual details couldn't be verified<\/td>\n<td>1_3085<\/td>\n<td>The residential address is a P.O. Box<\/td>\n<td>1_321<\/td>\n<td>Update the residential address<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"lem-improvements\">Improvements for Legal Entity Management API<\/h2>\n<p>When you delete a document by making a DELETE  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/4\/delete\/documents\/(id)\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/documents\/{id}<\/a> request, it now returns a <a href=\"\/pt\/errors\/not-found\/#00_404\">404 response<\/a>.<\/p>\n<h2 id=\"id-validation\">Improved validation for ID document uploads<\/h2>\n<p>We added a validation error when a low-quality ID document, such as a passport or driver's license, is uploaded by making a POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/4\/post\/documents\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/documents<\/a>. This allows you to quickly see if an improved document needs to be uploaded to pass verification checks.<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'API response when a low-quality ID document is uploaded'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n   \\\"type\\\":\\\"https:\\\/\\\/docs.adyen.com\\\/errors\\\/validation\\\",\\n   \\\"title\\\":\\\"The request is missing required fields or contains invalid data.\\\",\\n   \\\"status\\\":422,\\n   \\\"detail\\\":\\\"Invalid legal entity information provided\\\",\\n   \\\"requestId\\\":\\\"NO_PSP_REF_1738250600995123\\\",\\n   \\\"invalidFields\\\":[\\n      {\\n         \\\"name\\\":\\\"document.attachment.attachment.content\\\",\\n         \\\"value\\\":\\\"Content quality could not be validated\\\",\\n         \\\"message\\\":\\\"There was a validation error on this request{\\\\\\\"detect_cutoff\\\\\\\":[\\\\\\\"cutoff document in image\\\\\\\"]}\\\"\\n      }\\n   ],\\n   \\\"errorCode\\\":\\\"30_102\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<h2 id=\"validations\">New validations on fields<\/h2>\n<p>To meet compliance requirements, we have added validations to specific fields for legal entities and legal arrangements. These validations are applicable for both <a href=\"\/pt\/platforms\/onboard-users#hosted-onboarding\">hosted onboarding<\/a> and <a href=\"\/pt\/platforms\/onboard-users#api-only-onboarding\">API-only onboarding<\/a>.<\/p>\n\n<div id=\"tab7njbI\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Names&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;The &lt;code&gt;name&lt;\\\/code&gt; field refers to the following:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;&lt;code&gt;individual.name&lt;\\\/code&gt; object including:\\n&lt;ul&gt;\\n&lt;li&gt;&lt;code&gt;individual.name.firstName&lt;\\\/code&gt;&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;individual.name.infix&lt;\\\/code&gt;&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;individual.name.lastName&lt;\\\/code&gt;&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;organization.legalName&lt;\\\/code&gt;&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;soleProprietorship.name&lt;\\\/code&gt;&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;trust.name&lt;\\\/code&gt;&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;unincorporatedPartnership.name&lt;\\\/code&gt;&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;The name field for all entity types cannot contain:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;An emoji&lt;\\\/li&gt;\\n&lt;li&gt;Only one repeated character. For example, &lt;em&gt;zzzzz&lt;\\\/em&gt;&lt;\\\/li&gt;\\n&lt;li&gt;Only symbols. For example, &lt;em&gt;&amp;amp;&amp;amp;&amp;amp;&amp;amp;&lt;\\\/em&gt;&lt;\\\/li&gt;\\n&lt;li&gt;Only numbers. For example, &lt;em&gt;123456&lt;\\\/em&gt;&lt;\\\/li&gt;\\n&lt;li&gt;Only spaces&lt;\\\/li&gt;\\n&lt;li&gt;A fictitious name. For example, \\&quot;John Doe\\&quot;&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;The name field for individuals and other entity types must contain:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;A minimum of three characters across all of the fields. For example, an individual with &lt;code&gt;firstName&lt;\\\/code&gt; N and &lt;code&gt;lastName&lt;\\\/code&gt; Ha.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;The name field for other entity types must contain:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;Only allowed special characters. These are &lt;code&gt;,&lt;\\\/code&gt;, &lt;code&gt;-&lt;\\\/code&gt;, &lt;code&gt;\\u2014&lt;\\\/code&gt;, &lt;code&gt;.&lt;\\\/code&gt;,&lt;code&gt;;&lt;\\\/code&gt;,&lt;code&gt;:&lt;\\\/code&gt;,&lt;code&gt;&amp;amp;&lt;\\\/code&gt;,&lt;code&gt;?&lt;\\\/code&gt;,&lt;code&gt;@&lt;\\\/code&gt;,&lt;code&gt;(&lt;\\\/code&gt;,&lt;code&gt;)&lt;\\\/code&gt;,&lt;code&gt;\\&quot;&lt;\\\/code&gt;,&lt;code&gt;&#039;&lt;\\\/code&gt;,&lt;code&gt;!&lt;\\\/code&gt;,&lt;code&gt;\\\\&lt;\\\/code&gt;,&lt;code&gt;+&lt;\\\/code&gt;, and &lt;code&gt;\\\/&lt;\\\/code&gt;. Accents and non-latin scripts are allowed.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;The name field for individuals must contain:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;Only allowed special characters. These are &lt;code&gt;-&lt;\\\/code&gt;, &lt;code&gt;\\u2014&lt;\\\/code&gt;, &lt;code&gt;.&lt;\\\/code&gt;, and &lt;code&gt;\\\/&lt;\\\/code&gt;. Accents and non-latin scripts are allowed.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&quot;,&quot;altTitle&quot;:&quot;validation-name&quot;,&quot;oldTabId&quot;:&quot;validation-name_1&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Addresses&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;The address field refers to all the following:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;&lt;code&gt;individual.residentialAddress&lt;\\\/code&gt;&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;organization.registeredAddress&lt;\\\/code&gt;&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;soleProprietorship.registeredAddress&lt;\\\/code&gt;&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;trust.registeredAddress&lt;\\\/code&gt;&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;unincorporatedPartnership.registeredAddress&lt;\\\/code&gt;&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;The address field for all entity types cannot contain:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;An emoji&lt;\\\/li&gt;\\n&lt;li&gt;A repeated field for all parts of the address. For example, &lt;strong&gt;Spain&lt;\\\/strong&gt;, &lt;strong&gt;Spain&lt;\\\/strong&gt;, &lt;strong&gt;Spain&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Only one repeated character. For example, &lt;em&gt;zzzzz&lt;\\\/em&gt;&lt;\\\/li&gt;\\n&lt;li&gt;Only symbols. For example, &lt;em&gt;&amp;amp;&amp;amp;&amp;amp;&amp;amp;&lt;\\\/em&gt;&lt;\\\/li&gt;\\n&lt;li&gt;Only numbers. For example, &lt;em&gt;123456&lt;\\\/em&gt;&lt;\\\/li&gt;\\n&lt;li&gt;Only spaces&lt;\\\/li&gt;\\n&lt;li&gt;A fictitious address. For example, \\&quot;John Doe\\&quot;&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;The address field must contain:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;A minimum of three characters for both the street name and city.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&quot;,&quot;altTitle&quot;:&quot;validation-address&quot;,&quot;oldTabId&quot;:&quot;validation-address_2&quot;,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<h2 id=\"underage-users\">Onboarding underage users<\/h2>\n<p>Users between the ages of 13-18 in particular countries\/regions can be onboarded with a legal representative. See <a href=\"\/pt\/platforms\/verification-requirements\/#minimum-age-requirements-for-users\">here<\/a> for more information.<\/p>\n<h2 id=\"unincorporated-partnerships\">Onboarding unincorporated partnerships<\/h2>\n<p>Beginning with onboarding v3, you can now onboard <a href=\"\/pt\/platforms\/verification-requirements\/?tab=unincorporated_partnership_4_5\">unincorporated partnerships<\/a> in <a href=\"\/pt\/platforms\/verification-requirements\/?tab=unincorporated_partnership_4_5\">selected countries\/regions<\/a>. Unincorporated partnerships can only be onboarded using the Legal Entity Management API.<\/p>\n<h2 id=\"registration-number\">Providing registration number before processing payments<\/h2>\n<p>Organizations must provide their registration number prior to processing payments. See <a href=\"\/pt\/platforms\/verification-requirements\/data-formats-per-country\/\">here<\/a> for the accepted format per country.<\/p>\n<h2 id=\"doing-business-as\">Requirements for doing business as name<\/h2>\n<p>Adyen must identify if the name that an organization or legal arrangement trades under is different from its registered name. This is referred to as the <em>Doing Business As<\/em> (DBA) name. Organizations and legal arrangements that do not have a DBA name can indicate this while onboarding.<\/p>\n<p>If you are using hosted onboarding, users can select this in the hosted onboarding page. If you are using the LEM API, set the corresponding value to <strong>true<\/strong> in your POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/4\/post\/legalEntities\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/legalEntities<\/a> request:<\/p>\n<ul>\n<li><code>organization.doingBusinessAsAbsent<\/code><\/li>\n<li><code>soleProprietorship.doingBusinessAsAbsent<\/code><\/li>\n<li><code>trust.doingBusinessAsAbsent<\/code><\/li>\n<li><code>unincorporatedPartnership.doingBusinessAsAbsent<\/code><\/li>\n<\/ul>\n<p>Make sure that your systems can handle all the related verification error messages.<\/p>\n<table>\n<thead>\n<tr>\n<th>Error Code<\/th>\n<th>Error Message<\/th>\n<th>Remediating action Code<\/th>\n<th>Remediating action<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>2_8086<\/td>\n<td><code>organization.doingBusinessAs<\/code> was missing<\/td>\n<td>2_133<\/td>\n<td>Add <code>organization.doingBusinessAs<\/code> to legal entity<\/td>\n<\/tr>\n<tr>\n<td>2_8246<\/td>\n<td><code>legalArrangement.doingBusinessAs<\/code> was missing.<\/td>\n<td>2_233<\/td>\n<td>Add <code>legalArrangement.doingBusinessAs<\/code> to legal entity<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"principal-place\">Requirements for principal place of business<\/h2>\n<p>If an organization has a principal place of business address, the country must be the same country as its registered address.<\/p>\n<p>Make sure that your systems can handle all the related verification error messages.<\/p>\n<table>\n<thead>\n<tr>\n<th>Error Code<\/th>\n<th>Error Message<\/th>\n<th>Remediating action Code<\/th>\n<th>Remediating action<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>2_8212<\/td>\n<td><code>organization.principalPlaceOfBusiness.country<\/code> was missing<\/td>\n<td>2_195<\/td>\n<td>Add <code>organization.principalPlaceOfBusiness.country<\/code> to legal entity<\/td>\n<\/tr>\n<tr>\n<td>2_8214<\/td>\n<td><code>organization.principalPlaceOfBusiness.stateOrProvince<\/code> was missing.<\/td>\n<td>2_197<\/td>\n<td>Add <code>organization.principalPlaceOfBusiness.stateOrProvince<\/code> to legal entity<\/td>\n<\/tr>\n<tr>\n<td>2_8216<\/td>\n<td><code>organization.principalPlaceOfBusiness.street<\/code> was missing.<\/td>\n<td>2_199<\/td>\n<td>Add <code>organization.principalPlaceOfBusiness.street<\/code> to legal entity<\/td>\n<\/tr>\n<tr>\n<td>2_8218<\/td>\n<td><code>organization.principalPlaceOfBusiness.city<\/code> was missing.<\/td>\n<td>2_207<\/td>\n<td>Add <code>organization.principalPlaceOfBusiness.city<\/code> to legal entity<\/td>\n<\/tr>\n<tr>\n<td>2_8219<\/td>\n<td><code>organization.principalPlaceOfBusiness.postalCode<\/code> was missing.<\/td>\n<td>2_209<\/td>\n<td>Add <code>organization.principalPlaceOfBusiness.postalCode<\/code> to legal entity<\/td>\n<\/tr>\n<tr>\n<td>2_8221<\/td>\n<td><code>organization.principalPlaceOfBusiness.street2<\/code> was missing.<\/td>\n<td>2_211<\/td>\n<td>Add <code>organization.principalPlaceOfBusiness.street2<\/code> to legal entity<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"countries-regions\">Requirements for specific countries\/regions<\/h2>\n<p>The following compliance requirements are based on the country of the user and its associated entities.<\/p>\n<div class=\"accordion-shortcode adl-accordion adl-accordion--max-height-transition\" data-expand=\"true\" data-ignore=\"anchorjs-link\">\n    \n    <div class=\"adl-accordion__item\" style=\"\">\n        <div tabindex=\"0\" role=\"item\" aria-expanded=\"false\" class=\"adl-accordion__header\">\n            <i class=\"adl-accordion__toggle adl-icon-chevron-down\"><\/i>\n            <div class=\"adl-accordion__title-wrapper\" data-accordion=\"#australia\">\n                                    <h3 class=\"adl-accordion__title\">Australia<\/h3>\n                            <\/div>\n        <\/div>\n        <div role=\"region\" class=\"adl-accordion__content\">\n            \n<ul>\n<li>The format for <a href=\"\/pt\/platforms\/verification-requirements\/data-formats-per-country#australia\">registration numbers<\/a> for all organizations, sole proprietorships, and trusts is now only 9 digits. Example: 123456789<\/li>\n<\/ul>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Data for<\/th>\n<th style=\"text-align: left;\">Type<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<th style=\"text-align: left;\">Format<\/th>\n<th style=\"text-align: left;\">Example<\/th>\n<th>Onboarding version<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">Organizations\/sole proprietorships<\/td>\n<td style=\"text-align: left;\">Registration number<\/td>\n<td style=\"text-align: left;\">ACN Number<\/td>\n<td style=\"text-align: left;\">9 digits<\/td>\n<td style=\"text-align: left;\">123456789<\/td>\n<td>v4<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">Tax Information<\/td>\n<td style=\"text-align: left;\">ABN Number<\/td>\n<td style=\"text-align: left;\">11 digits<\/td>\n<td style=\"text-align: left;\">55123456789<\/td>\n<td><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">Registration number for incorporated associations<\/td>\n<td style=\"text-align: left;\">Various formats per state\/territory<\/td>\n<td style=\"text-align: left;\">3-20 alphanumeric<\/td>\n<td style=\"text-align: left;\">12345A678901<\/td>\n<td>v1\/v2\/v3\/v4<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Trusts<\/td>\n<td style=\"text-align: left;\">Tax Information<\/td>\n<td style=\"text-align: left;\">ABN Number<\/td>\n<td style=\"text-align: left;\">11 digits<\/td>\n<td style=\"text-align: left;\">55123456789<\/td>\n<td><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Individuals<\/td>\n<td style=\"text-align: left;\">Identification number<\/td>\n<td style=\"text-align: left;\">Driver's license number<\/td>\n<td style=\"text-align: left;\">5-11 alphanumeric<\/td>\n<td style=\"text-align: left;\">2093628291<\/td>\n<td>v3\/v4<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">Driver's license card number<\/td>\n<td style=\"text-align: left;\">5-11 alphanumeric<\/td>\n<td style=\"text-align: left;\">FCC6811469<\/td>\n<td>v3\/v4<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<ul>\n<li>\n<p>Registration numbers for partnerships (both incorporated and unincorporated) are optional.<\/p>\n<\/li>\n<li>\n<p>Tax number for trustees are optional.<\/p>\n<\/li>\n<li>\n<p>Certain types of organizations and legal arrangements may not have a registration number or tax ID.  If you are using the LEM API, specify either <code>registrationNumberAbsent<\/code>: <strong>true<\/strong> or <code>taxAbsent<\/code>: <strong>true<\/strong> in your POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/4\/post\/legalEntities\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/legalEntities<\/a> request. If you are using hosted onboarding, users can add this information in the hosted onboarding page.<\/p>\n<\/li>\n<\/ul>\n\n        <\/div>\n    <\/div>\n<\/div>\n\n<div class=\"accordion-shortcode adl-accordion adl-accordion--max-height-transition\" data-expand=\"true\" data-ignore=\"anchorjs-link\">\n    \n    <div class=\"adl-accordion__item\" style=\"\">\n        <div tabindex=\"0\" role=\"item\" aria-expanded=\"false\" class=\"adl-accordion__header\">\n            <i class=\"adl-accordion__toggle adl-icon-chevron-down\"><\/i>\n            <div class=\"adl-accordion__title-wrapper\" data-accordion=\"#brazil\">\n                                    <h3 class=\"adl-accordion__title\">Brazil<\/h3>\n                            <\/div>\n        <\/div>\n        <div role=\"region\" class=\"adl-accordion__content\">\n            \n<p>For organizations and legal arrangements, all associated entities that are resident in a different country\/region must provide an <a href=\"\/pt\/platforms\/verification-requirements\/document-requirements\/#photo-id-requirements\">identity document<\/a>.<\/p>\n\n        <\/div>\n    <\/div>\n<\/div>\n\n<div class=\"accordion-shortcode adl-accordion adl-accordion--max-height-transition\" data-expand=\"true\" data-ignore=\"anchorjs-link\">\n    \n    <div class=\"adl-accordion__item\" style=\"\">\n        <div tabindex=\"0\" role=\"item\" aria-expanded=\"false\" class=\"adl-accordion__header\">\n            <i class=\"adl-accordion__toggle adl-icon-chevron-down\"><\/i>\n            <div class=\"adl-accordion__title-wrapper\" data-accordion=\"#european-union\">\n                                    <h3 class=\"adl-accordion__title\">European Union<\/h3>\n                            <\/div>\n        <\/div>\n        <div role=\"region\" class=\"adl-accordion__content\">\n            \n<p>To offer business accounts to their users, organizations in the European Union must provide either of the following:<\/p>\n<ul>\n<li>Their annual turnover<\/li>\n<li>Their annual balance sheet<\/li>\n<\/ul>\n<p>If you are using hosted onboarding, users can add this information in the hosted onboarding page. If you are using the LEM API, in your POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/4\/post\/legalEntities\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/legalEntities<\/a> request, specify <code>organization.financialReports.annualTurnover<\/code> or <code>organization.financialReports.balanceSheetTotal<\/code>.<\/p>\n<p>Make sure that your systems can handle all the related verification error messages.<\/p>\n<table>\n<thead>\n<tr>\n<th>Error Code<\/th>\n<th>Error Message<\/th>\n<th>Remediating action Code<\/th>\n<th>Remediating action<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>2_8240<\/td>\n<td>Balance sheet total was missing<\/td>\n<td>2_227<\/td>\n<td>Provide balance sheet total for legal entity<\/td>\n<\/tr>\n<tr>\n<td>2_8241<\/td>\n<td>Annual turnover was missing<\/td>\n<td>2_228<\/td>\n<td>Provide annual turnover for legal entity<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n        <\/div>\n    <\/div>\n<\/div>\n\n<div class=\"accordion-shortcode adl-accordion adl-accordion--max-height-transition\" data-expand=\"true\" data-ignore=\"anchorjs-link\">\n    \n    <div class=\"adl-accordion__item\" style=\"\">\n        <div tabindex=\"0\" role=\"item\" aria-expanded=\"false\" class=\"adl-accordion__header\">\n            <i class=\"adl-accordion__toggle adl-icon-chevron-down\"><\/i>\n            <div class=\"adl-accordion__title-wrapper\" data-accordion=\"#gibraltar\">\n                                    <h3 class=\"adl-accordion__title\">Gibraltar<\/h3>\n                            <\/div>\n        <\/div>\n        <div role=\"region\" class=\"adl-accordion__content\">\n            \n<p>Organizations and sole proprietorships can now provide their tax ID instead of a VAT number. See <a href=\"\/pt\/platforms\/verification-requirements\/data-formats-per-country\/\">here<\/a> for accepted formats in different countries\/regions.<\/p>\n\n        <\/div>\n    <\/div>\n<\/div>\n\n<div class=\"accordion-shortcode adl-accordion adl-accordion--max-height-transition\" data-expand=\"true\" data-ignore=\"anchorjs-link\">\n    \n    <div class=\"adl-accordion__item\" style=\"\">\n        <div tabindex=\"0\" role=\"item\" aria-expanded=\"false\" class=\"adl-accordion__header\">\n            <i class=\"adl-accordion__toggle adl-icon-chevron-down\"><\/i>\n            <div class=\"adl-accordion__title-wrapper\" data-accordion=\"#hong-kong\">\n                                    <h3 class=\"adl-accordion__title\">Hong Kong<\/h3>\n                            <\/div>\n        <\/div>\n        <div role=\"region\" class=\"adl-accordion__content\">\n            \n<p>For organizations and legal arrangements, all associated entities that are resident in a different country\/region must provide an <a href=\"\/pt\/platforms\/verification-requirements\/document-requirements\/#photo-id-requirements\">identity document<\/a>.<\/p>\n\n        <\/div>\n    <\/div>\n<\/div>\n\n<div class=\"accordion-shortcode adl-accordion adl-accordion--max-height-transition\" data-expand=\"true\" data-ignore=\"anchorjs-link\">\n    \n    <div class=\"adl-accordion__item\" style=\"\">\n        <div tabindex=\"0\" role=\"item\" aria-expanded=\"false\" class=\"adl-accordion__header\">\n            <i class=\"adl-accordion__toggle adl-icon-chevron-down\"><\/i>\n            <div class=\"adl-accordion__title-wrapper\" data-accordion=\"#new-zealand\">\n                                    <h3 class=\"adl-accordion__title\">New Zealand<\/h3>\n                            <\/div>\n        <\/div>\n        <div role=\"region\" class=\"adl-accordion__content\">\n            \n<p>Organizations in New Zealand do not have a registration number. When onboarding an organization, specify <code>registrationNumberAbsent<\/code>: <strong>true<\/strong> in your POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/4\/post\/legalEntities\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/legalEntities<\/a> request. If you are using hosted onboarding, users can add this information in the hosted onboarding page.<\/p>\n<p>Sole proprietorships in New Zealand must provide their <a href=\"https:\/\/www.ird.govt.nz\/managing-my-tax\/ird-numbers\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">IRD number<\/a>. Registration numbers for sole proprietorships are optional.<\/p>\n<h4>Identification of nominees<\/h4>\n<p>Individuals that are associated to legal entities and legal arrangements as directors, UBOs through ownership, or secondary partners must also identify if they are nominees.<\/p>\n<p>Make a  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/patch\/legalEntities\/(id)\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/legalEntities\/{id}<\/a> request using the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/4\/patch\/legalEntities\/(id)#path-id\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">id<\/a> of the organization legal entity in the path. In the request, specify an  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/4\/patch\/legalEntities\/(id)#request-entityAssociations\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">entityAssociations<\/a> array containing <code>entityAssociation.nominee<\/code> set to <strong>true<\/strong> or <strong>false<\/strong>.<\/p>\n<h4>Verification of natural persons<\/h4>\n<p>In New Zealand, Adyen must verify the following information for all natural persons. This requirement applies to both individual users and users associated to a legal entity or legal arrangement.<\/p>\n<ul>\n<li>First name<\/li>\n<li>Last Name<\/li>\n<li>Date of birth<\/li>\n<li>Residential address<\/li>\n<\/ul>\n<p>Make sure that your systems can handle all the related verification error messages.<\/p>\n<table>\n<thead>\n<tr>\n<th>Error Code<\/th>\n<th>Error Message<\/th>\n<th>Remediating action Code<\/th>\n<th>Remediating action<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>2_8009<\/td>\n<td><code>individual.firstName<\/code> was missing<\/td>\n<td>2_102<\/td>\n<td>Add <code>individual.name.firstName<\/code> to legal entity<\/td>\n<\/tr>\n<tr>\n<td>2_8011<\/td>\n<td><code>individual.lastName<\/code> was missing<\/td>\n<td>2_103<\/td>\n<td>Add <code>individual.name.lastName<\/code> to legal entity<\/td>\n<\/tr>\n<tr>\n<td>2_8018<\/td>\n<td><code>individual.residentialAddress.stateOrProvince<\/code> was missing<\/td>\n<td>2_105<\/td>\n<td>Add <code>individual.residentialAddress.stateOrProvince<\/code> to legal entity<\/td>\n<\/tr>\n<tr>\n<td><a id=\"2_8019\"><\/a>2_8019<\/td>\n<td><code>individual.residentialAddress.street<\/code> was missing<\/td>\n<td>2_106<\/td>\n<td>Add <code>individual.residentialAddress.street<\/code> to legal entity<\/td>\n<\/tr>\n<tr>\n<td><a id=\"2_8020\"><\/a>2_8020<\/td>\n<td><code>individual.residentialAddress.city<\/code> was missing<\/td>\n<td>2_107<\/td>\n<td>Add <code>individual.residentialAddress.city<\/code> to legal entity<\/td>\n<\/tr>\n<tr>\n<td><a id=\"2_8021\"><\/a>2_8021<\/td>\n<td><code>individual.residentialAddress.postalCode<\/code> was missing<\/td>\n<td>2_108<\/td>\n<td>Add <code>individual.residentialAddress.postalcode<\/code> to legal entity<\/td>\n<\/tr>\n<tr>\n<td><a id=\"2_8058\"><\/a>2_8058<\/td>\n<td><code>individual.name<\/code> was missing<\/td>\n<td>2_120<\/td>\n<td>Add <code>individual.name<\/code> to legal entity<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<table>\n<thead>\n<tr>\n<th>Sub Error Code<\/th>\n<th>Sub error Message<\/th>\n<th>Remediating action Code<\/th>\n<th>Remediating action<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>1_3083<\/td>\n<td>The name or residential address couldn't be verified<\/td>\n<td>1_319<\/td>\n<td>Update individual details<\/td>\n<\/tr>\n<tr>\n<td><\/td>\n<td><\/td>\n<td>1_320<\/td>\n<td>Upload proof of residency<\/td>\n<\/tr>\n<tr>\n<td>1_3084<\/td>\n<td>The name or residential address does not match the proof of residential address<\/td>\n<td>1_319<\/td>\n<td>Update individual details<\/td>\n<\/tr>\n<tr>\n<td><\/td>\n<td><\/td>\n<td>1_320<\/td>\n<td>Upload proof of residency<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n        <\/div>\n    <\/div>\n<\/div>\n\n<div class=\"accordion-shortcode adl-accordion adl-accordion--max-height-transition\" data-expand=\"true\" data-ignore=\"anchorjs-link\">\n    \n    <div class=\"adl-accordion__item\" style=\"\">\n        <div tabindex=\"0\" role=\"item\" aria-expanded=\"false\" class=\"adl-accordion__header\">\n            <i class=\"adl-accordion__toggle adl-icon-chevron-down\"><\/i>\n            <div class=\"adl-accordion__title-wrapper\" data-accordion=\"#singapore\">\n                                    <h3 class=\"adl-accordion__title\">Singapore<\/h3>\n                            <\/div>\n        <\/div>\n        <div role=\"region\" class=\"adl-accordion__content\">\n            \n<p>For organizations and legal arrangements, all associated entities that are resident in a different country\/region must provide an <a href=\"\/pt\/platforms\/verification-requirements\/document-requirements\/#photo-id-requirements\">identity document<\/a>.<\/p>\n<h4 id=\"singpass\">Singpass for identity verification<\/h4>\n<p>Users in Singapore may be required to verify their identity using <a href=\"https:\/\/www.singpass.gov.sg\/main\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Singpass<\/a>, the Singapore government\u2019s digital identity platform. Users need to have a Singpass account before they can begin the process. To create an account, see <a href=\"https:\/\/portal.singpass.gov.sg\/home\/ui\/register\/instructions\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">here<\/a>.<\/p>\n<p>In the hosted onboarding page, users are prompted to provide the following verified information through Singpass:<\/p>\n<ul>\n<li>Name (including any aliases)<\/li>\n<li>Date of birth<\/li>\n<li>NRIC or FIN number<\/li>\n<li>Registered or residential address<\/li>\n<li>Email address<\/li>\n<li>Phone number<\/li>\n<\/ul>\n<p>Users can choose to enter this information separately, but they need to upload additional documentation, such as a scan of their identity document.<\/p>\n\n        <\/div>\n    <\/div>\n<\/div>\n\n<div class=\"accordion-shortcode adl-accordion adl-accordion--max-height-transition\" data-expand=\"true\" data-ignore=\"anchorjs-link\">\n    \n    <div class=\"adl-accordion__item\" style=\"\">\n        <div tabindex=\"0\" role=\"item\" aria-expanded=\"false\" class=\"adl-accordion__header\">\n            <i class=\"adl-accordion__toggle adl-icon-chevron-down\"><\/i>\n            <div class=\"adl-accordion__title-wrapper\" data-accordion=\"#united-kingdom\">\n                                    <h3 class=\"adl-accordion__title\">United Kingdom<\/h3>\n                            <\/div>\n        <\/div>\n        <div role=\"region\" class=\"adl-accordion__content\">\n            \n<h4>Country of governing law<\/h4>\n<p>The country of governing law is now required for both organizations and sole proprietorships. The country of governing law can be different from the country of the registered address for the legal entity\/legal arrangement.<\/p>\n<p>To provide this information using the LEM API, in your POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/4\/post\/legalEntities\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/legalEntities<\/a> request, include the two-letter country code in <code>organization.countryOfGoverningLaw<\/code> or <code>soleProprietorship.countryOfGoverningLaw<\/code>.<\/p>\n<h4>Identification of directors<\/h4>\n<p>Adyen must verify all directors of UK organizations. For more information about the requirements for supporting documents, see <a href=\"\/pt\/platforms\/verification-requirements\/document-requirements#director-proof\">here<\/a>.<\/p>\n<p>If you are using hosted onboarding, users can add this information in the hosted onboarding page. To provide this information using the LEM API, include <code>type<\/code> <strong>proofOfDirector<\/strong> in your POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/4\/post\/documents\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/documents<\/a> request.<\/p>\n<h4>Requirements for business accounts<\/h4>\n<p>To offer business accounts to their users, UK organizations must provide their number of employees, and either their annual turnover or annual balance sheet.<\/p>\n<p>If you are using hosted onboarding, users can add this information in the hosted onboarding page. If you are using the LEM API, in your POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/4\/post\/legalEntities\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/legalEntities<\/a> request, specify <code>organization.financialReports.employeeCount<\/code> and either  <code>organization.financialReports.annualTurnover<\/code> or <code>organization.financialReports.balanceSheetTotal<\/code>.<\/p>\n<p>Make sure that your systems can handle all the related verification error messages.<\/p>\n<table>\n<thead>\n<tr>\n<th>Error Code<\/th>\n<th>Error Message<\/th>\n<th>Remediating action Code<\/th>\n<th>Remediating action<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>2_8239<\/td>\n<td>Number of employees was missing<\/td>\n<td>2_226<\/td>\n<td>Provide number of employees for legal entity<\/td>\n<\/tr>\n<tr>\n<td>2_8240<\/td>\n<td>Balance sheet total was missing<\/td>\n<td>2_227<\/td>\n<td>Provide balance sheet total for legal entity<\/td>\n<\/tr>\n<tr>\n<td>2_8241<\/td>\n<td>Annual turnover was missing<\/td>\n<td>2_228<\/td>\n<td>Provide annual turnover for legal entity<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n        <\/div>\n    <\/div>\n<\/div>\n\n<div class=\"accordion-shortcode adl-accordion adl-accordion--max-height-transition\" data-expand=\"true\" data-ignore=\"anchorjs-link\">\n    \n    <div class=\"adl-accordion__item\" style=\"\">\n        <div tabindex=\"0\" role=\"item\" aria-expanded=\"false\" class=\"adl-accordion__header\">\n            <i class=\"adl-accordion__toggle adl-icon-chevron-down\"><\/i>\n            <div class=\"adl-accordion__title-wrapper\" data-accordion=\"#crown-dependencies-of-the-united-kingdom\">\n                                    <h3 class=\"adl-accordion__title\">Crown dependencies of the United Kingdom<\/h3>\n                            <\/div>\n        <\/div>\n        <div role=\"region\" class=\"adl-accordion__content\">\n            \n<p>This section is applicable to Guernsey, Jersey, and the Isle of Man.<\/p>\n<p>Organizations and sole proprietorships can now provide their tax ID instead of a VAT number. See <a href=\"\/pt\/platforms\/verification-requirements\/data-formats-per-country\/\">here<\/a> for accepted formats.<\/p>\n\n        <\/div>\n    <\/div>\n<\/div>\n\n<div class=\"accordion-shortcode adl-accordion adl-accordion--max-height-transition\" data-expand=\"true\" data-ignore=\"anchorjs-link\">\n    \n    <div class=\"adl-accordion__item\" style=\"\">\n        <div tabindex=\"0\" role=\"item\" aria-expanded=\"false\" class=\"adl-accordion__header\">\n            <i class=\"adl-accordion__toggle adl-icon-chevron-down\"><\/i>\n            <div class=\"adl-accordion__title-wrapper\" data-accordion=\"#united-states\">\n                                    <h3 class=\"adl-accordion__title\">United States<\/h3>\n                            <\/div>\n        <\/div>\n        <div role=\"region\" class=\"adl-accordion__content\">\n            \n<p>For US account holders, if their legal entity is associated to any non-US entities, all non-US individuals must provide an <a href=\"\/pt\/platforms\/verification-requirements\/document-requirements#photo-id-requirements\">identity document<\/a>.<\/p>\n<p>For organizations and legal arrangements, all associated entities that are resident in a different country\/region must provide an <a href=\"\/pt\/platforms\/verification-requirements\/document-requirements#photo-id-requirements\">identity document<\/a>.<\/p>\n\n        <\/div>\n    <\/div>\n<\/div>\n\n<h2 id=\"support-contact\">Support email and phone numbers<\/h2>\n<p>If you are a <a href=\"\/pt\/platforms\">platform model<\/a>, your users must provide both a support phone number and email address.<\/p>\n<ul>\n<li>\n<p>If your user is a <a href=\"\/pt\/platforms\/verification-requirements\/?tab=sole_proprietorship_2_3\">sole proprietorship<\/a>, they need to provide this information in the individual legal entity of the owner of the sole proprietorship.<\/p>\n<\/li>\n<li>\n<p>If your user is a <a href=\"\/pt\/platforms\/verification-requirements\/?tab=trust_3_4\">trust<\/a>, they need to provide this information in the individual or organization legal entity of the main trustee.<\/p>\n<\/li>\n<li>\n<p>If your user is an <a href=\"\/pt\/platforms\/verification-requirements\/?tab=unincorporated_partnership_4_5\">unincorporated partnership<\/a>, they need to provide this information in the individual legal entity of the main partner.<\/p>\n<\/li>\n<li>\n<p>If you are using hosted onboarding, users can add this information in the hosted onboarding page.<\/p>\n<\/li>\n<\/ul>\n<p>To use the Legal Entity Management API, in your POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/4\/post\/legalEntities\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/legalEntities<\/a> request, specify the required fields:<\/p>\n<ul>\n<li><code>individual.support.phone<\/code>\n<ul>\n<li><code>individual.support.phone.number<\/code><\/li>\n<li><code>individual.support.phone.type<\/code><\/li>\n<\/ul><\/li>\n<li><code>individual.support.email<\/code><\/li>\n<\/ul>\n<p>or<\/p>\n<ul>\n<li><code>organization.support.phone<\/code>\n<ul>\n<li><code>organization.support.phone.number<\/code><\/li>\n<li><code>organization.support.phone.type<\/code><\/li>\n<\/ul><\/li>\n<li><code>organization.support.email<\/code><\/li>\n<\/ul>\n<p>Make sure that your systems can handle all the related verification error messages.<\/p>\n<table>\n<thead>\n<tr>\n<th>Error Code<\/th>\n<th>Error Message<\/th>\n<th>Remediating action Code<\/th>\n<th>Remediating action<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>2_8247<\/td>\n<td><code>organization.support.email<\/code> was missing.<\/td>\n<td>2_234<\/td>\n<td>Add <code>organization.support.email<\/code> to legal entity<\/td>\n<\/tr>\n<tr>\n<td>2_8248<\/td>\n<td><code>individual.support.email was missing<\/code> was missing.<\/td>\n<td>2_235<\/td>\n<td>Add <code>individual.support.email<\/code> to legal entity<\/td>\n<\/tr>\n<tr>\n<td>2_8249<\/td>\n<td><code>organization.support.phone.number<\/code> was missing.<\/td>\n<td>2_236<\/td>\n<td>Add <code>organization.support.phone.number<\/code> to legal entity<\/td>\n<\/tr>\n<tr>\n<td>2_8250<\/td>\n<td><code>individual.support.phone.number<\/code> was missing.<\/td>\n<td>2_237<\/td>\n<td>Add <code>individual.support.phone.number<\/code> to legal entity<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"hosted-onboarding\">Updates for hosted onboarding<\/h2>\n<p>Publicly listed companies can now provide their ticker symbol in the hosted onboarding page<\/p>\n<p>Make sure that your systems can handle all the related verification error messages.<\/p>\n<table>\n<thead>\n<tr>\n<th>Error Code<\/th>\n<th>Error Message<\/th>\n<th>Remediating action Code<\/th>\n<th>Remediating action<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>2_8247<\/td>\n<td><code>organization.stockData.tickerSymbol<\/code> was missing.<\/td>\n<td>2_150<\/td>\n<td>Add <code>organization.stockData.tickerSymbol<\/code> to legal entity<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"business-lines\">Requirement for business lines and industry codes for issuing<\/h2>\n<div class=\"notices green\">\n<p>Only applicable for <a href=\"\/pt\/issuing\">card issuing<\/a><\/p>\n<\/div>\n<p>To issue cards to your users, you must create business lines for them. To submit this information to Adyen, make a POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/4\/post\/businessLines\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/businessLines<\/a> request, specifying the <code>service<\/code> as <strong>issuing<\/strong>. In your request, specify the <a href=\"\/pt\/platforms\/\/verification-requirements\/reference-additional-products\/#list-industry-codes\">industry code<\/a>.<\/p>\n<p>Make sure that your systems can handle all the related verification error messages.<\/p>\n<table>\n<thead>\n<tr>\n<th>Error Code<\/th>\n<th>Error Message<\/th>\n<th>Remediating action Code<\/th>\n<th>Remediating action<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>2_8181<\/td>\n<td><code>industryCode<\/code> was missing<\/td>\n<td>2_176<\/td>\n<td>Add <code>industryCode<\/code> to business line<\/td>\n<\/tr>\n<tr>\n<td>2_8231<\/td>\n<td><code>businessLine<\/code> was missing.<\/td>\n<td>2_136<\/td>\n<td>Add business line<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"source-funds\">Source of funds for business accounts and issuing<\/h2>\n<div class=\"notices green\">\n<p>Only applicable for <a href=\"\/pt\/business-accounts\/\">business accounts<\/a> and <a href=\"\/pt\/issuing\">card issuing<\/a>.<\/p>\n<\/div>\n<p>Adyen is required to verify the source of funds (SOF) used to fund an account. This requirement is applicable for both <a href=\"\/pt\/issuing\">card issuing<\/a> and <a href=\"\/pt\/business-accounts\/\">business accounts<\/a>.<\/p>\n<p>Depending on the type of funds, we may request additional documents as proof. We strongly recommend that you have these documents available before starting in order to speed up this process.<\/p>\n<p>To submit this information to Adyen, make a POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/4\/post\/businessLines\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/businessLines<\/a> request, specifying the <code>service<\/code> as either:<\/p>\n<ul>\n<li><strong>banking<\/strong> for business accounts<\/li>\n<li><strong>issuing<\/strong> for card issuing<\/li>\n<\/ul>\n<p>If the source of funds was processed through Adyen, set the <code>sourceOfFunds.adyenProcessedFunds<\/code> to <strong>true<\/strong>. If the source of funds was not processed through Adyen, set the <code>sourceOfFunds.adyenProcessedFunds<\/code> to <strong>false<\/strong>. You must then include the <code>sourceOfFunds.type<\/code> and <code>sourceOfFunds.description<\/code>. The description must state the origin of the source of funds.<\/p>\n<p>The following table shows the accepted funding sources and the required documents for each type, if requested. If the type of accepted document has a listed date requirement, the document must meet this requirement.<\/p>\n<div class=\"sticky-table-container\">\n    \n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Type of Source of Funds<\/th>\n<th style=\"text-align: left;\"><code>businessLines.sourceOfFunds.type<\/code> API value<\/th>\n<th style=\"text-align: left;\">Documents must show<\/th>\n<th style=\"text-align: left;\">Examples of accepted documents<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">Business earnings processed through Adyen<\/td>\n<td style=\"text-align: left;\">Set <code>businessLines.adyenProcessedFunds<\/code> to <strong>true<\/strong><\/td>\n<td style=\"text-align: left;\">N\/A<\/td>\n<td style=\"text-align: left;\">No supporting document is required<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Previous business earnings<\/td>\n<td style=\"text-align: left;\"><strong>business<\/strong><\/td>\n<td style=\"text-align: left;\"><ul><li>Name of company<\/li><li>Amounts earned<\/li><li>Description of business activity<\/li><\/ul><\/td>\n<td style=\"text-align: left;\"><ul><li>Latest accounts (issued within the last financial year)<\/li><li>Annual Statements (within 12 months)<\/li><li>Latest tax filing (issued within the last year)<\/li><li>Letter from accountant (signed and dated within 12 months)<\/li><li>Recent Invoices (last 3 months)<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">(Previous) employment<\/td>\n<td style=\"text-align: left;\"><strong>employment<\/strong><\/td>\n<td style=\"text-align: left;\"><ul><li>Your business name<\/li><li>Date document was issued<\/li><li>Bank logo\/name (for bank statement)<\/li><li>Employer\u2019s name (for payslips)<\/li><\/ul><\/td>\n<td style=\"text-align: left;\"><ul><li>Last 3 months of bank statements<\/li><li>Last 3 months of payslips<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Cryptocurrency<\/td>\n<td style=\"text-align: left;\"><strong>cryptocurrencyIncome<\/strong><\/td>\n<td style=\"text-align: left;\"><ul><li>Your business name<\/li><li>Date document was issued (no older than 12 months)<\/li><li>Name of Crypto-exchange<\/li><li>Name of coin<\/li><\/ul><\/td>\n<td style=\"text-align: left;\"><ul><li>Proof of ownership of wallet<\/li><li>Statement of transaction history (showing crypto)<\/li><li>Latest tax report (showing crypto) (no older than 12 months)<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Investments (dividends)<\/td>\n<td style=\"text-align: left;\"><strong>dividendIncome<\/strong><\/td>\n<td style=\"text-align: left;\"><ul><li>Your business name<\/li><li>The date your business received the money<\/li><li>The amount received<\/li><li>The type of investments<\/li><li>Names of the parties involved<\/li><\/ul><\/td>\n<td style=\"text-align: left;\"><ul><li>Contract specifying dividends<\/li><li>Latest tax returns of the company (no older than 12 months)<\/li><li>Investment certificate<\/li><li>Broker statement (issued within 3 months)<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Loans<\/td>\n<td style=\"text-align: left;\"><strong>loans<\/strong><\/td>\n<td style=\"text-align: left;\"><ul><li>Your business name<\/li><li>Amount you borrowed<\/li><li>The date you received the money<\/li><li>Name of the lender<\/li><li>Address of the lender<\/li><li>Purpose of the loan<\/li><\/ul><\/td>\n<td style=\"text-align: left;\"><ul><li>Loan agreement<\/li><li>Loan statement (no older than 12 months)<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Subsidies \/ Grants<\/td>\n<td style=\"text-align: left;\"><strong>financialAid<\/strong><\/td>\n<td style=\"text-align: left;\"><ul><li>Amount of Subsidy \/ Grant<\/li><li>Providers(s) of Subsidy \/ Grant<\/li><li>Time Period<\/li><\/ul><\/td>\n<td style=\"text-align: left;\"><ul><li>Confirmation of Subsidy \/ Grant<\/li><li>Subsidy Receipt<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Third Party Funding (capital investments)<\/td>\n<td style=\"text-align: left;\"><strong>thirdPartyFunding<\/strong><\/td>\n<td style=\"text-align: left;\"><ul><li>Your business name<\/li><li>The date your business received the money<\/li><li>The amount received<\/li><li>Names of the parties involved<\/li><li>Addresses of the parties involved<\/li><li>Signatures of the parties involved<\/li><li>Payment purpose<\/li><\/ul><\/td>\n<td style=\"text-align: left;\"><ul><li>Investor contracts<\/li><li>Investor memoranda<\/li><li>Notarized statements (no older than 12 months)<\/li><li>Partnership agreement<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Property Sale<\/td>\n<td style=\"text-align: left;\"><strong>assetSale<\/strong><\/td>\n<td style=\"text-align: left;\"><ul><li>Date money was received<\/li><li>Amount you received<\/li><li>Address (if applicable)<\/li><li>Description of property<\/li><\/ul><\/td>\n<td style=\"text-align: left;\"><ul><li>Proof of ownership (notarized)<\/li><li>Signed letter from the solicitor \/ estate agent (no older than 12 months)<\/li><li>Copy of contract of sale<\/li><li>Tax declaration (no older than 12 months)<\/li><li>Title deed (notarized)<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Rental Income<\/td>\n<td style=\"text-align: left;\"><strong>rentalIncome<\/strong><\/td>\n<td style=\"text-align: left;\"><ul><li>Amount received<\/li><li>Address<\/li><li>Name of parties to the agreement<\/li><\/ul><\/td>\n<td style=\"text-align: left;\"><ul><li>Rental Agreement<\/li><li>Proof of Ownership<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Donations \/ Gifts<\/td>\n<td style=\"text-align: left;\"><strong>donations<\/strong><\/td>\n<td style=\"text-align: left;\"><ul><li>Amount received<\/li><li>Date of transfer<\/li><li>Full name of donor<\/li><\/ul><\/td>\n<td style=\"text-align: left;\"><ul><li>Original or certified copy of grant<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Royalty Income<\/td>\n<td style=\"text-align: left;\"><strong>royaltyIncome<\/strong><\/td>\n<td style=\"text-align: left;\"><ul><li>Description of (intellectual) property<\/li><li>Amount received<\/li><\/ul><\/td>\n<td style=\"text-align: left;\"><ul><li>Royalty agreement<\/li><li>Tax declaration (no older than 12 months)<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Gambling \/ Lottery<\/td>\n<td style=\"text-align: left;\"><strong>gamblingWinnings<\/strong><\/td>\n<td style=\"text-align: left;\"><ul><li>Amount won<\/li><li>Date of winning<\/li><li>Location \/ Site<\/li><\/ul><\/td>\n<td style=\"text-align: left;\"><ul><li>Proof of Winnings<\/li><li>Win Report<\/li><li>Win\/Loss Statement (issued within 3 months)<\/li><li>Tax declaration that shows winnings (issued within 12 months)<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Inheritance<\/td>\n<td style=\"text-align: left;\"><strong>inheritance<\/strong><\/td>\n<td style=\"text-align: left;\"><ul><li>Name of person who made the will<\/li><li>Amount received \/ Value of estate<\/li><li>Date received<\/li><li>Name of benefactor<\/li><\/ul><\/td>\n<td style=\"text-align: left;\"><ul><li>Certificate of inheritance<\/li><li>A grant of probate<\/li><li>Letter from solicitor \/ notary (no older than 12 months)<\/li><li>Signed copy of the will<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Pension<\/td>\n<td style=\"text-align: left;\"><strong>pensionIncome<\/strong><\/td>\n<td style=\"text-align: left;\"><ul><li>Amount to be received<\/li><li>Legal Name of recipient<\/li><\/ul><\/td>\n<td style=\"text-align: left;\"><ul><li>Pension slip (no older than 12 months)<\/li><li>Letter from previous employer<\/li><li>Pension statement form (no older than 12 months)<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Insurance \/ Settlement<\/td>\n<td style=\"text-align: left;\"><strong>insuranceSettlement<\/strong><\/td>\n<td style=\"text-align: left;\"><ul><li>Amount of settlement<\/li><li>Legal name of recipient<\/li><li>Date received<\/li><\/ul><\/td>\n<td style=\"text-align: left;\"><ul><li>Court order<\/li><li>Letter from lawyer \/ solicitor<\/li><li>Letter from insurer<\/li><\/ul><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n<\/div>\n\n<p>Make sure that your systems can handle all the related verification error messages.<\/p>\n<table>\n<thead>\n<tr>\n<th>Error Code<\/th>\n<th>Error Message<\/th>\n<th>Remediating action Code<\/th>\n<th>Remediating action<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>2_8163<\/td>\n<td><code>sourceOfFunds<\/code> was missing<\/td>\n<td>2_159<\/td>\n<td>Add source of funds to business line<\/td>\n<\/tr>\n<tr>\n<td>2_8164<\/td>\n<td><code>businessLine.sourceOfFunds.type<\/code> was missing<\/td>\n<td>2_160<\/td>\n<td>Add <code>businessLine.sourceOfFunds.type<\/code> to business line<\/td>\n<\/tr>\n<tr>\n<td>2_8165<\/td>\n<td><code>businessLine.sourceOfFunds.dateOfFundsReceived<\/code> was missing<\/td>\n<td>2_161<\/td>\n<td>Add <code>businessLine.sourceOfFunds.dateOfFundsReceived<\/code> to business line<\/td>\n<\/tr>\n<tr>\n<td>2_8166<\/td>\n<td><code>businessLine.sourceOfFunds.dateOfSourceEvent<\/code> was missing<\/td>\n<td>2_162<\/td>\n<td>Add <code>businessLine.sourceOfFunds.dateOfSourceEvent<\/code> to business line<\/td>\n<\/tr>\n<tr>\n<td>2_8167<\/td>\n<td><code>businessLine.sourceOfFunds.purpose<\/code> was missing<\/td>\n<td>2_163<\/td>\n<td>Add <code>businessLine.sourceOfFunds.purpose<\/code> to business line<\/td>\n<\/tr>\n<tr>\n<td>2_8168<\/td>\n<td><code>businessLine.sourceOfFunds.adyenProcessedFunds<\/code> was missing<\/td>\n<td>2_164<\/td>\n<td>Add <code>businessLine.sourceOfFunds.adyenProcessedFunds<\/code> to business line<\/td>\n<\/tr>\n<tr>\n<td>2_8169<\/td>\n<td><code>businessLine.sourceOfFunds.cryptocurrencyExchange<\/code> was missing<\/td>\n<td>2_165<\/td>\n<td>Add <code>businessLine.sourceOfFunds.cryptocurrencyExchange<\/code> to business line<\/td>\n<\/tr>\n<tr>\n<td>2_8170<\/td>\n<td><code>businessLine.sourceOfFunds.description<\/code> was missing<\/td>\n<td>2_166<\/td>\n<td>Add <code>businessLine.sourceOfFunds.description<\/code> to business line<\/td>\n<\/tr>\n<tr>\n<td>2_8171<\/td>\n<td><code>businessLine.sourceOfFunds.relationship<\/code> was missing<\/td>\n<td>2_167<\/td>\n<td>Add <code>businessLine.sourceOfFunds.relationship<\/code> to business line<\/td>\n<\/tr>\n<tr>\n<td>2_8173<\/td>\n<td><code>businessLine.sourceOfFunds.amount<\/code> was missing<\/td>\n<td>2_169<\/td>\n<td>Add <code>businessLine.sourceOfFunds.amount<\/code> to business line<\/td>\n<\/tr>\n<tr>\n<td>2_8242<\/td>\n<td><code>businessLine.sourceOfFunds.annualTurnover<\/code> was missing.<\/td>\n<td>2_229<\/td>\n<td>Add <code>businessLine.sourceOfFunds.annualTurnover<\/code> to business line<\/td>\n<\/tr>\n<tr>\n<td>2_8243<\/td>\n<td><code>businessLine.sourceOfFunds.originatorLegalEntityId<\/code> was missing.<\/td>\n<td>2_230<\/td>\n<td>Add <code>businessLine.sourceOfFunds.originatorLegalEntityId<\/code> to business line<\/td>\n<\/tr>\n<tr>\n<td>2_8244<\/td>\n<td><code>businessLine.sourceOfFunds.financiers<\/code> was missing.<\/td>\n<td>2_231<\/td>\n<td>Add <code>businessLine.sourceOfFunds.financiers<\/code> to business line<\/td>\n<\/tr>\n<tr>\n<td>2_8245<\/td>\n<td><code>businessLine.sourceOfFunds.website<\/code> was missing.<\/td>\n<td>2_232<\/td>\n<td>Add <code>businessLine.sourceOfFunds.website<\/code> to business line<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n","url":"https:\/\/docs.adyen.com\/pt\/platforms\/onboard-users\/onboarding-versions\/onboarding-v4","articleFields":{"description":"Learn about the changes in onboarding v4.","feedback_component":true,"filters_component":false,"parameters":{"directoryPath":"\/platforms","model":"platform"},"decision_tree":"[]","page_id":"3395f8b4-0f46-40a0-9919-201a2a629723","last_edit_on":"10-02-2025 10:54"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/platforms\/onboard-users\/onboarding-versions\/onboarding-v4","title":"Onboarding v4","content":"This page provides an overview of the changes in onboarding v4. For more information about onboarding versioning, see here.\n\nTo see the difference between Legal Entity Management API versions, use the API Diff Tool.\n\n\nLimitations on using PO box as address\nImprovements for LEM API\nImproved validation for ID document uploads\nNew validations on fields\nOnboarding underage users\nOnboarding unincorporated partnerships\nProviding registration number before first payment\nRequirement for doing business as name\nRequirement for principal place of business\nRequirements for specific countries\/regions\nSupport phone number and phone from users\nUpdates for hosted onboarding\n\nChanges in v4 for financial products\n\nRequirement for business lines and industry codes for issuing\nSource of funds for issuing and business accounts\n\nLimitations on using a PO Box as an address\n\n\nAn individual user cannot use a PO box as their residential address.\n\n\nAn organization can use a PO box as their registered address. However, they must also provide an alternative address for their principal place of business. The address for the principal place of business cannot be a PO box.\n\n\nYou can test your error handling flow for the new verification error messages.\n\n\n\nError Code\nError Message\nSub Error Code\nSub error Message\nRemediating action Code\nRemediating action\n\n\n\n\n1_50\nOrganization details couldn't be verified\n1_5093\nThe business address details couldn\u2019t be verified\n1_524\nMake sure the registered business address is correct, and that the principal place of business address is a physical, non-PO box address\n\n\n\n\n1_5094\nThe principal place of business was missing\n1_525\nAdd the physical address of the principal place of business\n\n\n1_30\nIndividual details couldn't be verified\n1_3085\nThe residential address is a P.O. Box\n1_321\nUpdate the residential address\n\n\n\nImprovements for Legal Entity Management API\nWhen you delete a document by making a DELETE  \/documents\/{id} request, it now returns a 404 response.\nImproved validation for ID document uploads\nWe added a validation error when a low-quality ID document, such as a passport or driver's license, is uploaded by making a POST  \/documents. This allows you to quickly see if an improved document needs to be uploaded to pass verification checks.\n\n    \n\nNew validations on fields\nTo meet compliance requirements, we have added validations to specific fields for legal entities and legal arrangements. These validations are applicable for both hosted onboarding and API-only onboarding.\n\n\n    \n        \n        \n    \n\n\nOnboarding underage users\nUsers between the ages of 13-18 in particular countries\/regions can be onboarded with a legal representative. See here for more information.\nOnboarding unincorporated partnerships\nBeginning with onboarding v3, you can now onboard unincorporated partnerships in selected countries\/regions. Unincorporated partnerships can only be onboarded using the Legal Entity Management API.\nProviding registration number before processing payments\nOrganizations must provide their registration number prior to processing payments. See here for the accepted format per country.\nRequirements for doing business as name\nAdyen must identify if the name that an organization or legal arrangement trades under is different from its registered name. This is referred to as the Doing Business As (DBA) name. Organizations and legal arrangements that do not have a DBA name can indicate this while onboarding.\nIf you are using hosted onboarding, users can select this in the hosted onboarding page. If you are using the LEM API, set the corresponding value to true in your POST  \/legalEntities request:\n\norganization.doingBusinessAsAbsent\nsoleProprietorship.doingBusinessAsAbsent\ntrust.doingBusinessAsAbsent\nunincorporatedPartnership.doingBusinessAsAbsent\n\nMake sure that your systems can handle all the related verification error messages.\n\n\n\nError Code\nError Message\nRemediating action Code\nRemediating action\n\n\n\n\n2_8086\norganization.doingBusinessAs was missing\n2_133\nAdd organization.doingBusinessAs to legal entity\n\n\n2_8246\nlegalArrangement.doingBusinessAs was missing.\n2_233\nAdd legalArrangement.doingBusinessAs to legal entity\n\n\n\nRequirements for principal place of business\nIf an organization has a principal place of business address, the country must be the same country as its registered address.\nMake sure that your systems can handle all the related verification error messages.\n\n\n\nError Code\nError Message\nRemediating action Code\nRemediating action\n\n\n\n\n2_8212\norganization.principalPlaceOfBusiness.country was missing\n2_195\nAdd organization.principalPlaceOfBusiness.country to legal entity\n\n\n2_8214\norganization.principalPlaceOfBusiness.stateOrProvince was missing.\n2_197\nAdd organization.principalPlaceOfBusiness.stateOrProvince to legal entity\n\n\n2_8216\norganization.principalPlaceOfBusiness.street was missing.\n2_199\nAdd organization.principalPlaceOfBusiness.street to legal entity\n\n\n2_8218\norganization.principalPlaceOfBusiness.city was missing.\n2_207\nAdd organization.principalPlaceOfBusiness.city to legal entity\n\n\n2_8219\norganization.principalPlaceOfBusiness.postalCode was missing.\n2_209\nAdd organization.principalPlaceOfBusiness.postalCode to legal entity\n\n\n2_8221\norganization.principalPlaceOfBusiness.street2 was missing.\n2_211\nAdd organization.principalPlaceOfBusiness.street2 to legal entity\n\n\n\nRequirements for specific countries\/regions\nThe following compliance requirements are based on the country of the user and its associated entities.\n\n    \n    \n        \n            \n            \n                                    Australia\n                            \n        \n        \n            \n\nThe format for registration numbers for all organizations, sole proprietorships, and trusts is now only 9 digits. Example: 123456789\n\n\n\n\nData for\nType\nDescription\nFormat\nExample\nOnboarding version\n\n\n\n\nOrganizations\/sole proprietorships\nRegistration number\nACN Number\n9 digits\n123456789\nv4\n\n\n\nTax Information\nABN Number\n11 digits\n55123456789\n\n\n\n\nRegistration number for incorporated associations\nVarious formats per state\/territory\n3-20 alphanumeric\n12345A678901\nv1\/v2\/v3\/v4\n\n\nTrusts\nTax Information\nABN Number\n11 digits\n55123456789\n\n\n\nIndividuals\nIdentification number\nDriver's license number\n5-11 alphanumeric\n2093628291\nv3\/v4\n\n\n\n\nDriver's license card number\n5-11 alphanumeric\nFCC6811469\nv3\/v4\n\n\n\n\n\nRegistration numbers for partnerships (both incorporated and unincorporated) are optional.\n\n\nTax number for trustees are optional.\n\n\nCertain types of organizations and legal arrangements may not have a registration number or tax ID.  If you are using the LEM API, specify either registrationNumberAbsent: true or taxAbsent: true in your POST  \/legalEntities request. If you are using hosted onboarding, users can add this information in the hosted onboarding page.\n\n\n\n        \n    \n\n\n\n    \n    \n        \n            \n            \n                                    Brazil\n                            \n        \n        \n            \nFor organizations and legal arrangements, all associated entities that are resident in a different country\/region must provide an identity document.\n\n        \n    \n\n\n\n    \n    \n        \n            \n            \n                                    European Union\n                            \n        \n        \n            \nTo offer business accounts to their users, organizations in the European Union must provide either of the following:\n\nTheir annual turnover\nTheir annual balance sheet\n\nIf you are using hosted onboarding, users can add this information in the hosted onboarding page. If you are using the LEM API, in your POST  \/legalEntities request, specify organization.financialReports.annualTurnover or organization.financialReports.balanceSheetTotal.\nMake sure that your systems can handle all the related verification error messages.\n\n\n\nError Code\nError Message\nRemediating action Code\nRemediating action\n\n\n\n\n2_8240\nBalance sheet total was missing\n2_227\nProvide balance sheet total for legal entity\n\n\n2_8241\nAnnual turnover was missing\n2_228\nProvide annual turnover for legal entity\n\n\n\n\n        \n    \n\n\n\n    \n    \n        \n            \n            \n                                    Gibraltar\n                            \n        \n        \n            \nOrganizations and sole proprietorships can now provide their tax ID instead of a VAT number. See here for accepted formats in different countries\/regions.\n\n        \n    \n\n\n\n    \n    \n        \n            \n            \n                                    Hong Kong\n                            \n        \n        \n            \nFor organizations and legal arrangements, all associated entities that are resident in a different country\/region must provide an identity document.\n\n        \n    \n\n\n\n    \n    \n        \n            \n            \n                                    New Zealand\n                            \n        \n        \n            \nOrganizations in New Zealand do not have a registration number. When onboarding an organization, specify registrationNumberAbsent: true in your POST  \/legalEntities request. If you are using hosted onboarding, users can add this information in the hosted onboarding page.\nSole proprietorships in New Zealand must provide their IRD number. Registration numbers for sole proprietorships are optional.\nIdentification of nominees\nIndividuals that are associated to legal entities and legal arrangements as directors, UBOs through ownership, or secondary partners must also identify if they are nominees.\nMake a  \/legalEntities\/{id} request using the  id of the organization legal entity in the path. In the request, specify an  entityAssociations array containing entityAssociation.nominee set to true or false.\nVerification of natural persons\nIn New Zealand, Adyen must verify the following information for all natural persons. This requirement applies to both individual users and users associated to a legal entity or legal arrangement.\n\nFirst name\nLast Name\nDate of birth\nResidential address\n\nMake sure that your systems can handle all the related verification error messages.\n\n\n\nError Code\nError Message\nRemediating action Code\nRemediating action\n\n\n\n\n2_8009\nindividual.firstName was missing\n2_102\nAdd individual.name.firstName to legal entity\n\n\n2_8011\nindividual.lastName was missing\n2_103\nAdd individual.name.lastName to legal entity\n\n\n2_8018\nindividual.residentialAddress.stateOrProvince was missing\n2_105\nAdd individual.residentialAddress.stateOrProvince to legal entity\n\n\n2_8019\nindividual.residentialAddress.street was missing\n2_106\nAdd individual.residentialAddress.street to legal entity\n\n\n2_8020\nindividual.residentialAddress.city was missing\n2_107\nAdd individual.residentialAddress.city to legal entity\n\n\n2_8021\nindividual.residentialAddress.postalCode was missing\n2_108\nAdd individual.residentialAddress.postalcode to legal entity\n\n\n2_8058\nindividual.name was missing\n2_120\nAdd individual.name to legal entity\n\n\n\n\n\n\nSub Error Code\nSub error Message\nRemediating action Code\nRemediating action\n\n\n\n\n1_3083\nThe name or residential address couldn't be verified\n1_319\nUpdate individual details\n\n\n\n\n1_320\nUpload proof of residency\n\n\n1_3084\nThe name or residential address does not match the proof of residential address\n1_319\nUpdate individual details\n\n\n\n\n1_320\nUpload proof of residency\n\n\n\n\n        \n    \n\n\n\n    \n    \n        \n            \n            \n                                    Singapore\n                            \n        \n        \n            \nFor organizations and legal arrangements, all associated entities that are resident in a different country\/region must provide an identity document.\nSingpass for identity verification\nUsers in Singapore may be required to verify their identity using Singpass, the Singapore government\u2019s digital identity platform. Users need to have a Singpass account before they can begin the process. To create an account, see here.\nIn the hosted onboarding page, users are prompted to provide the following verified information through Singpass:\n\nName (including any aliases)\nDate of birth\nNRIC or FIN number\nRegistered or residential address\nEmail address\nPhone number\n\nUsers can choose to enter this information separately, but they need to upload additional documentation, such as a scan of their identity document.\n\n        \n    \n\n\n\n    \n    \n        \n            \n            \n                                    United Kingdom\n                            \n        \n        \n            \nCountry of governing law\nThe country of governing law is now required for both organizations and sole proprietorships. The country of governing law can be different from the country of the registered address for the legal entity\/legal arrangement.\nTo provide this information using the LEM API, in your POST  \/legalEntities request, include the two-letter country code in organization.countryOfGoverningLaw or soleProprietorship.countryOfGoverningLaw.\nIdentification of directors\nAdyen must verify all directors of UK organizations. For more information about the requirements for supporting documents, see here.\nIf you are using hosted onboarding, users can add this information in the hosted onboarding page. To provide this information using the LEM API, include type proofOfDirector in your POST  \/documents request.\nRequirements for business accounts\nTo offer business accounts to their users, UK organizations must provide their number of employees, and either their annual turnover or annual balance sheet.\nIf you are using hosted onboarding, users can add this information in the hosted onboarding page. If you are using the LEM API, in your POST  \/legalEntities request, specify organization.financialReports.employeeCount and either  organization.financialReports.annualTurnover or organization.financialReports.balanceSheetTotal.\nMake sure that your systems can handle all the related verification error messages.\n\n\n\nError Code\nError Message\nRemediating action Code\nRemediating action\n\n\n\n\n2_8239\nNumber of employees was missing\n2_226\nProvide number of employees for legal entity\n\n\n2_8240\nBalance sheet total was missing\n2_227\nProvide balance sheet total for legal entity\n\n\n2_8241\nAnnual turnover was missing\n2_228\nProvide annual turnover for legal entity\n\n\n\n\n        \n    \n\n\n\n    \n    \n        \n            \n            \n                                    Crown dependencies of the United Kingdom\n                            \n        \n        \n            \nThis section is applicable to Guernsey, Jersey, and the Isle of Man.\nOrganizations and sole proprietorships can now provide their tax ID instead of a VAT number. See here for accepted formats.\n\n        \n    \n\n\n\n    \n    \n        \n            \n            \n                                    United States\n                            \n        \n        \n            \nFor US account holders, if their legal entity is associated to any non-US entities, all non-US individuals must provide an identity document.\nFor organizations and legal arrangements, all associated entities that are resident in a different country\/region must provide an identity document.\n\n        \n    \n\n\nSupport email and phone numbers\nIf you are a platform model, your users must provide both a support phone number and email address.\n\n\nIf your user is a sole proprietorship, they need to provide this information in the individual legal entity of the owner of the sole proprietorship.\n\n\nIf your user is a trust, they need to provide this information in the individual or organization legal entity of the main trustee.\n\n\nIf your user is an unincorporated partnership, they need to provide this information in the individual legal entity of the main partner.\n\n\nIf you are using hosted onboarding, users can add this information in the hosted onboarding page.\n\n\nTo use the Legal Entity Management API, in your POST  \/legalEntities request, specify the required fields:\n\nindividual.support.phone\n\nindividual.support.phone.number\nindividual.support.phone.type\n\nindividual.support.email\n\nor\n\norganization.support.phone\n\norganization.support.phone.number\norganization.support.phone.type\n\norganization.support.email\n\nMake sure that your systems can handle all the related verification error messages.\n\n\n\nError Code\nError Message\nRemediating action Code\nRemediating action\n\n\n\n\n2_8247\norganization.support.email was missing.\n2_234\nAdd organization.support.email to legal entity\n\n\n2_8248\nindividual.support.email was missing was missing.\n2_235\nAdd individual.support.email to legal entity\n\n\n2_8249\norganization.support.phone.number was missing.\n2_236\nAdd organization.support.phone.number to legal entity\n\n\n2_8250\nindividual.support.phone.number was missing.\n2_237\nAdd individual.support.phone.number to legal entity\n\n\n\nUpdates for hosted onboarding\nPublicly listed companies can now provide their ticker symbol in the hosted onboarding page\nMake sure that your systems can handle all the related verification error messages.\n\n\n\nError Code\nError Message\nRemediating action Code\nRemediating action\n\n\n\n\n2_8247\norganization.stockData.tickerSymbol was missing.\n2_150\nAdd organization.stockData.tickerSymbol to legal entity\n\n\n\nRequirement for business lines and industry codes for issuing\n\nOnly applicable for card issuing\n\nTo issue cards to your users, you must create business lines for them. To submit this information to Adyen, make a POST  \/businessLines request, specifying the service as issuing. In your request, specify the industry code.\nMake sure that your systems can handle all the related verification error messages.\n\n\n\nError Code\nError Message\nRemediating action Code\nRemediating action\n\n\n\n\n2_8181\nindustryCode was missing\n2_176\nAdd industryCode to business line\n\n\n2_8231\nbusinessLine was missing.\n2_136\nAdd business line\n\n\n\nSource of funds for business accounts and issuing\n\nOnly applicable for business accounts and card issuing.\n\nAdyen is required to verify the source of funds (SOF) used to fund an account. This requirement is applicable for both card issuing and business accounts.\nDepending on the type of funds, we may request additional documents as proof. We strongly recommend that you have these documents available before starting in order to speed up this process.\nTo submit this information to Adyen, make a POST  \/businessLines request, specifying the service as either:\n\nbanking for business accounts\nissuing for card issuing\n\nIf the source of funds was processed through Adyen, set the sourceOfFunds.adyenProcessedFunds to true. If the source of funds was not processed through Adyen, set the sourceOfFunds.adyenProcessedFunds to false. You must then include the sourceOfFunds.type and sourceOfFunds.description. The description must state the origin of the source of funds.\nThe following table shows the accepted funding sources and the required documents for each type, if requested. If the type of accepted document has a listed date requirement, the document must meet this requirement.\n\n    \n\n\n\nType of Source of Funds\nbusinessLines.sourceOfFunds.type API value\nDocuments must show\nExamples of accepted documents\n\n\n\n\nBusiness earnings processed through Adyen\nSet businessLines.adyenProcessedFunds to true\nN\/A\nNo supporting document is required\n\n\nPrevious business earnings\nbusiness\nName of companyAmounts earnedDescription of business activity\nLatest accounts (issued within the last financial year)Annual Statements (within 12 months)Latest tax filing (issued within the last year)Letter from accountant (signed and dated within 12 months)Recent Invoices (last 3 months)\n\n\n(Previous) employment\nemployment\nYour business nameDate document was issuedBank logo\/name (for bank statement)Employer\u2019s name (for payslips)\nLast 3 months of bank statementsLast 3 months of payslips\n\n\nCryptocurrency\ncryptocurrencyIncome\nYour business nameDate document was issued (no older than 12 months)Name of Crypto-exchangeName of coin\nProof of ownership of walletStatement of transaction history (showing crypto)Latest tax report (showing crypto) (no older than 12 months)\n\n\nInvestments (dividends)\ndividendIncome\nYour business nameThe date your business received the moneyThe amount receivedThe type of investmentsNames of the parties involved\nContract specifying dividendsLatest tax returns of the company (no older than 12 months)Investment certificateBroker statement (issued within 3 months)\n\n\nLoans\nloans\nYour business nameAmount you borrowedThe date you received the moneyName of the lenderAddress of the lenderPurpose of the loan\nLoan agreementLoan statement (no older than 12 months)\n\n\nSubsidies \/ Grants\nfinancialAid\nAmount of Subsidy \/ GrantProviders(s) of Subsidy \/ GrantTime Period\nConfirmation of Subsidy \/ GrantSubsidy Receipt\n\n\nThird Party Funding (capital investments)\nthirdPartyFunding\nYour business nameThe date your business received the moneyThe amount receivedNames of the parties involvedAddresses of the parties involvedSignatures of the parties involvedPayment purpose\nInvestor contractsInvestor memorandaNotarized statements (no older than 12 months)Partnership agreement\n\n\nProperty Sale\nassetSale\nDate money was receivedAmount you receivedAddress (if applicable)Description of property\nProof of ownership (notarized)Signed letter from the solicitor \/ estate agent (no older than 12 months)Copy of contract of saleTax declaration (no older than 12 months)Title deed (notarized)\n\n\nRental Income\nrentalIncome\nAmount receivedAddressName of parties to the agreement\nRental AgreementProof of Ownership\n\n\nDonations \/ Gifts\ndonations\nAmount receivedDate of transferFull name of donor\nOriginal or certified copy of grant\n\n\nRoyalty Income\nroyaltyIncome\nDescription of (intellectual) propertyAmount received\nRoyalty agreementTax declaration (no older than 12 months)\n\n\nGambling \/ Lottery\ngamblingWinnings\nAmount wonDate of winningLocation \/ Site\nProof of WinningsWin ReportWin\/Loss Statement (issued within 3 months)Tax declaration that shows winnings (issued within 12 months)\n\n\nInheritance\ninheritance\nName of person who made the willAmount received \/ Value of estateDate receivedName of benefactor\nCertificate of inheritanceA grant of probateLetter from solicitor \/ notary (no older than 12 months)Signed copy of the will\n\n\nPension\npensionIncome\nAmount to be receivedLegal Name of recipient\nPension slip (no older than 12 months)Letter from previous employerPension statement form (no older than 12 months)\n\n\nInsurance \/ Settlement\ninsuranceSettlement\nAmount of settlementLegal name of recipientDate received\nCourt orderLetter from lawyer \/ solicitorLetter from insurer\n\n\n\n\n\n\nMake sure that your systems can handle all the related verification error messages.\n\n\n\nError Code\nError Message\nRemediating action Code\nRemediating action\n\n\n\n\n2_8163\nsourceOfFunds was missing\n2_159\nAdd source of funds to business line\n\n\n2_8164\nbusinessLine.sourceOfFunds.type was missing\n2_160\nAdd businessLine.sourceOfFunds.type to business line\n\n\n2_8165\nbusinessLine.sourceOfFunds.dateOfFundsReceived was missing\n2_161\nAdd businessLine.sourceOfFunds.dateOfFundsReceived to business line\n\n\n2_8166\nbusinessLine.sourceOfFunds.dateOfSourceEvent was missing\n2_162\nAdd businessLine.sourceOfFunds.dateOfSourceEvent to business line\n\n\n2_8167\nbusinessLine.sourceOfFunds.purpose was missing\n2_163\nAdd businessLine.sourceOfFunds.purpose to business line\n\n\n2_8168\nbusinessLine.sourceOfFunds.adyenProcessedFunds was missing\n2_164\nAdd businessLine.sourceOfFunds.adyenProcessedFunds to business line\n\n\n2_8169\nbusinessLine.sourceOfFunds.cryptocurrencyExchange was missing\n2_165\nAdd businessLine.sourceOfFunds.cryptocurrencyExchange to business line\n\n\n2_8170\nbusinessLine.sourceOfFunds.description was missing\n2_166\nAdd businessLine.sourceOfFunds.description to business line\n\n\n2_8171\nbusinessLine.sourceOfFunds.relationship was missing\n2_167\nAdd businessLine.sourceOfFunds.relationship to business line\n\n\n2_8173\nbusinessLine.sourceOfFunds.amount was missing\n2_169\nAdd businessLine.sourceOfFunds.amount to business line\n\n\n2_8242\nbusinessLine.sourceOfFunds.annualTurnover was missing.\n2_229\nAdd businessLine.sourceOfFunds.annualTurnover to business line\n\n\n2_8243\nbusinessLine.sourceOfFunds.originatorLegalEntityId was missing.\n2_230\nAdd businessLine.sourceOfFunds.originatorLegalEntityId to business line\n\n\n2_8244\nbusinessLine.sourceOfFunds.financiers was missing.\n2_231\nAdd businessLine.sourceOfFunds.financiers to business line\n\n\n2_8245\nbusinessLine.sourceOfFunds.website was missing.\n2_232\nAdd businessLine.sourceOfFunds.website to business line\n\n\n\n","type":"page","locale":"pt","boost":16,"hierarchy":{"lvl0":"Home","lvl1":"Platforms","lvl2":"Onboard and verify users","lvl3":"Onboarding versions","lvl4":"Onboarding v4"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/platforms","lvl2":"https:\/\/docs.adyen.com\/pt\/platforms\/onboard-users","lvl3":"https:\/\/docs.adyen.com\/pt\/platforms\/onboard-users\/onboarding-versions","lvl4":"\/pt\/platforms\/onboard-users\/onboarding-versions\/onboarding-v4"},"levels":5,"category":"Platforms","category_color":"green","tags":["Onboarding"]}}