{"title":"API-only onboarding","category":"default","creationDate":1678101060,"content":"<p>To onboard users on your platform, you need to build your own UI where you collect data from your users and submit this data to Adyen. You can onboard users operating in any of the <a href=\"\/managed-model#supported-countries\">supported countries<\/a>. On this page, we explain how you can onboard and verify your users using the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/overview\" class=\" external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Legal Entity Management API<\/a>.<\/p>\n<h2>Requirements<\/h2>\n<p>Make sure that:<\/p>\n<ul>\n<li>You have API credentials for the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/overview\" class=\" external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Legal Entity Management API<\/a> and the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/overview\" class=\" external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Management API<\/a>.<\/li>\n<li>You have reviewed the <a href=\"\/managed-model\/verification-overview\">verification process<\/a> and the <a href=\"\/managed-model\/verification-requirements\">required information<\/a> for your users.<\/li>\n<li>Your server is properly <a href=\"\/development-resources\/webhooks\">configured to accept webhooks<\/a> and you have <a href=\"\/development-resources\/webhooks\/configure-and-manage#set-up-webhooks-in-your-customer-area\">subscribed<\/a> to the <strong>Account data notifications<\/strong> in your Customer Area.<\/li>\n<\/ul>\n<h2 id=\"create-legal-entity\">Step 1: Create legal entities<\/h2>\n<p>A  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities\" class=\" external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">legal entity<\/a> resource holds information required for the <a href=\"\/managed-model\/verification-requirements\">verification checks<\/a>. You need to create a legal entity for the user that has a contractual relationship with your platform, and the individuals representing that entity.<\/p>\n<p>Select a tab below to create a legal entity for your user:<\/p>\n\n<div id=\"tabmdtrG\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Organization&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;To create a legal entity for an organization, provide the following information in a POST &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\/legalEntities&lt;\/a&gt; request. Any additional information you provide will be prefilled for the user in the hosted onboarding page.&lt;\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th&gt;Parameter&lt;\/th&gt;\\n&lt;th style=\\&quot;text-align: center;\\&quot;&gt;Required&lt;\/th&gt;\\n&lt;th&gt;Description&lt;\/th&gt;\\n&lt;\/tr&gt;\\n&lt;\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td&gt; &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities#request-type\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;type&lt;\/a&gt;&lt;\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\/user\/data\/smileys\/emoji\/white_check_mark.png\\&quot; \/&gt;&lt;\/td&gt;\\n&lt;td&gt;Set to &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;organization&lt;\/strong&gt;&lt;\/span&gt;.&lt;\/td&gt;\\n&lt;\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt; &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities#request-organization\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;organization&lt;\/a&gt;&lt;\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\/user\/data\/smileys\/emoji\/white_check_mark.png\\&quot; \/&gt;&lt;\/td&gt;\\n&lt;td&gt;Object that contains required information about the organization. The  &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities#request-organization-legalName\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;legalName&lt;\/a&gt; and its  &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities#request-organization-registeredAddress-country\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;country&lt;\/a&gt;.&lt;\/td&gt;\\n&lt;\/tr&gt;\\n&lt;\/tbody&gt;\\n&lt;\/table&gt;\\n&lt;p&gt;The following is an example of how to create a legal entity for a private company operating in the US.&lt;\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Create organization legal entity&#039;\\&quot; :id=\\&quot;&#039;create-legalEntity-organization-request&#039;\\&quot; :code-data=\\&quot;[{&amp;quot;language&amp;quot;:&amp;quot;bash&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;curl https:\\\\\/\\\\\/kyc-test.adyen.com\\\\\/lem\\\\\/v3\\\\\/legalEntities \\\\\\\\\\\\n-H &#039;x-api-key: ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY&#039; \\\\\\\\\\\\n-H &#039;content-type: application\\\\\/json&#039; \\\\\\\\\\\\n-X POST \\\\\\\\\\\\n-d &#039;{\\\\n   \\\\&amp;quot;type\\\\&amp;quot;:\\\\&amp;quot;organization\\\\&amp;quot;,\\\\n   \\\\&amp;quot;organization\\\\&amp;quot;:{\\\\n      \\\\&amp;quot;legalName\\\\&amp;quot;:\\\\&amp;quot;Example Company\\\\&amp;quot;,\\\\n      \\\\&amp;quot;registeredAddress\\\\&amp;quot;:{\\\\n         \\\\&amp;quot;country\\\\&amp;quot;:\\\\&amp;quot;US\\\\&amp;quot;\\\\n      }\\\\n   }\\\\n}&#039;&amp;quot;}]\\&quot; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\/code-sample&gt;\\n&lt;\/div&gt;\\n&lt;p&gt;The response returns the &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;legalEntity&lt;\/strong&gt;&lt;\/span&gt; resource for the organization, identified by its unique &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities#responses-200-id\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;id&lt;\/a&gt;.&lt;\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Response&#039;\\&quot; :id=\\&quot;&#039;create-legalEntity-organization-response&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n   \\\\\\&quot;organization\\\\\\&quot;:{\\\\n      \\\\\\&quot;legalName\\\\\\&quot;:\\\\\\&quot;Example Company\\\\\\&quot;,\\\\n      \\\\\\&quot;registeredAddress\\\\\\&quot;:{\\\\n         \\\\\\&quot;country\\\\\\&quot;:\\\\\\&quot;US\\\\\\&quot;\\\\n      }\\\\n   },\\\\n   \\\\\\&quot;type\\\\\\&quot;:\\\\\\&quot;organization\\\\\\&quot;,\\\\n   \\\\\\&quot;id\\\\\\&quot;:\\\\\\&quot;LE00000000000000000000001\\\\\\&quot;\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\/code-sample&gt;\\n&lt;\/div&gt;\\n&quot;,&quot;altTitle&quot;:&quot;org-create-le&quot;,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Individual&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;You must create an individual legal entity for each UBO and signatory in the organization, or the sole proprietor.&lt;\/p&gt;\\n&lt;p&gt;To create a legal entity for an individual, provide the following information in a POST &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\/legalEntities&lt;\/a&gt; request. &lt;\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th&gt;Parameter&lt;\/th&gt;\\n&lt;th style=\\&quot;text-align: center;\\&quot;&gt;Required&lt;\/th&gt;\\n&lt;th&gt;Description&lt;\/th&gt;\\n&lt;\/tr&gt;\\n&lt;\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td&gt; &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities#request-type\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;type&lt;\/a&gt;&lt;\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\/user\/data\/smileys\/emoji\/white_check_mark.png\\&quot; \/&gt;&lt;\/td&gt;\\n&lt;td&gt;Set to &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;individual&lt;\/strong&gt;&lt;\/span&gt;.&lt;\/td&gt;\\n&lt;\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt; &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities#request-individual\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;individual&lt;\/a&gt;&lt;\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\/user\/data\/smileys\/emoji\/white_check_mark.png\\&quot; \/&gt;&lt;\/td&gt;\\n&lt;td&gt;Object that contains required information about the individual. The  &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities#request-individual-name\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;name&lt;\/a&gt; and their  &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities#request-individual-residentialAddress-country\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;country&lt;\/a&gt;.&lt;\/td&gt;\\n&lt;\/tr&gt;\\n&lt;\/tbody&gt;\\n&lt;\/table&gt;\\n&lt;p&gt;The following is an example of how to create a legal entity for an individual in the US.&lt;\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Create an individual legal entity&#039;\\&quot; :id=\\&quot;&#039;create-legalEntity-individual-request&#039;\\&quot; :code-data=\\&quot;[{&amp;quot;language&amp;quot;:&amp;quot;bash&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;curl https:\\\\\/\\\\\/kyc-test.adyen.com\\\\\/lem\\\\\/v2\\\\\/legalEntities \\\\\\\\\\\\n-H &#039;x-api-key: ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY&#039; \\\\\\\\\\\\n-H &#039;content-type: application\\\\\/json&#039; \\\\\\\\\\\\n-X POST \\\\\\\\\\\\n-d &#039;{\\\\n  \\\\&amp;quot;type\\\\&amp;quot;: \\\\&amp;quot;individual\\\\&amp;quot;,\\\\n  \\\\&amp;quot;individual\\\\&amp;quot;: {\\\\n    \\\\&amp;quot;residentialAddress\\\\&amp;quot;: {\\\\n      \\\\&amp;quot;country\\\\&amp;quot;: \\\\&amp;quot;US\\\\&amp;quot;\\\\n    },\\\\n    \\\\&amp;quot;name\\\\&amp;quot;: {\\\\n      \\\\&amp;quot;firstName\\\\&amp;quot;: \\\\&amp;quot;Shelly\\\\&amp;quot;,\\\\n      \\\\&amp;quot;lastName\\\\&amp;quot;: \\\\&amp;quot;Eller\\\\&amp;quot;\\\\n    }\\\\n  }\\\\n}&#039;&amp;quot;}]\\&quot; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\/code-sample&gt;\\n&lt;\/div&gt;\\n&lt;p&gt;The response returns the &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;legalEntity&lt;\/strong&gt;&lt;\/span&gt; resource, identified by its unique &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities#responses-200-id\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;id&lt;\/a&gt;.&lt;\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Response&#039;\\&quot; :id=\\&quot;&#039;create-legalEntity-individual-response&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n    \\\\\\&quot;individual\\\\\\&quot;: {\\\\n        \\\\\\&quot;name\\\\\\&quot;: {\\\\n            \\\\\\&quot;firstName\\\\\\&quot;: \\\\\\&quot;Shelly\\\\\\&quot;,\\\\n            \\\\\\&quot;lastName\\\\\\&quot;: \\\\\\&quot;Eller\\\\\\&quot;\\\\n        },\\\\n        \\\\\\&quot;residentialAddress\\\\\\&quot;: {\\\\n            \\\\\\&quot;country\\\\\\&quot;: \\\\\\&quot;US\\\\\\&quot;\\\\n        }\\\\n    },\\\\n    \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;individual\\\\\\&quot;,\\\\n    \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;LE00000000000000000000002\\\\\\&quot;\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\/code-sample&gt;\\n&lt;\/div&gt;\\n&quot;,&quot;altTitle&quot;:&quot;ind-create-le&quot;,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Sole proprietorship&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;To create a legal entity for a sole proprietorship, provide the following information in a POST &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\/legalEntities&lt;\/a&gt; request.&lt;\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th&gt;Parameter&lt;\/th&gt;\\n&lt;th style=\\&quot;text-align: center;\\&quot;&gt;Required&lt;\/th&gt;\\n&lt;th&gt;Description&lt;\/th&gt;\\n&lt;\/tr&gt;\\n&lt;\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td&gt; &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities#request-type\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;type&lt;\/a&gt;&lt;\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\/user\/data\/smileys\/emoji\/white_check_mark.png\\&quot; \/&gt;&lt;\/td&gt;\\n&lt;td&gt;Set to &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;soleProprietorship&lt;\/strong&gt;&lt;\/span&gt;.&lt;\/td&gt;\\n&lt;\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt; &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities#request-soleProprietorship\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;soleProprietorship&lt;\/a&gt;&lt;\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\/user\/data\/smileys\/emoji\/white_check_mark.png\\&quot; \/&gt;&lt;\/td&gt;\\n&lt;td&gt;Object that contains required information about the sole proprietorship such as the  &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities#request-soleProprietorship-name\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;name&lt;\/a&gt; of the business, its  &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities#request-soleProprietorship-registeredAddress\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;registeredAddress&lt;\/a&gt;, and the &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities#request-soleProprietorship-countryOfGoverningLaw\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;countryOfGoverningLaw&lt;\/a&gt;.&lt;\/td&gt;\\n&lt;\/tr&gt;\\n&lt;\/tbody&gt;\\n&lt;\/table&gt;\\n&lt;p&gt;The following is an example of how to create a sole proprietorship in the United Kingdom.&lt;\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Create sole proprietorship legal entity&#039;\\&quot; :id=\\&quot;&#039;create-legalEntity-soleprop-request&#039;\\&quot; :code-data=\\&quot;[{&amp;quot;language&amp;quot;:&amp;quot;bash&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;curl https:\\\\\/\\\\\/kyc-test.adyen.com\\\\\/lem\\\\\/v3\\\\\/legalEntities \\\\\\\\\\\\n-H &#039;x-api-key: ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY&#039; \\\\\\\\\\\\n-H &#039;content-type: application\\\\\/json&#039; \\\\\\\\\\\\n-X POST \\\\\\\\\\\\n-d &#039;{\\\\n  \\\\&amp;quot;type\\\\&amp;quot;: \\\\&amp;quot;soleProprietorship\\\\&amp;quot;,\\\\n  \\\\&amp;quot;soleProprietorship\\\\&amp;quot;: {\\\\n    \\\\&amp;quot;name\\\\&amp;quot;: \\\\&amp;quot;Example Sole Trader\\\\&amp;quot;,\\\\n    \\\\&amp;quot;countryOfGoverningLaw\\\\&amp;quot;: \\\\&amp;quot;GB\\\\&amp;quot;,\\\\n    \\\\&amp;quot;registeredAddress\\\\&amp;quot; : {\\\\n      \\\\&amp;quot;city\\\\&amp;quot;: \\\\&amp;quot;London\\\\&amp;quot;,\\\\n      \\\\&amp;quot;country\\\\&amp;quot;: \\\\&amp;quot;GB\\\\&amp;quot;,\\\\n      \\\\&amp;quot;postalCode\\\\&amp;quot;: \\\\&amp;quot;W1T 3HE\\\\&amp;quot;,\\\\n      \\\\&amp;quot;street\\\\&amp;quot;: \\\\&amp;quot;12-13 Wells Mews\\\\&amp;quot;\\\\n    }\\\\n  }\\\\n}&#039;&amp;quot;}]\\&quot; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\/code-sample&gt;\\n&lt;\/div&gt;\\n&lt;p&gt;The response returns the &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;legalEntity&lt;\/strong&gt;&lt;\/span&gt; resource, identified by its unique &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities#responses-200-id\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;id&lt;\/a&gt;.&lt;\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Response&#039;\\&quot; :id=\\&quot;&#039;create-legalEntity-soleprop-response&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n  \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;soleProprietorship\\\\\\&quot;,\\\\n  \\\\\\&quot;soleProprietorship\\\\\\&quot;: {\\\\n    \\\\\\&quot;name\\\\\\&quot;: \\\\\\&quot;Example Sole Trader\\\\\\&quot;,\\\\n    \\\\\\&quot;countryOfGoverningLaw\\\\\\&quot;: \\\\\\&quot;GB\\\\\\&quot;,\\\\n    \\\\\\&quot;registeredAddress\\\\\\&quot; : {\\\\n      \\\\\\&quot;city\\\\\\&quot;: \\\\\\&quot;London\\\\\\&quot;,\\\\n      \\\\\\&quot;country\\\\\\&quot;: \\\\\\&quot;GB\\\\\\&quot;,\\\\n      \\\\\\&quot;postalCode\\\\\\&quot;: \\\\\\&quot;W1T 3HE\\\\\\&quot;,\\\\n      \\\\\\&quot;street\\\\\\&quot;: \\\\\\&quot;12-13 Wells Mews\\\\\\&quot;\\\\n    }\\\\n  },\\\\n  \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;LE00000000000000000000003\\\\\\&quot;\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\/code-sample&gt;\\n&lt;\/div&gt;\\n&quot;,&quot;altTitle&quot;:&quot;soleprop-create-le&quot;,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<h2 id=\"associate-legal-entities\">Step 2: Associate legal entities<\/h2>\n\n<div id=\"tabGsec5\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Sole proprietors&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;The example below shows how you can associate a sole proprietorship with the individual owner.&lt;\/p&gt;\\n&lt;p&gt;Update the legal entity of the individual by making a PATCH  &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/patch\/legalEntities\/(id)\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\/legalEntities\/{id}&lt;\/a&gt; request, specifying the &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/patch\/legalEntities\/_id_#request-entityAssociations\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;entityAssociations&lt;\/a&gt; array.&lt;\/p&gt;\\n&lt;p&gt;The array must include:&lt;\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt; &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/patch\/legalEntities\/(id)#request-entityAssociations-legalEntityId\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;legalEntityId&lt;\/a&gt;: Unique identifier of the sole proprietorship legal entity being associated.&lt;\/li&gt;\\n&lt;li&gt; &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/patch\/legalEntities\/(id)#request-entityAssociations-type\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;type&lt;\/a&gt;: Set to &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;soleProprietorship&lt;\/strong&gt;&lt;\/span&gt;.&lt;\/li&gt;\\n&lt;\/ul&gt;\\n&lt;div class=\\&quot;notices yellow\\&quot;&gt;\\n&lt;p&gt;When updating the &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/patch\/legalEntities\/_id_#request-entityAssociations\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;entityAssociations&lt;\/a&gt;, note that a PATCH request replaces the whole array. If you only want to update one array item, make sure you include all existing items along with the specific change in your request.&lt;\/p&gt;\\n&lt;\/div&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Associate a sole proprietorship to an individual&#039;\\&quot; :id=\\&quot;&#039;&#039;\\&quot; :code-data=\\&quot;[{&amp;quot;language&amp;quot;:&amp;quot;bash&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;curl https:\\\\\/\\\\\/kyc-test.adyen.com\\\\\/lem\\\\\/v3\\\\\/legalEntities\\\\\/LE00000000000000000000001 \\\\\\\\\\\\n-H &#039;x-api-key: ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY&#039; \\\\\\\\\\\\n-H &#039;content-type: application\\\\\/json&#039; \\\\\\\\\\\\n-X PATCH \\\\\\\\\\\\n-d &#039;{\\\\n      \\\\&amp;quot;entityAssociations\\\\&amp;quot;: [\\\\n        {\\\\n          \\\\&amp;quot;legalEntityId\\\\&amp;quot;: \\\\&amp;quot;LE00000000000000000000002\\\\&amp;quot;,\\\\n          \\\\&amp;quot;type\\\\&amp;quot;: \\\\&amp;quot;soleProprietorship\\\\&amp;quot;\\\\n        }\\\\n      ]\\\\n    }&#039;&amp;quot;}]\\&quot; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\/code-sample&gt;\\n&lt;\/div&gt;\\n&quot;,&quot;altTitle&quot;:&quot;sole-prop&quot;,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Organizations and UBOs&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;The example below shows how you can associate an ultimate beneficial owner (UBO), signatory, or director to an organization.&lt;\/p&gt;\\n&lt;p&gt;Update the legal entity of the organization by making a PATCH  &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/patch\/legalEntities\/(id)\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\/legalEntities\/{id}&lt;\/a&gt; request, specifying the &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/patch\/legalEntities\/_id_#request-entityAssociations\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;entityAssociations&lt;\/a&gt; array.&lt;\/p&gt;\\n&lt;p&gt;The array must include:&lt;\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt; &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/patch\/legalEntities\/(id)#request-entityAssociations-legalEntityId\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;legalEntityId&lt;\/a&gt;: Unique identifier of the individual legal entity being associated.&lt;\/li&gt;\\n&lt;li&gt; &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/patch\/legalEntities\/(id)#request-entityAssociations-type\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;type&lt;\/a&gt;: The relationship of the individual with the organization. Possible values: &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;uboThroughControl&lt;\/strong&gt;&lt;\/span&gt;, &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;uboThroughOwnership&lt;\/strong&gt;&lt;\/span&gt;, &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;director&lt;\/strong&gt;&lt;\/span&gt;, or &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;signatory&lt;\/strong&gt;&lt;\/span&gt;.&lt;\/li&gt;\\n&lt;\/ul&gt;\\n&lt;div class=\\&quot;notices yellow\\&quot;&gt;\\n&lt;p&gt;When updating the &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/patch\/legalEntities\/_id_#request-entityAssociations\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;entityAssociations&lt;\/a&gt;, note that a PATCH request replaces the whole array. If you only want to update one array item, make sure you include all existing items along with the specific change in your request.&lt;\/p&gt;\\n&lt;\/div&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Associate UBOs to an organization&#039;\\&quot; :id=\\&quot;&#039;&#039;\\&quot; :code-data=\\&quot;[{&amp;quot;language&amp;quot;:&amp;quot;bash&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;curl https:\\\\\/\\\\\/kyc-test.adyen.com\\\\\/lem\\\\\/v3\\\\\/legalEntities\\\\\/LE00000000000000000000001 \\\\\\\\\\\\n-H &#039;x-api-key: ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY&#039; \\\\\\\\\\\\n-H &#039;content-type: application\\\\\/json&#039; \\\\\\\\\\\\n-X PATCH \\\\\\\\\\\\n-d &#039;{\\\\n        \\\\&amp;quot;entityAssociations\\\\&amp;quot;: [\\\\n          {\\\\n            \\\\&amp;quot;jobTitle\\\\&amp;quot;: \\\\&amp;quot;CEO\\\\&amp;quot;,\\\\n            \\\\&amp;quot;legalEntityId\\\\&amp;quot;: \\\\&amp;quot;LE00000000000000000000002\\\\&amp;quot;,\\\\n            \\\\&amp;quot;type\\\\&amp;quot;: \\\\&amp;quot;uboThroughControl\\\\&amp;quot;\\\\n          },\\\\n          {\\\\n            \\\\&amp;quot;legalEntityId\\\\&amp;quot;: \\\\&amp;quot;LE00000000000000000000003\\\\&amp;quot;,\\\\n            \\\\&amp;quot;type\\\\&amp;quot;: \\\\&amp;quot;uboThroughOwnership\\\\&amp;quot;\\\\n          },\\\\n          {\\\\n            \\\\&amp;quot;jobTitle\\\\&amp;quot;: \\\\&amp;quot;Country Manager\\\\&amp;quot;,\\\\n              \\\\&amp;quot;legalEntityId\\\\&amp;quot;: \\\\&amp;quot;LE00000000000000000000004\\\\&amp;quot;,\\\\n          \\\\&amp;quot;type\\\\&amp;quot;: \\\\&amp;quot;signatory\\\\&amp;quot;\\\\n          }\\\\n        ]\\\\n      }&#039;&amp;quot;}]\\&quot; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\/code-sample&gt;\\n&lt;\/div&gt;\\n&lt;p&gt;If a person holds multiple roles in an organization, use their individual legal entity &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities#responses-200-id\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;id&lt;\/a&gt; to link them to each &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/patch\/legalEntities\/_id_#request-entityAssociations-type\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;type&lt;\/a&gt; or &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/patch\/legalEntities\/_id_#request-entityAssociations-jobTitle\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;jobTitle&lt;\/a&gt;.&lt;\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Associate an individual legal entity with multiple roles&#039;\\&quot; :id=\\&quot;&#039;&#039;\\&quot; :code-data=\\&quot;[{&amp;quot;language&amp;quot;:&amp;quot;bash&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;curl https:\\\\\/\\\\\/kyc-test.adyen.com\\\\\/lem\\\\\/v3\\\\\/legalEntities\\\\\/LE00000000000000000000001 \\\\\\\\\\\\n-H &#039;x-api-key: ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY&#039; \\\\\\\\\\\\n-H &#039;content-type: application\\\\\/json&#039; \\\\\\\\\\\\n-X PATCH \\\\\\\\\\\\n-d &#039;{\\\\n   \\\\&amp;quot;entityAssociations\\\\&amp;quot;:[\\\\n      {\\\\n         \\\\&amp;quot;jobTitle\\\\&amp;quot;:\\\\&amp;quot;CEO\\\\&amp;quot;,\\\\n         \\\\&amp;quot;legalEntityId\\\\&amp;quot;:\\\\&amp;quot;LE00000000000000000000002\\\\&amp;quot;,\\\\n         \\\\&amp;quot;type\\\\&amp;quot;:\\\\&amp;quot;uboThroughControl\\\\&amp;quot;\\\\n      },\\\\n      {\\\\n         \\\\&amp;quot;legalEntityId\\\\&amp;quot;:\\\\&amp;quot;LE00000000000000000000002\\\\&amp;quot;,\\\\n         \\\\&amp;quot;type\\\\&amp;quot;:\\\\&amp;quot;uboThroughOwnership\\\\&amp;quot;\\\\n      },\\\\n      {\\\\n         \\\\&amp;quot;jobTitle\\\\&amp;quot;:\\\\&amp;quot;CEO\\\\&amp;quot;,\\\\n         \\\\&amp;quot;legalEntityId\\\\&amp;quot;:\\\\&amp;quot;LE00000000000000000000002\\\\&amp;quot;,\\\\n         \\\\&amp;quot;type\\\\&amp;quot;:\\\\&amp;quot;signatory\\\\&amp;quot;\\\\n      }\\\\n   ]\\\\n}&#039;&amp;quot;}]\\&quot; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\/code-sample&gt;\\n&lt;\/div&gt;\\n&quot;,&quot;altTitle&quot;:&quot;ubos&quot;,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<p>The response contains the updated legal entity resource, identified by its unique <code>id<\/code>.<\/p>\n<h2>Step 3: Create transfer instruments<\/h2>\n<p>Adyen must perform checks on the bank account where your user will receive their payouts. We refer to this bank account as a  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/transferInstruments\" class=\" external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">transfer instrument<\/a> resource.<\/p>\n<p>Collect the <a href=\"\/managed-model\/verification-requirements\">required information<\/a> and provide this in a POST <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/transferInstruments\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/transferInstruments<\/a> request, specifying:<\/p>\n<table>\n<thead>\n<tr>\n<th>Parameter<\/th>\n<th style=\"text-align: center;\">Required<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities#request-type\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">type<\/a><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>Set to <span translate=\"no\"><strong>bankAccount<\/strong><\/span>.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/transferInstruments#request-legalEntityId\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">legalEntityId<\/a><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>Unique identifier of the legal entity that has the contractual relationship with your platform and owns the bank account. For sole proprietorships, this is the legal entity ID of the individual owner.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/transferInstruments#request-bankAccount\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">bankAccount<\/a><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>Object that contains required information about the legal entity's bank account.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Here is an example request to add a transfer instrument for a bank account in the US:<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Add bank account as a transfer instrument'\" :id=\"'create-transferInstrument-request'\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/kyc-test.adyen.com\\\/lem\\\/v3\\\/transferInstruments \\\\\\n-H 'x-api-key: ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY' \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-X POST \\\\\\n-d '{\\n   \\&quot;legalEntityId\\&quot;:\\&quot;LE00000000000000000000001\\&quot;,\\n   \\&quot;type\\&quot;:\\&quot;bankAccount\\&quot;,\\n   \\&quot;bankAccount\\&quot;:{\\n      \\&quot;accountIdentification\\&quot;:{\\n         \\&quot;type\\&quot;:\\&quot;usLocal\\&quot;,\\n         \\&quot;accountNumber\\&quot;:\\&quot;0000000123\\&quot;,\\n         \\&quot;routingNumber\\&quot;:\\&quot;121202211\\&quot;\\n      }\\n   }\\n}'&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<p>The response returns the <span translate=\"no\"><strong>transferInstrument<\/strong><\/span> resource, identified by its unique <code>id<\/code>.<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Response'\" :id=\"'create-legalEntity-organization-response'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n  \\\"bankAccount\\\": {\\n    \\\"accountIdentification\\\": {\\n      \\\"type\\\": \\\"usLocal\\\",\\n      \\\"accountNumber\\\": \\\"0000000123\\\",\\n      \\\"routingNumber\\\": \\\"121202211\\\"\\n    },\\n    \\\"countryCode\\\": \\\"US\\\"\\n  },\\n  \\\"legalEntityId\\\": \\\"LE00000000000000000000001\\\",\\n  \\\"type\\\": \\\"bankAccount\\\",\\n  \\\"id\\\": \\\"SE00000000000000000000001\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<p>If we are not able to verify the bank account details, you will need to <a href=\"#upload-documents\">provide additional documents<\/a>.<\/p>\n<h2 id=\"create-business-lines\">Step 4: Create business lines<\/h2>\n<p>To submit the details of your user's business line information, make a POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/businessLines\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/businessLines<\/a>request specifying the following:<\/p>\n<table>\n<thead>\n<tr>\n<th>Parameter<\/th>\n<th style=\"text-align: center;\">Required<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/3\/post\/businessLines#request-service\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">service<\/a><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>The service for which you are creating the business line. Set this to <span translate=\"no\"><strong>paymentProcessing<\/strong><\/span>.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/businessLines#request-industryCode\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">industryCode<\/a><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>The industry code.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/businessLines#request-legalEntityId\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">legalEntityId<\/a><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>The unique identifier of the legal entity that has a contractual relationship with your platform. For example, for an individual who has a sole proprietorship business, this must be the legal entity ID of the individual.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/businessLines#request-salesChannels\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">salesChannels<\/a><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>Array of channels in which your user sells goods or services.<br>Possible values: <span translate=\"no\"><strong>eCommerce<\/strong><\/span>, <span translate=\"no\"><strong>ecomMoto<\/strong><\/span>, <span translate=\"no\"><strong>pos<\/strong><\/span>, <span translate=\"no\"><strong>posMoto<\/strong><\/span>, and <span translate=\"no\"><strong>payByLink<\/strong><\/span>. Sales channels may have different PCI DSS requirements. We recommend that you be familiar with these requirements before creating business lines for your user.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/businessLines#request-webData\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">webData<\/a><\/td>\n<td style=\"text-align: center;\"><\/td>\n<td>Required when <code>salesChannel<\/code> is <span translate=\"no\"><strong>eCommerce<\/strong><\/span>. The user's web address or the app store URL.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Create an ecommerce business line'\" :id=\"''\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/kyc-test.adyen.com\\\/lem\\\/v3\\\/businessLines \\\\\\n-H 'x-api-key: ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY' \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-X POST \\\\\\n-d '{\\n  \\&quot;service\\&quot;: \\&quot;paymentProcessing\\&quot;,\\n  \\&quot;industryCode\\&quot;: \\&quot;339E\\&quot;,\\n  \\&quot;salesChannels\\&quot;: [\\n    \\&quot;eCommerce\\&quot;,\\n    \\&quot;ecomMoto\\&quot;\\n  ],\\n  \\&quot;legalEntityId\\&quot;: \\&quot;LE322JV223222D5FZ9N74BSGM\\&quot;,\\n  \\&quot;webData\\&quot;: [\\n    {\\n      \\&quot;webAddress\\&quot;: \\&quot;https:\\\/\\\/yoururl.com\\&quot;\\n    }\\n  ]\\n}'&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<p>In the response, you receive the <code>id<\/code> of the business line. You will use this ID to <a href=\"#create-stores\">create store<\/a> and <a href=\"\/managed-model\/activate-merchant-account#payment-methods\">add payment methods<\/a>.<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Response'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n  \\\"service\\\": \\\"paymentProcessing\\\",\\n  \\\"industryCode\\\": \\\"339E\\\",\\n  \\\"legalEntityId\\\": \\\"LE322JV223222D5FZ9N74BSGM\\\",\\n  \\\"salesChannels\\\": [\\n    \\\"eCommerce\\\",\\n    \\\"ecomMoto\\\"\\n  ],\\n  \\\"webData\\\": [\\n    {\\n      \\\"webAddress\\\": \\\"https:\\\/\\\/yoururl.com\\\",\\n      \\\"webAddressId\\\": \\\"SE654AC923222F5H4CQGS77V4\\\"\\n    }\\n  ],\\n  \\\"id\\\": \\\"SE322KT223222D5FJ7TJN2986\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<h2 id=\"create-merchant-account\">Step 5: Create merchant account<\/h2>\n<p>Your user's payments are processed in sub-accounts of your company account, called merchant accounts. The merchant account is where they receive the payout of funds, as well as the reports used for reconciliation. It is also where you can configure their payment methods, processing currencies, and override risk management rules set at company level.<\/p>\n<p>To create a merchant account, make a POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/merchants\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/merchants<\/a> call, specifying:<\/p>\n<table>\n<thead>\n<tr>\n<th>Parameter<\/th>\n<th style=\"text-align: center;\">Required<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/merchants#request-businessLineId\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">businessLineId<\/a><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>The unique identifier of your user's  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/businessLines\" class=\" external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">business line<\/a>.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/merchants#request-companyId\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">companyId<\/a><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>The unique identifier of your company account.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/merchants#request-legalEntityId\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">legalEntityId<\/a><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>The unique identifier of the legal entity that has a contractual relationship with your platform. For example, for an individual who has a sole proprietorship business, this must be the legal entity ID of the individual.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/merchants#request-pricingPlan\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">pricingPlan<\/a><\/td>\n<td style=\"text-align: center;\"><\/td>\n<td>The previously agreed pricing plan for the merchant account. Your Adyen contact will provide the values that you can use.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/merchants#request-reference\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">reference<\/a><\/td>\n<td style=\"text-align: center;\"><\/td>\n<td>Your reference for the merchant account. If your company account has a template, then the reference is required and must be unique within the company account.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/merchants#request-description\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">description<\/a><\/td>\n<td style=\"text-align: center;\"><\/td>\n<td>Your description for the merchant account.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/merchants#request-salesChannels\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">salesChannels<\/a><\/td>\n<td style=\"text-align: center;\"><\/td>\n<td>The list of  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/businessLines#responses-200-salesChannels\" class=\" external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">sales channels<\/a> of your user's business line(s).<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Create a merchant account'\" :id=\"''\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/management-test.adyen.com\\\/v3\\\/merchants \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-H 'x-api-key: ADYEN_API_KEY' \\\\\\n-X POST \\\\\\n-d '{\\n  \\&quot;legalEntityId\\&quot;: \\&quot;LE00000000000000000000001\\&quot;,\\n  \\&quot;businessLineId\\&quot;: \\&quot;SE00000000000000000000001\\&quot;,\\n  \\&quot;companyId\\&quot;: \\&quot;YourCompany\\&quot;,\\n  \\&quot;pricingPlan\\&quot;: \\&quot;ic10\\&quot;,\\n  \\&quot;reference\\&quot;: \\&quot;PREFIX_12345678\\&quot;\\n}'&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<p>In the response, you receive the <code>id<\/code> of the merchant account. You will need to use this ID to <a href=\"#create-stores\">create stores<\/a> and to <a href=\"\/managed-model\/activate-merchant-account#activate-merchant-account\">activate<\/a> your user's account.<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Merchant account created'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n  \\\"reference\\\": \\\"PREFIX_12345678\\\",\\n  \\\"companyId\\\": \\\"YourCompany\\\",\\n  \\\"id\\\": \\\"PREFIX_12345678\\\",\\n  \\\"legalEntityId\\\": \\\"LE00000000000000000000001\\\",\\n  \\\"businessLineId\\\": \\\"SE00000000000000000000001\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<h2 id=\"security-questionnaire\">Step 6: Check security requirements<\/h2>\n<p>Because your users have a direct connection with card schemes, they must comply with the requirements laid down in the Payment Card Industry Data Security Standards (PCI DSS) for collecting, processing, storing, and transmitting cardholder data in a secure environment. To prove their compliance, they must sign a Self-Assessment Questionnaire (SAQ) before they can start processing card payments. The questionnaire asks them to confirm the security of their cardholder data environment, which typically includes their website, web servers, and employees who can access them.<\/p>\n<p>Listen to <a href=\"\/managed-model\/onboard-users\/api\/pci-forms#get-updates\">webhooks<\/a> to determine if your user needs to sign PCI questionnaires. You must <a href=\"\/managed-model\/onboard-users\/api\/pci-forms#generate-questionnaires\">generate the required security questionnaires<\/a> and ask your user to sign them.<\/p>\n<h2 id=\"terms-of-service\">Step 7: Determine the terms of service<\/h2>\n<p>Your users must accept Adyen's Terms of Service before they can perform particular actions in your platform. The type of the Terms of Service agreement depends on your specific integration.<\/p>\n<p>Listen to <a href=\"#get-updates-ah\">webhooks<\/a> to determine if your user needs to accept the Terms of Service. You must <a href=\"\/managed-model\/onboard-users\/api\/terms-of-service#get-document\">generate the required agreement type<\/a> and present it to your user, then ask them to accept it.<\/p>\n<h2 id=\"create-stores\">Step 8 (Optional): Create stores<\/h2>\n<p>If your user wants to accept in-person payments, you must create a store in their merchant account. A store ensures that the processed transactions correspond to an accurate payer statement.<\/p>\n<p>Stores are linked to the legal entity of your user through <a href=\"#create-business-lines\">business lines<\/a>. To create a store, you first need to collect from your user the address and phone number of the store, and the name of the store that will appear on the bank and credit card statements of customers.<\/p>\n<p>To create a store, make a POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/stores\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/stores<\/a> request, specifying:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter<\/th>\n<th style=\"text-align: center;\">Required<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/stores#request-address\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">address<\/a><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">An object that contains: <ul><li markdown=\"1\"><code>city<\/code>: the city of the store.<\/li> <li markdown=\"1\"><code>country<\/code>: the country of the store.<\/li> <li markdown=\"1\"><code>line1<\/code> <code>line2<\/code> <code>line3<\/code>: up to three lines can be used for the street name, street number, and other information. Only the first line is mandatory.<\/li> <li markdown=\"1\"><code>postalCode<\/code>: the postal code of the store.<\/li>  <li markdown=\"1\"><code>stateOrProvince<\/code>: <em>Required only for the United States.<\/em> The state or province of the store as defined in <a href=\"https:\/\/www.iso.org\/standard\/72483.html\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">ISO 3166-2<\/a>. For example, <span translate=\"no\"><strong>IL<\/strong><\/span> for Illinois.<\/li>  <\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/stores#request-description\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">description<\/a><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">A description for the store.<\/td>\n<td> <\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/stores#request-merchantId\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">merchantId<\/a><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">The merchant account ID.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/stores#request-phoneNumber\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">phoneNumber<\/a><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">The complete phone number of the store, beginning with <em>+<\/em> and the country code.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/stores#request-reference\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">reference<\/a><\/td>\n<td style=\"text-align: center;\"><\/td>\n<td style=\"text-align: left;\">A unique reference to recognize the store by. Allowed characters: Lowercase and uppercase letters without diacritics, numbers 0 through 9, hyphen (-), and underscore (_). <div class=\"sc-notice info\"><div> If you do not provide a reference in your POST request, it is populated with the Adyen-generated  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/stores#responses-200-id\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">id<\/a>. <\/div><\/div><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/stores#request-shopperStatement\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">shopperStatement<\/a><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">The store name shown on the shopper's bank or credit card statement and the shopper receipt. Maximum length: 22 characters. Cannot be all numerals.<\/td>\n<td> <\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>You can also make a POST request to  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/merchants\/(merchantId)\/stores\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/merchants\/{merchantId}\/stores<\/a> using the same parameters. In that case you do not need to include the merchant account ID in the request body.<\/p>\n<\/li>\n<\/ol>\n   \n<div id=\"tab2HLV9\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Create a store - general&quot;,&quot;content&quot;:&quot;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Create a store&#039;\\&quot; :id=\\&quot;&#039;create-store&#039;\\&quot; :code-data=\\&quot;[{&amp;quot;language&amp;quot;:&amp;quot;bash&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;curl&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;curl https:\\\\\/\\\\\/management-test.adyen.com\\\\\/v3\\\\\/stores \\\\\\\\\\\\n-H &#039;content-type: application\\\\\/json&#039; \\\\\\\\\\\\n-H &#039;x-api-key: ADYEN_API_KEY&#039; \\\\\\\\\\\\n-X POST \\\\\\\\\\\\n-d &#039;{\\\\n    \\\\&amp;quot;merchantId\\\\&amp;quot;:\\\\&amp;quot;MERCHANT_ACCOUNT_ID\\\\&amp;quot;,\\\\n    \\\\&amp;quot;description\\\\&amp;quot;:\\\\&amp;quot;City centre store\\\\&amp;quot;,\\\\n    \\\\&amp;quot;shopperStatement\\\\&amp;quot;: \\\\&amp;quot;Springfield Shop\\\\&amp;quot;,\\\\n    \\\\&amp;quot;phoneNumber\\\\&amp;quot;:\\\\&amp;quot;1813702551707653\\\\&amp;quot;,\\\\n    \\\\&amp;quot;reference\\\\&amp;quot;:\\\\&amp;quot;Spring_store_2\\\\&amp;quot;,\\\\n    \\\\&amp;quot;address\\\\&amp;quot;:{\\\\n        \\\\&amp;quot;country\\\\&amp;quot;: \\\\&amp;quot;US\\\\&amp;quot;,\\\\n        \\\\&amp;quot;line1\\\\&amp;quot;: \\\\&amp;quot;200 Main Street\\\\&amp;quot;,\\\\n        \\\\&amp;quot;line2\\\\&amp;quot;: \\\\&amp;quot;Building 5A\\\\&amp;quot;,\\\\n        \\\\&amp;quot;line3\\\\&amp;quot;:\\\\&amp;quot;Suite 3\\\\&amp;quot;,\\\\n        \\\\&amp;quot;city\\\\&amp;quot;: \\\\&amp;quot;Springfield\\\\&amp;quot;,\\\\n        \\\\&amp;quot;stateOrProvince\\\\&amp;quot;: \\\\&amp;quot;NY\\\\&amp;quot;,\\\\n        \\\\&amp;quot;postalCode\\\\&amp;quot;:\\\\&amp;quot;20250\\\\&amp;quot;\\\\n    }\\\\n}&#039;&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;java&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Java&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\/\\\\\/ Adyen Java API Library v38.0.0 to latest\\\\nimport com.adyen.Client;\\\\nimport com.adyen.Config;\\\\nimport com.adyen.enums.Environment;\\\\nimport com.adyen.model.*;\\\\nimport com.adyen.service.*;\\\\nimport java.math.*;\\\\nimport com.adyen.model.management.*;\\\\nimport java.time.OffsetDateTime;\\\\nimport java.util.*;\\\\nimport com.adyen.service.management.*;\\\\n\\\\nConfig config = new Config()\\\\n    .apiKey(\\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;)\\\\n    .environment(Environment.TEST);\\\\nClient client = new Client(config);\\\\n\\\\n\\\\\/\\\\\/ Create the request object(s)\\\\nStoreLocation storeLocation = new StoreLocation()\\\\n  .country(\\\\&amp;quot;US\\\\&amp;quot;)\\\\n  .stateOrProvince(\\\\&amp;quot;NY\\\\&amp;quot;)\\\\n  .city(\\\\&amp;quot;Springfield\\\\&amp;quot;)\\\\n  .postalCode(\\\\&amp;quot;20250\\\\&amp;quot;)\\\\n  .line3(\\\\&amp;quot;Suite 3\\\\&amp;quot;)\\\\n  .line2(\\\\&amp;quot;Building 5A\\\\&amp;quot;)\\\\n  .line1(\\\\&amp;quot;200 Main Street\\\\&amp;quot;);\\\\n\\\\nStoreCreationWithMerchantCodeRequest storeCreationWithMerchantCodeRequest = new StoreCreationWithMerchantCodeRequest()\\\\n  .reference(\\\\&amp;quot;Spring_store_2\\\\&amp;quot;)\\\\n  .phoneNumber(\\\\&amp;quot;1813702551707653\\\\&amp;quot;)\\\\n  .address(storeLocation)\\\\n  .merchantId(\\\\&amp;quot;MERCHANT_ACCOUNT_ID\\\\&amp;quot;)\\\\n  .description(\\\\&amp;quot;City centre store\\\\&amp;quot;)\\\\n  .shopperStatement(\\\\&amp;quot;Springfield Shop\\\\&amp;quot;);\\\\n\\\\n\\\\\/\\\\\/ Send the request\\\\nAccountStoreLevelApi service = new AccountStoreLevelApi(client);\\\\nStore response = service.createStore(storeCreationWithMerchantCodeRequest, null);&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;php&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;PHP&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;&amp;lt;?php\\\\n\\\\\/\\\\\/ Adyen PHP API Library v30.0.0 to latest\\\\nuse Adyen\\\\\\\\Client;\\\\nuse Adyen\\\\\\\\Environment;\\\\nuse Adyen\\\\\\\\Model\\\\\\\\Management\\\\\\\\StoreLocation;\\\\nuse Adyen\\\\\\\\Model\\\\\\\\Management\\\\\\\\StoreCreationWithMerchantCodeRequest;\\\\nuse Adyen\\\\\\\\Service\\\\\\\\Management\\\\\\\\AccountStoreLevelApi;\\\\n\\\\n$client = new Client();\\\\n$client-&amp;gt;setXApiKey(\\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;);\\\\n$client-&amp;gt;setEnvironment(Environment::TEST);\\\\n\\\\n\\\\n\\\\\/\\\\\/ Create the request object(s)\\\\n$storeLocation = new StoreLocation();\\\\n$storeLocation\\\\n  -&amp;gt;setCountry(\\\\&amp;quot;US\\\\&amp;quot;)\\\\n  -&amp;gt;setStateOrProvince(\\\\&amp;quot;NY\\\\&amp;quot;)\\\\n  -&amp;gt;setCity(\\\\&amp;quot;Springfield\\\\&amp;quot;)\\\\n  -&amp;gt;setPostalCode(\\\\&amp;quot;20250\\\\&amp;quot;)\\\\n  -&amp;gt;setLine3(\\\\&amp;quot;Suite 3\\\\&amp;quot;)\\\\n  -&amp;gt;setLine2(\\\\&amp;quot;Building 5A\\\\&amp;quot;)\\\\n  -&amp;gt;setLine1(\\\\&amp;quot;200 Main Street\\\\&amp;quot;);\\\\n\\\\n$storeCreationWithMerchantCodeRequest = new StoreCreationWithMerchantCodeRequest();\\\\n$storeCreationWithMerchantCodeRequest\\\\n  -&amp;gt;setReference(\\\\&amp;quot;Spring_store_2\\\\&amp;quot;)\\\\n  -&amp;gt;setPhoneNumber(\\\\&amp;quot;1813702551707653\\\\&amp;quot;)\\\\n  -&amp;gt;setAddress($storeLocation)\\\\n  -&amp;gt;setMerchantId(\\\\&amp;quot;MERCHANT_ACCOUNT_ID\\\\&amp;quot;)\\\\n  -&amp;gt;setDescription(\\\\&amp;quot;City centre store\\\\&amp;quot;)\\\\n  -&amp;gt;setShopperStatement(\\\\&amp;quot;Springfield Shop\\\\&amp;quot;);\\\\n\\\\n\\\\\/\\\\\/ Send the request\\\\n$service = new AccountStoreLevelApi($client);\\\\n$response = $service-&amp;gt;createStore($storeCreationWithMerchantCodeRequest);&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;cs&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;C#&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\/\\\\\/ Adyen .NET API Library v34.0.0 to latest\\\\nusing Adyen.Management.Extensions;\\\\nusing Adyen.Management.Models;\\\\nusing Adyen.Management.Services;\\\\nusing Adyen.Core.Client;\\\\nusing Adyen.Core.Client.Extensions;\\\\nusing Adyen.Core.Options;\\\\nusing Microsoft.Extensions.DependencyInjection;\\\\nusing Microsoft.Extensions.Hosting;\\\\n\\\\nvar host = Host.CreateDefaultBuilder()\\\\n    .ConfigureManagement(\\\\n        (context, services, config) =&amp;gt;\\\\n        {\\\\n            config.ConfigureAdyenOptions(options =&amp;gt;\\\\n            {\\\\n                options.AdyenApiKey = \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;;\\\\n                options.Environment = AdyenEnvironment.Test;\\\\n            });\\\\n            services.AddAllManagementServices();\\\\n        })\\\\n    .Build();\\\\n\\\\nvar accountStoreLevelService = host.Services.GetRequiredService&amp;lt;IAccountStoreLevelService&amp;gt;();\\\\n\\\\n\\\\\/\\\\\/ Create the request object(s)\\\\nvar storeLocation = new StoreLocation\\\\n{\\\\n    Country = \\\\&amp;quot;US\\\\&amp;quot;,\\\\n    StateOrProvince = \\\\&amp;quot;NY\\\\&amp;quot;,\\\\n    City = \\\\&amp;quot;Springfield\\\\&amp;quot;,\\\\n    PostalCode = \\\\&amp;quot;20250\\\\&amp;quot;,\\\\n    Line3 = \\\\&amp;quot;Suite 3\\\\&amp;quot;,\\\\n    Line2 = \\\\&amp;quot;Building 5A\\\\&amp;quot;,\\\\n    Line1 = \\\\&amp;quot;200 Main Street\\\\&amp;quot;\\\\n};\\\\n\\\\nvar storeCreationWithMerchantCodeRequest = new StoreCreationWithMerchantCodeRequest\\\\n{\\\\n    Reference = \\\\&amp;quot;Spring_store_2\\\\&amp;quot;,\\\\n    PhoneNumber = \\\\&amp;quot;1813702551707653\\\\&amp;quot;,\\\\n    Address = storeLocation,\\\\n    MerchantId = \\\\&amp;quot;MERCHANT_ACCOUNT_ID\\\\&amp;quot;,\\\\n    Description = \\\\&amp;quot;City centre store\\\\&amp;quot;,\\\\n    ShopperStatement = \\\\&amp;quot;Springfield Shop\\\\&amp;quot;\\\\n};\\\\n\\\\n\\\\\/\\\\\/ Send the request\\\\nvar result = await accountStoreLevelService.CreateStoreAsync(storeCreationWithMerchantCodeRequest);\\\\n\\\\nif (result.TryDeserializeOkResponse(out var response))\\\\n{\\\\n    \\\\\/\\\\\/ Handle the successful response.\\\\n}&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;js&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;NodeJS (JavaScript)&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\/\\\\\/ Adyen Node API Library v30.0.0 to latest\\\\nconst { Client, Config, EnvironmentEnum, ManagementAPI } = require(&#039;@adyen\\\\\/api-library&#039;);\\\\n\\\\nconst config = new Config({\\\\n  apiKey: \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;,\\\\n  environment: EnvironmentEnum.TEST\\\\n});\\\\n\\\\nconst client = new Client(config);\\\\n\\\\n\\\\\/\\\\\/ Create the request object(s)\\\\nconst storeLocation = {\\\\n  country: \\\\&amp;quot;US\\\\&amp;quot;,\\\\n  stateOrProvince: \\\\&amp;quot;NY\\\\&amp;quot;,\\\\n  city: \\\\&amp;quot;Springfield\\\\&amp;quot;,\\\\n  postalCode: \\\\&amp;quot;20250\\\\&amp;quot;,\\\\n  line3: \\\\&amp;quot;Suite 3\\\\&amp;quot;,\\\\n  line2: \\\\&amp;quot;Building 5A\\\\&amp;quot;,\\\\n  line1: \\\\&amp;quot;200 Main Street\\\\&amp;quot;\\\\n};\\\\n\\\\nconst storeCreationWithMerchantCodeRequest = {\\\\n  reference: \\\\&amp;quot;Spring_store_2\\\\&amp;quot;,\\\\n  phoneNumber: \\\\&amp;quot;1813702551707653\\\\&amp;quot;,\\\\n  address: storeLocation,\\\\n  merchantId: \\\\&amp;quot;MERCHANT_ACCOUNT_ID\\\\&amp;quot;,\\\\n  description: \\\\&amp;quot;City centre store\\\\&amp;quot;,\\\\n  shopperStatement: \\\\&amp;quot;Springfield Shop\\\\&amp;quot;\\\\n};\\\\n\\\\n\\\\\/\\\\\/ Send the request\\\\nconst managementAPI = new ManagementAPI(client);\\\\nconst response = await managementAPI.AccountStoreLevelApi.createStore(storeCreationWithMerchantCodeRequest);&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;go&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Go&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\/\\\\\/ Adyen Go API Library v21.0.0 to latest\\\\nimport (\\\\n  \\\\&amp;quot;context\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\/adyen\\\\\/adyen-go-api-library\\\\\/v21\\\\\/src\\\\\/common\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\/adyen\\\\\/adyen-go-api-library\\\\\/v21\\\\\/src\\\\\/adyen\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\/adyen\\\\\/adyen-go-api-library\\\\\/v21\\\\\/src\\\\\/management\\\\&amp;quot;\\\\n)\\\\nclient := adyen.NewClient(&amp;amp;common.Config{\\\\n  ApiKey:      \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;,\\\\n  Environment: common.TestEnv,\\\\n})\\\\n\\\\n\\\\\/\\\\\/ Create the request object(s)\\\\nstoreLocation := management.StoreLocation{\\\\n  Country: \\\\&amp;quot;US\\\\&amp;quot;,\\\\n  StateOrProvince: common.PtrString(\\\\&amp;quot;NY\\\\&amp;quot;),\\\\n  City: common.PtrString(\\\\&amp;quot;Springfield\\\\&amp;quot;),\\\\n  PostalCode: common.PtrString(\\\\&amp;quot;20250\\\\&amp;quot;),\\\\n  Line3: common.PtrString(\\\\&amp;quot;Suite 3\\\\&amp;quot;),\\\\n  Line2: common.PtrString(\\\\&amp;quot;Building 5A\\\\&amp;quot;),\\\\n  Line1: common.PtrString(\\\\&amp;quot;200 Main Street\\\\&amp;quot;),\\\\n}\\\\n\\\\nstoreCreationWithMerchantCodeRequest := management.StoreCreationWithMerchantCodeRequest{\\\\n  Reference: common.PtrString(\\\\&amp;quot;Spring_store_2\\\\&amp;quot;),\\\\n  PhoneNumber: \\\\&amp;quot;1813702551707653\\\\&amp;quot;,\\\\n  Address: storeLocation,\\\\n  MerchantId: \\\\&amp;quot;MERCHANT_ACCOUNT_ID\\\\&amp;quot;,\\\\n  Description: \\\\&amp;quot;City centre store\\\\&amp;quot;,\\\\n  ShopperStatement: \\\\&amp;quot;Springfield Shop\\\\&amp;quot;,\\\\n}\\\\n\\\\n\\\\\/\\\\\/ Send the request\\\\nservice := client.Management()\\\\nreq := service.AccountStoreLevelApi.CreateStoreInput().StoreCreationWithMerchantCodeRequest(storeCreationWithMerchantCodeRequest)\\\\nres, httpRes, err := service.AccountStoreLevelApi.CreateStore(context.Background(), req)&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;py&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Python&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;# Adyen Python API Library v14.0.0 to latest\\\\nimport Adyen\\\\n\\\\nadyen = Adyen.Adyen()\\\\nadyen.client.xapikey = \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;\\\\nadyen.client.platform = \\\\&amp;quot;test\\\\&amp;quot; # The environment to use library in.\\\\n\\\\n# Create the request object(s)\\\\njson_request = {\\\\n  \\\\&amp;quot;merchantId\\\\&amp;quot;: \\\\&amp;quot;MERCHANT_ACCOUNT_ID\\\\&amp;quot;,\\\\n  \\\\&amp;quot;description\\\\&amp;quot;: \\\\&amp;quot;City centre store\\\\&amp;quot;,\\\\n  \\\\&amp;quot;shopperStatement\\\\&amp;quot;: \\\\&amp;quot;Springfield Shop\\\\&amp;quot;,\\\\n  \\\\&amp;quot;phoneNumber\\\\&amp;quot;: \\\\&amp;quot;1813702551707653\\\\&amp;quot;,\\\\n  \\\\&amp;quot;reference\\\\&amp;quot;: \\\\&amp;quot;Spring_store_2\\\\&amp;quot;,\\\\n  \\\\&amp;quot;address\\\\&amp;quot;: {\\\\n    \\\\&amp;quot;country\\\\&amp;quot;: \\\\&amp;quot;US\\\\&amp;quot;,\\\\n    \\\\&amp;quot;line1\\\\&amp;quot;: \\\\&amp;quot;200 Main Street\\\\&amp;quot;,\\\\n    \\\\&amp;quot;line2\\\\&amp;quot;: \\\\&amp;quot;Building 5A\\\\&amp;quot;,\\\\n    \\\\&amp;quot;line3\\\\&amp;quot;: \\\\&amp;quot;Suite 3\\\\&amp;quot;,\\\\n    \\\\&amp;quot;city\\\\&amp;quot;: \\\\&amp;quot;Springfield\\\\&amp;quot;,\\\\n    \\\\&amp;quot;stateOrProvince\\\\&amp;quot;: \\\\&amp;quot;NY\\\\&amp;quot;,\\\\n    \\\\&amp;quot;postalCode\\\\&amp;quot;: \\\\&amp;quot;20250\\\\&amp;quot;\\\\n  }\\\\n}\\\\n\\\\n# Send the request\\\\nresult = adyen.management.account_store_level_api.create_store(request=json_request)&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;rb&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Ruby&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;# Adyen Ruby API Library v11.0.0 to latest\\\\nrequire \\\\&amp;quot;adyen-ruby-api-library\\\\&amp;quot;\\\\n\\\\nadyen = Adyen::Client.new\\\\nadyen.api_key = &#039;ADYEN_API_KEY&#039;\\\\nadyen.env = :test # Set to \\\\&amp;quot;live\\\\&amp;quot; for live environment\\\\n\\\\n# Create the request object(s)\\\\nrequest_body = {\\\\n  \\\\&amp;quot;merchantId\\\\&amp;quot; =&amp;gt; \\\\&amp;quot;MERCHANT_ACCOUNT_ID\\\\&amp;quot;,\\\\n  \\\\&amp;quot;description\\\\&amp;quot; =&amp;gt; \\\\&amp;quot;City centre store\\\\&amp;quot;,\\\\n  \\\\&amp;quot;shopperStatement\\\\&amp;quot; =&amp;gt; \\\\&amp;quot;Springfield Shop\\\\&amp;quot;,\\\\n  \\\\&amp;quot;phoneNumber\\\\&amp;quot; =&amp;gt; \\\\&amp;quot;1813702551707653\\\\&amp;quot;,\\\\n  \\\\&amp;quot;reference\\\\&amp;quot; =&amp;gt; \\\\&amp;quot;Spring_store_2\\\\&amp;quot;,\\\\n  \\\\&amp;quot;address\\\\&amp;quot; =&amp;gt; {\\\\n    \\\\&amp;quot;country\\\\&amp;quot; =&amp;gt; \\\\&amp;quot;US\\\\&amp;quot;,\\\\n    \\\\&amp;quot;line1\\\\&amp;quot; =&amp;gt; \\\\&amp;quot;200 Main Street\\\\&amp;quot;,\\\\n    \\\\&amp;quot;line2\\\\&amp;quot; =&amp;gt; \\\\&amp;quot;Building 5A\\\\&amp;quot;,\\\\n    \\\\&amp;quot;line3\\\\&amp;quot; =&amp;gt; \\\\&amp;quot;Suite 3\\\\&amp;quot;,\\\\n    \\\\&amp;quot;city\\\\&amp;quot; =&amp;gt; \\\\&amp;quot;Springfield\\\\&amp;quot;,\\\\n    \\\\&amp;quot;stateOrProvince\\\\&amp;quot; =&amp;gt; \\\\&amp;quot;NY\\\\&amp;quot;,\\\\n    \\\\&amp;quot;postalCode\\\\&amp;quot; =&amp;gt; \\\\&amp;quot;20250\\\\&amp;quot;\\\\n  }\\\\n}\\\\n\\\\n# Send the request\\\\nresult = adyen.management.account_store_level_api.create_store(request_body)&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;ts&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;NodeJS (TypeScript)&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\/\\\\\/ Adyen Node API Library v30.0.0 to latest\\\\nimport { Client, Config, EnvironmentEnum, ManagementAPI, Types } from \\\\&amp;quot;@adyen\\\\\/api-library\\\\&amp;quot;;\\\\n\\\\nconst config = new Config({\\\\n  apiKey: \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;,\\\\n  environment: EnvironmentEnum.TEST\\\\n});\\\\n\\\\nconst client = new Client(config);\\\\n\\\\n\\\\\/\\\\\/ Create the request object(s)\\\\nconst storeLocation: Types.management.StoreLocation = {\\\\n  country: \\\\&amp;quot;US\\\\&amp;quot;,\\\\n  stateOrProvince: \\\\&amp;quot;NY\\\\&amp;quot;,\\\\n  city: \\\\&amp;quot;Springfield\\\\&amp;quot;,\\\\n  postalCode: \\\\&amp;quot;20250\\\\&amp;quot;,\\\\n  line3: \\\\&amp;quot;Suite 3\\\\&amp;quot;,\\\\n  line2: \\\\&amp;quot;Building 5A\\\\&amp;quot;,\\\\n  line1: \\\\&amp;quot;200 Main Street\\\\&amp;quot;\\\\n};\\\\n\\\\nconst storeCreationWithMerchantCodeRequest: Types.management.StoreCreationWithMerchantCodeRequest = {\\\\n  reference: \\\\&amp;quot;Spring_store_2\\\\&amp;quot;,\\\\n  phoneNumber: \\\\&amp;quot;1813702551707653\\\\&amp;quot;,\\\\n  address: storeLocation,\\\\n  merchantId: \\\\&amp;quot;MERCHANT_ACCOUNT_ID\\\\&amp;quot;,\\\\n  description: \\\\&amp;quot;City centre store\\\\&amp;quot;,\\\\n  shopperStatement: \\\\&amp;quot;Springfield Shop\\\\&amp;quot;\\\\n};\\\\n\\\\n\\\\\/\\\\\/ Send the request\\\\nconst managementAPI = new ManagementAPI(client);\\\\nconst response = await managementAPI.AccountStoreLevelApi.createStore(storeCreationWithMerchantCodeRequest);&amp;quot;}]\\&quot; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\/code-sample&gt;\\n&lt;\/div&gt;\\n   &quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Create a store - Japan&quot;,&quot;content&quot;:&quot;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Create a Japanese store&#039;\\&quot; :id=\\&quot;&#039;create-store-japan&#039;\\&quot; :code-data=\\&quot;[{&amp;quot;language&amp;quot;:&amp;quot;bash&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;curl&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;curl https:\\\\\/\\\\\/management-test.adyen.com\\\\\/v3\\\\\/stores \\\\\\\\\\\\n-H &#039;content-type: application\\\\\/json&#039; \\\\\\\\\\\\n-H &#039;x-api-key: ADYEN_API_KEY&#039; \\\\\\\\\\\\n-X POST \\\\\\\\\\\\n-d &#039;{\\\\n    \\\\&amp;quot;merchantId\\\\&amp;quot;: \\\\&amp;quot;MERCHANT_ACCOUNT_ID\\\\&amp;quot;,\\\\n    \\\\&amp;quot;description\\\\&amp;quot;: \\\\&amp;quot;Tokyo Ginza store\\\\&amp;quot;,\\\\n    \\\\&amp;quot;shopperStatement\\\\&amp;quot;: \\\\&amp;quot;Adyen Co., Ltd.\\\\&amp;quot;,\\\\n    \\\\&amp;quot;localizedInformation\\\\&amp;quot;: {\\\\n        \\\\&amp;quot;localShopperStatement\\\\&amp;quot;: [\\\\n            {\\\\n                \\\\&amp;quot;script\\\\&amp;quot;: \\\\&amp;quot;ja-Hani\\\\&amp;quot;,\\\\n                \\\\&amp;quot;value\\\\&amp;quot;: \\\\&amp;quot;\\\\u30a2\\\\u30c7\\\\u30a3\\\\u30a8\\\\u30f3\\\\u682a\\\\u5f0f\\\\u4f1a\\\\u793e\\\\&amp;quot;\\\\n            },\\\\n            {\\\\n                \\\\&amp;quot;script\\\\&amp;quot;: \\\\&amp;quot;ja-Kana\\\\&amp;quot;,\\\\n                \\\\&amp;quot;value\\\\&amp;quot;: \\\\&amp;quot;\\\\uff71\\\\uff83\\\\uff9e\\\\uff68\\\\uff74\\\\uff9d\\\\uff7c\\\\uff9e\\\\uff6c\\\\uff8a\\\\uff9f\\\\uff9d\\\\&amp;quot;\\\\n            }\\\\n        ]\\\\n    },\\\\n    \\\\&amp;quot;phoneNumber\\\\&amp;quot;: \\\\&amp;quot;+81312345678\\\\&amp;quot;,\\\\n    \\\\&amp;quot;reference\\\\&amp;quot;: \\\\&amp;quot;Ginza_store_2\\\\&amp;quot;,\\\\n    \\\\&amp;quot;address\\\\&amp;quot;: {\\\\n        \\\\&amp;quot;country\\\\&amp;quot;: \\\\&amp;quot;JP\\\\&amp;quot;,\\\\n        \\\\&amp;quot;line1\\\\&amp;quot;: \\\\&amp;quot;Tokyo Central Ginza\\\\&amp;quot;,\\\\n        \\\\&amp;quot;line2\\\\&amp;quot;: \\\\&amp;quot;ACN Higashi Azabu Building Rokukai\\\\&amp;quot;,\\\\n        \\\\&amp;quot;city\\\\&amp;quot;: \\\\&amp;quot;Tokyo\\\\&amp;quot;,\\\\n        \\\\&amp;quot;postalCode\\\\&amp;quot;:\\\\&amp;quot;104-0061\\\\&amp;quot;\\\\n    }\\\\n}&#039;&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;java&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Java&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\/\\\\\/ Adyen Java API Library v38.0.0 to latest\\\\nimport com.adyen.Client;\\\\nimport com.adyen.Config;\\\\nimport com.adyen.enums.Environment;\\\\nimport com.adyen.model.*;\\\\nimport com.adyen.service.*;\\\\nimport java.math.*;\\\\nimport com.adyen.model.management.*;\\\\nimport java.time.OffsetDateTime;\\\\nimport java.util.*;\\\\nimport com.adyen.service.management.*;\\\\n\\\\nConfig config = new Config()\\\\n    .apiKey(\\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;)\\\\n    .environment(Environment.TEST);\\\\nClient client = new Client(config);\\\\n\\\\n\\\\\/\\\\\/ Create the request object(s)\\\\nLocalShopperStatement localShopperStatement1 = new LocalShopperStatement()\\\\n  .value(\\\\&amp;quot;\\\\u30a2\\\\u30c7\\\\u30a3\\\\u30a8\\\\u30f3\\\\u682a\\\\u5f0f\\\\u4f1a\\\\u793e\\\\&amp;quot;)\\\\n  .script(\\\\&amp;quot;ja-Hani\\\\&amp;quot;);\\\\n\\\\nLocalShopperStatement localShopperStatement2 = new LocalShopperStatement()\\\\n  .value(\\\\&amp;quot;\\\\uff71\\\\uff83\\\\uff9e\\\\uff68\\\\uff74\\\\uff9d\\\\uff7c\\\\uff9e\\\\uff6c\\\\uff8a\\\\uff9f\\\\uff9d\\\\&amp;quot;)\\\\n  .script(\\\\&amp;quot;ja-Kana\\\\&amp;quot;);\\\\n\\\\nStoreLocation storeLocation = new StoreLocation()\\\\n  .country(\\\\&amp;quot;JP\\\\&amp;quot;)\\\\n  .city(\\\\&amp;quot;Tokyo\\\\&amp;quot;)\\\\n  .postalCode(\\\\&amp;quot;104-0061\\\\&amp;quot;)\\\\n  .line2(\\\\&amp;quot;ACN Higashi Azabu Building Rokukai\\\\&amp;quot;)\\\\n  .line1(\\\\&amp;quot;Tokyo Central Ginza\\\\&amp;quot;);\\\\n\\\\nLocalizedInformation localizedInformation = new LocalizedInformation()\\\\n  .localShopperStatement(Arrays.asList(localShopperStatement1, localShopperStatement2));\\\\n\\\\nStoreCreationWithMerchantCodeRequest storeCreationWithMerchantCodeRequest = new StoreCreationWithMerchantCodeRequest()\\\\n  .reference(\\\\&amp;quot;Ginza_store_2\\\\&amp;quot;)\\\\n  .phoneNumber(\\\\&amp;quot;+81312345678\\\\&amp;quot;)\\\\n  .address(storeLocation)\\\\n  .merchantId(\\\\&amp;quot;MERCHANT_ACCOUNT_ID\\\\&amp;quot;)\\\\n  .description(\\\\&amp;quot;Tokyo Ginza store\\\\&amp;quot;)\\\\n  .shopperStatement(\\\\&amp;quot;Adyen Co., Ltd.\\\\&amp;quot;)\\\\n  .localizedInformation(localizedInformation);\\\\n\\\\n\\\\\/\\\\\/ Send the request\\\\nAccountStoreLevelApi service = new AccountStoreLevelApi(client);\\\\nStore response = service.createStore(storeCreationWithMerchantCodeRequest, null);&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;php&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;PHP&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;&amp;lt;?php\\\\n\\\\\/\\\\\/ Adyen PHP API Library v30.0.0 to latest\\\\nuse Adyen\\\\\\\\Client;\\\\nuse Adyen\\\\\\\\Environment;\\\\nuse Adyen\\\\\\\\Model\\\\\\\\Management\\\\\\\\StoreLocation;\\\\nuse Adyen\\\\\\\\Model\\\\\\\\Management\\\\\\\\LocalizedInformation;\\\\nuse Adyen\\\\\\\\Model\\\\\\\\Management\\\\\\\\LocalShopperStatement;\\\\nuse Adyen\\\\\\\\Model\\\\\\\\Management\\\\\\\\StoreCreationWithMerchantCodeRequest;\\\\nuse Adyen\\\\\\\\Service\\\\\\\\Management\\\\\\\\AccountStoreLevelApi;\\\\n\\\\n$client = new Client();\\\\n$client-&amp;gt;setXApiKey(\\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;);\\\\n$client-&amp;gt;setEnvironment(Environment::TEST);\\\\n\\\\n\\\\n\\\\\/\\\\\/ Create the request object(s)\\\\n$localShopperStatement1 = new LocalShopperStatement();\\\\n$localShopperStatement1\\\\n  -&amp;gt;setValue(\\\\&amp;quot;\\\\u30a2\\\\u30c7\\\\u30a3\\\\u30a8\\\\u30f3\\\\u682a\\\\u5f0f\\\\u4f1a\\\\u793e\\\\&amp;quot;)\\\\n  -&amp;gt;setScript(\\\\&amp;quot;ja-Hani\\\\&amp;quot;);\\\\n\\\\n$localShopperStatement2 = new LocalShopperStatement();\\\\n$localShopperStatement2\\\\n  -&amp;gt;setValue(\\\\&amp;quot;\\\\uff71\\\\uff83\\\\uff9e\\\\uff68\\\\uff74\\\\uff9d\\\\uff7c\\\\uff9e\\\\uff6c\\\\uff8a\\\\uff9f\\\\uff9d\\\\&amp;quot;)\\\\n  -&amp;gt;setScript(\\\\&amp;quot;ja-Kana\\\\&amp;quot;);\\\\n\\\\n$storeLocation = new StoreLocation();\\\\n$storeLocation\\\\n  -&amp;gt;setCountry(\\\\&amp;quot;JP\\\\&amp;quot;)\\\\n  -&amp;gt;setCity(\\\\&amp;quot;Tokyo\\\\&amp;quot;)\\\\n  -&amp;gt;setPostalCode(\\\\&amp;quot;104-0061\\\\&amp;quot;)\\\\n  -&amp;gt;setLine2(\\\\&amp;quot;ACN Higashi Azabu Building Rokukai\\\\&amp;quot;)\\\\n  -&amp;gt;setLine1(\\\\&amp;quot;Tokyo Central Ginza\\\\&amp;quot;);\\\\n\\\\n$localizedInformation = new LocalizedInformation();\\\\n$localizedInformation\\\\n  -&amp;gt;setLocalShopperStatement(array($localShopperStatement1, $localShopperStatement2));\\\\n\\\\n$storeCreationWithMerchantCodeRequest = new StoreCreationWithMerchantCodeRequest();\\\\n$storeCreationWithMerchantCodeRequest\\\\n  -&amp;gt;setReference(\\\\&amp;quot;Ginza_store_2\\\\&amp;quot;)\\\\n  -&amp;gt;setPhoneNumber(\\\\&amp;quot;+81312345678\\\\&amp;quot;)\\\\n  -&amp;gt;setAddress($storeLocation)\\\\n  -&amp;gt;setMerchantId(\\\\&amp;quot;MERCHANT_ACCOUNT_ID\\\\&amp;quot;)\\\\n  -&amp;gt;setDescription(\\\\&amp;quot;Tokyo Ginza store\\\\&amp;quot;)\\\\n  -&amp;gt;setShopperStatement(\\\\&amp;quot;Adyen Co., Ltd.\\\\&amp;quot;)\\\\n  -&amp;gt;setLocalizedInformation($localizedInformation);\\\\n\\\\n\\\\\/\\\\\/ Send the request\\\\n$service = new AccountStoreLevelApi($client);\\\\n$response = $service-&amp;gt;createStore($storeCreationWithMerchantCodeRequest);&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;cs&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;C#&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\/\\\\\/ Adyen .NET API Library v34.0.0 to latest\\\\nusing System.Collections.Generic;\\\\nusing Adyen.Management.Extensions;\\\\nusing Adyen.Management.Models;\\\\nusing Adyen.Management.Services;\\\\nusing Adyen.Core.Client;\\\\nusing Adyen.Core.Client.Extensions;\\\\nusing Adyen.Core.Options;\\\\nusing Microsoft.Extensions.DependencyInjection;\\\\nusing Microsoft.Extensions.Hosting;\\\\n\\\\nvar host = Host.CreateDefaultBuilder()\\\\n    .ConfigureManagement(\\\\n        (context, services, config) =&amp;gt;\\\\n        {\\\\n            config.ConfigureAdyenOptions(options =&amp;gt;\\\\n            {\\\\n                options.AdyenApiKey = \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;;\\\\n                options.Environment = AdyenEnvironment.Test;\\\\n            });\\\\n            services.AddAllManagementServices();\\\\n        })\\\\n    .Build();\\\\n\\\\nvar accountStoreLevelService = host.Services.GetRequiredService&amp;lt;IAccountStoreLevelService&amp;gt;();\\\\n\\\\n\\\\\/\\\\\/ Create the request object(s)\\\\nvar localShopperStatement1 = new LocalShopperStatement\\\\n{\\\\n    Value = \\\\&amp;quot;\\\\u30a2\\\\u30c7\\\\u30a3\\\\u30a8\\\\u30f3\\\\u682a\\\\u5f0f\\\\u4f1a\\\\u793e\\\\&amp;quot;,\\\\n    Script = \\\\&amp;quot;ja-Hani\\\\&amp;quot;\\\\n};\\\\n\\\\nvar localShopperStatement2 = new LocalShopperStatement\\\\n{\\\\n    Value = \\\\&amp;quot;\\\\uff71\\\\uff83\\\\uff9e\\\\uff68\\\\uff74\\\\uff9d\\\\uff7c\\\\uff9e\\\\uff6c\\\\uff8a\\\\uff9f\\\\uff9d\\\\&amp;quot;,\\\\n    Script = \\\\&amp;quot;ja-Kana\\\\&amp;quot;\\\\n};\\\\n\\\\nvar storeLocation = new StoreLocation\\\\n{\\\\n    Country = \\\\&amp;quot;JP\\\\&amp;quot;,\\\\n    City = \\\\&amp;quot;Tokyo\\\\&amp;quot;,\\\\n    PostalCode = \\\\&amp;quot;104-0061\\\\&amp;quot;,\\\\n    Line2 = \\\\&amp;quot;ACN Higashi Azabu Building Rokukai\\\\&amp;quot;,\\\\n    Line1 = \\\\&amp;quot;Tokyo Central Ginza\\\\&amp;quot;\\\\n};\\\\n\\\\nvar localizedInformation = new LocalizedInformation\\\\n{\\\\n    LocalShopperStatement = new List&amp;lt;LocalShopperStatement&amp;gt;{ localShopperStatement1, localShopperStatement2 }\\\\n};\\\\n\\\\nvar storeCreationWithMerchantCodeRequest = new StoreCreationWithMerchantCodeRequest\\\\n{\\\\n    Reference = \\\\&amp;quot;Ginza_store_2\\\\&amp;quot;,\\\\n    PhoneNumber = \\\\&amp;quot;+81312345678\\\\&amp;quot;,\\\\n    Address = storeLocation,\\\\n    MerchantId = \\\\&amp;quot;MERCHANT_ACCOUNT_ID\\\\&amp;quot;,\\\\n    Description = \\\\&amp;quot;Tokyo Ginza store\\\\&amp;quot;,\\\\n    ShopperStatement = \\\\&amp;quot;Adyen Co., Ltd.\\\\&amp;quot;,\\\\n    LocalizedInformation = localizedInformation\\\\n};\\\\n\\\\n\\\\\/\\\\\/ Send the request\\\\nvar result = await accountStoreLevelService.CreateStoreAsync(storeCreationWithMerchantCodeRequest);\\\\n\\\\nif (result.TryDeserializeOkResponse(out var response))\\\\n{\\\\n    \\\\\/\\\\\/ Handle the successful response.\\\\n}&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;js&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;NodeJS (JavaScript)&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\/\\\\\/ Adyen Node API Library v30.0.0 to latest\\\\nconst { Client, Config, EnvironmentEnum, ManagementAPI } = require(&#039;@adyen\\\\\/api-library&#039;);\\\\n\\\\nconst config = new Config({\\\\n  apiKey: \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;,\\\\n  environment: EnvironmentEnum.TEST\\\\n});\\\\n\\\\nconst client = new Client(config);\\\\n\\\\n\\\\\/\\\\\/ Create the request object(s)\\\\nconst localShopperStatement1 = {\\\\n  value: \\\\&amp;quot;\\\\u30a2\\\\u30c7\\\\u30a3\\\\u30a8\\\\u30f3\\\\u682a\\\\u5f0f\\\\u4f1a\\\\u793e\\\\&amp;quot;,\\\\n  script: \\\\&amp;quot;ja-Hani\\\\&amp;quot;\\\\n};\\\\n\\\\nconst localShopperStatement2 = {\\\\n  value: \\\\&amp;quot;\\\\uff71\\\\uff83\\\\uff9e\\\\uff68\\\\uff74\\\\uff9d\\\\uff7c\\\\uff9e\\\\uff6c\\\\uff8a\\\\uff9f\\\\uff9d\\\\&amp;quot;,\\\\n  script: \\\\&amp;quot;ja-Kana\\\\&amp;quot;\\\\n};\\\\n\\\\nconst storeLocation = {\\\\n  country: \\\\&amp;quot;JP\\\\&amp;quot;,\\\\n  city: \\\\&amp;quot;Tokyo\\\\&amp;quot;,\\\\n  postalCode: \\\\&amp;quot;104-0061\\\\&amp;quot;,\\\\n  line2: \\\\&amp;quot;ACN Higashi Azabu Building Rokukai\\\\&amp;quot;,\\\\n  line1: \\\\&amp;quot;Tokyo Central Ginza\\\\&amp;quot;\\\\n};\\\\n\\\\nconst localizedInformation = {\\\\n  localShopperStatement: [localShopperStatement1, localShopperStatement2]\\\\n};\\\\n\\\\nconst storeCreationWithMerchantCodeRequest = {\\\\n  reference: \\\\&amp;quot;Ginza_store_2\\\\&amp;quot;,\\\\n  phoneNumber: \\\\&amp;quot;+81312345678\\\\&amp;quot;,\\\\n  address: storeLocation,\\\\n  merchantId: \\\\&amp;quot;MERCHANT_ACCOUNT_ID\\\\&amp;quot;,\\\\n  description: \\\\&amp;quot;Tokyo Ginza store\\\\&amp;quot;,\\\\n  shopperStatement: \\\\&amp;quot;Adyen Co., Ltd.\\\\&amp;quot;,\\\\n  localizedInformation: localizedInformation\\\\n};\\\\n\\\\n\\\\\/\\\\\/ Send the request\\\\nconst managementAPI = new ManagementAPI(client);\\\\nconst response = await managementAPI.AccountStoreLevelApi.createStore(storeCreationWithMerchantCodeRequest);&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;go&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Go&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\/\\\\\/ Adyen Go API Library v21.0.0 to latest\\\\nimport (\\\\n  \\\\&amp;quot;context\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\/adyen\\\\\/adyen-go-api-library\\\\\/v21\\\\\/src\\\\\/common\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\/adyen\\\\\/adyen-go-api-library\\\\\/v21\\\\\/src\\\\\/adyen\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\/adyen\\\\\/adyen-go-api-library\\\\\/v21\\\\\/src\\\\\/management\\\\&amp;quot;\\\\n)\\\\nclient := adyen.NewClient(&amp;amp;common.Config{\\\\n  ApiKey:      \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;,\\\\n  Environment: common.TestEnv,\\\\n})\\\\n\\\\n\\\\\/\\\\\/ Create the request object(s)\\\\nlocalShopperStatement1 := management.LocalShopperStatement{\\\\n  Value: \\\\&amp;quot;\\\\u30a2\\\\u30c7\\\\u30a3\\\\u30a8\\\\u30f3\\\\u682a\\\\u5f0f\\\\u4f1a\\\\u793e\\\\&amp;quot;,\\\\n  Script: \\\\&amp;quot;ja-Hani\\\\&amp;quot;,\\\\n}\\\\n\\\\nlocalShopperStatement2 := management.LocalShopperStatement{\\\\n  Value: \\\\&amp;quot;\\\\uff71\\\\uff83\\\\uff9e\\\\uff68\\\\uff74\\\\uff9d\\\\uff7c\\\\uff9e\\\\uff6c\\\\uff8a\\\\uff9f\\\\uff9d\\\\&amp;quot;,\\\\n  Script: \\\\&amp;quot;ja-Kana\\\\&amp;quot;,\\\\n}\\\\n\\\\nstoreLocation := management.StoreLocation{\\\\n  Country: \\\\&amp;quot;JP\\\\&amp;quot;,\\\\n  City: common.PtrString(\\\\&amp;quot;Tokyo\\\\&amp;quot;),\\\\n  PostalCode: common.PtrString(\\\\&amp;quot;104-0061\\\\&amp;quot;),\\\\n  Line2: common.PtrString(\\\\&amp;quot;ACN Higashi Azabu Building Rokukai\\\\&amp;quot;),\\\\n  Line1: common.PtrString(\\\\&amp;quot;Tokyo Central Ginza\\\\&amp;quot;),\\\\n}\\\\n\\\\nlocalizedInformation := management.LocalizedInformation{\\\\n  LocalShopperStatement: []management.LocalShopperStatement{\\\\n      localShopperStatement1, localShopperStatement2,\\\\n  },\\\\n}\\\\n\\\\nstoreCreationWithMerchantCodeRequest := management.StoreCreationWithMerchantCodeRequest{\\\\n  Reference: common.PtrString(\\\\&amp;quot;Ginza_store_2\\\\&amp;quot;),\\\\n  PhoneNumber: \\\\&amp;quot;+81312345678\\\\&amp;quot;,\\\\n  Address: storeLocation,\\\\n  MerchantId: \\\\&amp;quot;MERCHANT_ACCOUNT_ID\\\\&amp;quot;,\\\\n  Description: \\\\&amp;quot;Tokyo Ginza store\\\\&amp;quot;,\\\\n  ShopperStatement: \\\\&amp;quot;Adyen Co., Ltd.\\\\&amp;quot;,\\\\n  LocalizedInformation: &amp;amp;localizedInformation,\\\\n}\\\\n\\\\n\\\\\/\\\\\/ Send the request\\\\nservice := client.Management()\\\\nreq := service.AccountStoreLevelApi.CreateStoreInput().StoreCreationWithMerchantCodeRequest(storeCreationWithMerchantCodeRequest)\\\\nres, httpRes, err := service.AccountStoreLevelApi.CreateStore(context.Background(), req)&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;py&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Python&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;# Adyen Python API Library v14.0.0 to latest\\\\nimport Adyen\\\\n\\\\nadyen = Adyen.Adyen()\\\\nadyen.client.xapikey = \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;\\\\nadyen.client.platform = \\\\&amp;quot;test\\\\&amp;quot; # The environment to use library in.\\\\n\\\\n# Create the request object(s)\\\\njson_request = {\\\\n  \\\\&amp;quot;merchantId\\\\&amp;quot;: \\\\&amp;quot;MERCHANT_ACCOUNT_ID\\\\&amp;quot;,\\\\n  \\\\&amp;quot;description\\\\&amp;quot;: \\\\&amp;quot;Tokyo Ginza store\\\\&amp;quot;,\\\\n  \\\\&amp;quot;shopperStatement\\\\&amp;quot;: \\\\&amp;quot;Adyen Co., Ltd.\\\\&amp;quot;,\\\\n  \\\\&amp;quot;localizedInformation\\\\&amp;quot;: {\\\\n    \\\\&amp;quot;localShopperStatement\\\\&amp;quot;: [{\\\\n      \\\\&amp;quot;script\\\\&amp;quot;: \\\\&amp;quot;ja-Hani\\\\&amp;quot;,\\\\n      \\\\&amp;quot;value\\\\&amp;quot;: \\\\&amp;quot;\\\\u30a2\\\\u30c7\\\\u30a3\\\\u30a8\\\\u30f3\\\\u682a\\\\u5f0f\\\\u4f1a\\\\u793e\\\\&amp;quot;\\\\n    }, {\\\\n      \\\\&amp;quot;script\\\\&amp;quot;: \\\\&amp;quot;ja-Kana\\\\&amp;quot;,\\\\n      \\\\&amp;quot;value\\\\&amp;quot;: \\\\&amp;quot;\\\\uff71\\\\uff83\\\\uff9e\\\\uff68\\\\uff74\\\\uff9d\\\\uff7c\\\\uff9e\\\\uff6c\\\\uff8a\\\\uff9f\\\\uff9d\\\\&amp;quot;\\\\n    }]\\\\n  },\\\\n  \\\\&amp;quot;phoneNumber\\\\&amp;quot;: \\\\&amp;quot;+81312345678\\\\&amp;quot;,\\\\n  \\\\&amp;quot;reference\\\\&amp;quot;: \\\\&amp;quot;Ginza_store_2\\\\&amp;quot;,\\\\n  \\\\&amp;quot;address\\\\&amp;quot;: {\\\\n    \\\\&amp;quot;country\\\\&amp;quot;: \\\\&amp;quot;JP\\\\&amp;quot;,\\\\n    \\\\&amp;quot;line1\\\\&amp;quot;: \\\\&amp;quot;Tokyo Central Ginza\\\\&amp;quot;,\\\\n    \\\\&amp;quot;line2\\\\&amp;quot;: \\\\&amp;quot;ACN Higashi Azabu Building Rokukai\\\\&amp;quot;,\\\\n    \\\\&amp;quot;city\\\\&amp;quot;: \\\\&amp;quot;Tokyo\\\\&amp;quot;,\\\\n    \\\\&amp;quot;postalCode\\\\&amp;quot;: \\\\&amp;quot;104-0061\\\\&amp;quot;\\\\n  }\\\\n}\\\\n\\\\n# Send the request\\\\nresult = adyen.management.account_store_level_api.create_store(request=json_request)&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;rb&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Ruby&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;# Adyen Ruby API Library v11.0.0 to latest\\\\nrequire \\\\&amp;quot;adyen-ruby-api-library\\\\&amp;quot;\\\\n\\\\nadyen = Adyen::Client.new\\\\nadyen.api_key = &#039;ADYEN_API_KEY&#039;\\\\nadyen.env = :test # Set to \\\\&amp;quot;live\\\\&amp;quot; for live environment\\\\n\\\\n# Create the request object(s)\\\\nrequest_body = {\\\\n  \\\\&amp;quot;merchantId\\\\&amp;quot; =&amp;gt; \\\\&amp;quot;MERCHANT_ACCOUNT_ID\\\\&amp;quot;,\\\\n  \\\\&amp;quot;description\\\\&amp;quot; =&amp;gt; \\\\&amp;quot;Tokyo Ginza store\\\\&amp;quot;,\\\\n  \\\\&amp;quot;shopperStatement\\\\&amp;quot; =&amp;gt; \\\\&amp;quot;Adyen Co., Ltd.\\\\&amp;quot;,\\\\n  \\\\&amp;quot;localizedInformation\\\\&amp;quot; =&amp;gt; {\\\\n    \\\\&amp;quot;localShopperStatement\\\\&amp;quot; =&amp;gt; [{\\\\n      \\\\&amp;quot;script\\\\&amp;quot; =&amp;gt; \\\\&amp;quot;ja-Hani\\\\&amp;quot;,\\\\n      \\\\&amp;quot;value\\\\&amp;quot; =&amp;gt; \\\\&amp;quot;\\\\u30a2\\\\u30c7\\\\u30a3\\\\u30a8\\\\u30f3\\\\u682a\\\\u5f0f\\\\u4f1a\\\\u793e\\\\&amp;quot;\\\\n    }, {\\\\n      \\\\&amp;quot;script\\\\&amp;quot; =&amp;gt; \\\\&amp;quot;ja-Kana\\\\&amp;quot;,\\\\n      \\\\&amp;quot;value\\\\&amp;quot; =&amp;gt; \\\\&amp;quot;\\\\uff71\\\\uff83\\\\uff9e\\\\uff68\\\\uff74\\\\uff9d\\\\uff7c\\\\uff9e\\\\uff6c\\\\uff8a\\\\uff9f\\\\uff9d\\\\&amp;quot;\\\\n    }]\\\\n  },\\\\n  \\\\&amp;quot;phoneNumber\\\\&amp;quot; =&amp;gt; \\\\&amp;quot;+81312345678\\\\&amp;quot;,\\\\n  \\\\&amp;quot;reference\\\\&amp;quot; =&amp;gt; \\\\&amp;quot;Ginza_store_2\\\\&amp;quot;,\\\\n  \\\\&amp;quot;address\\\\&amp;quot; =&amp;gt; {\\\\n    \\\\&amp;quot;country\\\\&amp;quot; =&amp;gt; \\\\&amp;quot;JP\\\\&amp;quot;,\\\\n    \\\\&amp;quot;line1\\\\&amp;quot; =&amp;gt; \\\\&amp;quot;Tokyo Central Ginza\\\\&amp;quot;,\\\\n    \\\\&amp;quot;line2\\\\&amp;quot; =&amp;gt; \\\\&amp;quot;ACN Higashi Azabu Building Rokukai\\\\&amp;quot;,\\\\n    \\\\&amp;quot;city\\\\&amp;quot; =&amp;gt; \\\\&amp;quot;Tokyo\\\\&amp;quot;,\\\\n    \\\\&amp;quot;postalCode\\\\&amp;quot; =&amp;gt; \\\\&amp;quot;104-0061\\\\&amp;quot;\\\\n  }\\\\n}\\\\n\\\\n# Send the request\\\\nresult = adyen.management.account_store_level_api.create_store(request_body)&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;ts&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;NodeJS (TypeScript)&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\/\\\\\/ Adyen Node API Library v30.0.0 to latest\\\\nimport { Client, Config, EnvironmentEnum, ManagementAPI, Types } from \\\\&amp;quot;@adyen\\\\\/api-library\\\\&amp;quot;;\\\\n\\\\nconst config = new Config({\\\\n  apiKey: \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;,\\\\n  environment: EnvironmentEnum.TEST\\\\n});\\\\n\\\\nconst client = new Client(config);\\\\n\\\\n\\\\\/\\\\\/ Create the request object(s)\\\\nconst localShopperStatement1: Types.management.LocalShopperStatement = {\\\\n  value: \\\\&amp;quot;\\\\u30a2\\\\u30c7\\\\u30a3\\\\u30a8\\\\u30f3\\\\u682a\\\\u5f0f\\\\u4f1a\\\\u793e\\\\&amp;quot;,\\\\n  script: \\\\&amp;quot;ja-Hani\\\\&amp;quot;\\\\n};\\\\n\\\\nconst localShopperStatement2: Types.management.LocalShopperStatement = {\\\\n  value: \\\\&amp;quot;\\\\uff71\\\\uff83\\\\uff9e\\\\uff68\\\\uff74\\\\uff9d\\\\uff7c\\\\uff9e\\\\uff6c\\\\uff8a\\\\uff9f\\\\uff9d\\\\&amp;quot;,\\\\n  script: \\\\&amp;quot;ja-Kana\\\\&amp;quot;\\\\n};\\\\n\\\\nconst storeLocation: Types.management.StoreLocation = {\\\\n  country: \\\\&amp;quot;JP\\\\&amp;quot;,\\\\n  city: \\\\&amp;quot;Tokyo\\\\&amp;quot;,\\\\n  postalCode: \\\\&amp;quot;104-0061\\\\&amp;quot;,\\\\n  line2: \\\\&amp;quot;ACN Higashi Azabu Building Rokukai\\\\&amp;quot;,\\\\n  line1: \\\\&amp;quot;Tokyo Central Ginza\\\\&amp;quot;\\\\n};\\\\n\\\\nconst localizedInformation: Types.management.LocalizedInformation = {\\\\n  localShopperStatement: [localShopperStatement1, localShopperStatement2]\\\\n};\\\\n\\\\nconst storeCreationWithMerchantCodeRequest: Types.management.StoreCreationWithMerchantCodeRequest = {\\\\n  reference: \\\\&amp;quot;Ginza_store_2\\\\&amp;quot;,\\\\n  phoneNumber: \\\\&amp;quot;+81312345678\\\\&amp;quot;,\\\\n  address: storeLocation,\\\\n  merchantId: \\\\&amp;quot;MERCHANT_ACCOUNT_ID\\\\&amp;quot;,\\\\n  description: \\\\&amp;quot;Tokyo Ginza store\\\\&amp;quot;,\\\\n  shopperStatement: \\\\&amp;quot;Adyen Co., Ltd.\\\\&amp;quot;,\\\\n  localizedInformation: localizedInformation\\\\n};\\\\n\\\\n\\\\\/\\\\\/ Send the request\\\\nconst managementAPI = new ManagementAPI(client);\\\\nconst response = await managementAPI.AccountStoreLevelApi.createStore(storeCreationWithMerchantCodeRequest);&amp;quot;}]\\&quot; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\/code-sample&gt;\\n&lt;\/div&gt;\\n   &quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='false'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\nThe response includes the Adyen-generated  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/stores#responses-200-id\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">id<\/a> for the store.<\/p>\n<\/li>\n<\/ol>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Store created'\" :id=\"''\" :code-data=\"[{&quot;language&quot;:&quot;json&quot;,&quot;tabTitle&quot;:&quot;&quot;,&quot;content&quot;:&quot;{\\n    \\&quot;id\\&quot;: \\&quot;ST322LJ223223K5F4SQNR9XL5\\&quot;,\\n    \\&quot;address\\&quot;:{\\n        \\&quot;country\\&quot;: \\&quot;US\\&quot;,\\n        \\&quot;line1\\&quot;: \\&quot;200 Main Street\\&quot;,\\n        \\&quot;line2\\&quot;: \\&quot;Building 5A\\&quot;,\\n        \\&quot;line3\\&quot;:\\&quot;Suite 3\\&quot;,\\n        \\&quot;city\\&quot;: \\&quot;Springfield\\&quot;,\\n        \\&quot;stateOrProvince\\&quot;: \\&quot;NY\\&quot;,\\n        \\&quot;postalCode\\&quot;:\\&quot;20250\\&quot;\\n    },\\n    \\&quot;description\\&quot;: \\&quot;City centre store\\&quot;,\\n    \\&quot;merchantId\\&quot;: \\&quot;MERCHANT_ACCOUNT_ID\\&quot;,\\n    \\&quot;phoneNumber\\&quot;: \\&quot;1813702551707653\\&quot;,\\n    \\&quot;reference\\&quot;: \\&quot;Spring_store_2\\&quot;,\\n    \\&quot;shopperStatement\\&quot;: \\&quot;Springfield Shop\\&quot;,\\n    \\&quot;status\\&quot;: \\&quot;active\\&quot;,\\n    \\&quot;_links\\&quot;: {\\n        \\&quot;self\\&quot;: {\\n            \\&quot;href\\&quot;: \\&quot;https:\\\/\\\/management-test.adyen.com\\\/latest\\\/stores\\\/ST322LJ223223K5F4SQNR9XL5\\&quot;\\n        }\\n    }\\n}'&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<\/ol>\n<h2 id=\"get-updates-ah\">Step 9: Get the verification results<\/h2>\n<p>To get updates about the verification status and results, listen to the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/ManagementNotification\/latest\/post\/merchant.updated\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">merchant.updated<\/a> webhook.<\/p>\n<p>The  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/ManagementNotification\/latest\/post\/merchant.updated\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">merchant.updated<\/a> webhook provides the status of the verification: valid, invalid, or rejected. The webhook examples below show when the verification is successful and when the capability is not allowed because the verification is invalid.<\/p>\n\n<div id=\"tabvud3y\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Successful verification&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;When the checks are completed successfully, Adyen sends a  &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/ManagementNotification\/latest\/post\/merchant.updated\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;merchant.updated&lt;\/a&gt; webhook with:&lt;\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt; &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/ManagementNotification\/latest\/post\/merchant.updated#request-data-capabilities-verificationStatus\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;verificationStatus&lt;\/a&gt;&amp;#58; Set to &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;valid&lt;\/strong&gt;&lt;\/span&gt;.&lt;\/li&gt;\\n&lt;li&gt; &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/ManagementNotification\/latest\/post\/merchant.updated#request-data-capabilities-allowed\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;allowed&lt;\/a&gt;&amp;#58; Set to &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;true&lt;\/strong&gt;&lt;\/span&gt;.&lt;\/li&gt;\\n&lt;\/ul&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Successful verification&#039;\\&quot; :id=\\&quot;&#039;&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n  \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;merchant.updated\\\\\\&quot;,\\\\n  \\\\\\&quot;environment\\\\\\&quot;: \\\\\\&quot;test\\\\\\&quot;,\\\\n  \\\\\\&quot;createdAt\\\\\\&quot;: \\\\\\&quot;2023-02-01T12:36:16+02:00\\\\\\&quot;,\\\\n  \\\\\\&quot;data\\\\\\&quot;: {\\\\n    \\\\\\&quot;capabilities\\\\\\&quot;: {\\\\n      \\\\\\&quot;sendToTransferInstrument\\\\\\&quot;: {\\\\n        \\\\\\&quot;allowed\\\\\\&quot;: \\\\\\&quot;true\\\\\\&quot;,\\\\n        \\\\\\&quot;verificationStatus\\\\\\&quot;: \\\\\\&quot;valid\\\\\\&quot;\\\\n      }\\\\n    },\\\\n    \\\\\\&quot;legalEntityId\\\\\\&quot;: \\\\\\&quot;Company.YourCompany:\\\\\/\\\\\/LE00000000000000000000001\\\\\\&quot;,\\\\n    \\\\\\&quot;merchantId\\\\\\&quot;: \\\\\\&quot;MC00000000000000000000001\\\\\\&quot;,\\\\n    \\\\\\&quot;status\\\\\\&quot;: \\\\\\&quot;PreActive\\\\\\&quot;\\\\n  }\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\/code-sample&gt;\\n&lt;\/div&gt;\\n&quot;,&quot;altTitle&quot;:&quot;verification-success&quot;,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Failed verification&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;When there are problems with the verification, Adyen sends a  &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/ManagementNotification\/latest\/post\/merchant.updated\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;merchant.updated&lt;\/a&gt; webhook with:&lt;\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt; &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/ManagementNotification\/latest\/post\/merchant.updated#request-data-capabilities-verificationStatus\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;verificationStatus&lt;\/a&gt;&amp;#58; Set to &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;invalid&lt;\/strong&gt;&lt;\/span&gt;.&lt;\/li&gt;\\n&lt;li&gt; &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/ManagementNotification\/latest\/post\/merchant.updated#request-data-capabilities-allowed\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;allowed&lt;\/a&gt;&amp;#58; Set to &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;false&lt;\/strong&gt;&lt;\/span&gt;.&lt;\/li&gt;\\n&lt;li&gt; &lt;a href=\\&quot;https:\/\/docs.adyen.com\/api-explorer\/ManagementNotification\/latest\/post\/merchant.updated#request-data-capabilities-problems\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;problems&lt;\/a&gt;&amp;#58; Contains the &lt;code&gt;entity&lt;\/code&gt; and &lt;code&gt;verificationErrors&lt;\/code&gt; arrays indicating which legal entity could not be verified and why.&lt;\/li&gt;\\n&lt;\/ul&gt;\\n&lt;p&gt;If the verification is unsuccessful, you must resolve the verification errors.&lt;\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Failed verification&#039;\\&quot; :id=\\&quot;&#039;verification-errors&#039;\\&quot; :code-data=\\&quot;[{&amp;quot;language&amp;quot;:&amp;quot;json&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;{\\\\n  \\\\&amp;quot;type\\\\&amp;quot;: \\\\&amp;quot;merchant.updated\\\\&amp;quot;,\\\\n  \\\\&amp;quot;environment\\\\&amp;quot;: \\\\&amp;quot;test\\\\&amp;quot;,\\\\n  \\\\&amp;quot;createdAt\\\\&amp;quot;: \\\\&amp;quot;2023-02-01T09:01:02+02:00\\\\&amp;quot;,\\\\n  \\\\&amp;quot;data\\\\&amp;quot;: {\\\\n    \\\\&amp;quot;capabilities\\\\&amp;quot;: {\\\\n      \\\\&amp;quot;receivePayments\\\\&amp;quot;: {\\\\n        \\\\&amp;quot;allowed\\\\&amp;quot;: \\\\&amp;quot;false\\\\&amp;quot;,\\\\n        \\\\&amp;quot;problems\\\\&amp;quot;: [\\\\n          {\\\\n            \\\\&amp;quot;entity\\\\&amp;quot;: {\\\\n              \\\\&amp;quot;id\\\\&amp;quot;: \\\\&amp;quot;LE00000000000000000000001\\\\&amp;quot;,\\\\n              \\\\&amp;quot;type\\\\&amp;quot;: \\\\&amp;quot;LegalEntity\\\\&amp;quot;\\\\n            },\\\\n            \\\\&amp;quot;verificationErrors\\\\&amp;quot;: [\\\\n              {\\\\n                \\\\&amp;quot;code\\\\&amp;quot;: \\\\&amp;quot;2_8069\\\\&amp;quot;,\\\\n                \\\\&amp;quot;message\\\\&amp;quot;: \\\\&amp;quot;&#039;organization.type&#039; was missing.\\\\&amp;quot;,\\\\n                \\\\&amp;quot;remediatingActions\\\\&amp;quot;: [\\\\n                  {\\\\n                    \\\\&amp;quot;code\\\\&amp;quot;: \\\\&amp;quot;2_125\\\\&amp;quot;,\\\\n                    \\\\&amp;quot;message\\\\&amp;quot;: \\\\&amp;quot;Add &#039;organization.type&#039; to legal entity\\\\&amp;quot;\\\\n                  }\\\\n                ],\\\\n                \\\\&amp;quot;type\\\\&amp;quot;: \\\\&amp;quot;dataMissing\\\\&amp;quot;\\\\n            ]\\\\n          }\\\\n        ],\\\\n        \\\\&amp;quot;verificationStatus\\\\&amp;quot;: \\\\&amp;quot;invalid\\\\&amp;quot;\\\\n      }\\\\n    },\\\\n    \\\\&amp;quot;legalEntityId\\\\&amp;quot;: \\\\&amp;quot;Company.YourCompany:\\\\\/\\\\\/LE00000000000000000000001\\\\&amp;quot;,\\\\n    \\\\&amp;quot;merchantId\\\\&amp;quot;: \\\\&amp;quot;MC00000000000000000000001\\\\&amp;quot;,\\\\n    \\\\&amp;quot;status\\\\&amp;quot;: \\\\&amp;quot;PreActive\\\\&amp;quot;\\\\n  }\\\\n}&amp;quot;}]\\&quot; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\/code-sample&gt;\\n&lt;\/div&gt;\\n&quot;,&quot;altTitle&quot;:&quot;verification-failed&quot;,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<h3 id=\"resolve-errors\">Resolve verification errors<\/h3>\n<p>If the webhook has a  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/balanceplatform\/latest\/get\/accountHolders\/(id)#responses-200-capabilities-problems\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">problems<\/a> array, check <a href=\"https:\/\/docs.adyen.com\/api-explorer\/balanceplatform\/latest\/get\/accountHolders\/(id)#responses-200-capabilities-problems-verificationErrors-remediatingActions\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">remediatingActions<\/a>. In this array, you'll find the actions that you can take to resolve the error, such as updating the data or uploading documents. Refer to verification error codes for a list of verification errors.<\/p>\n<p>Let's say that the legal entity's name changed and now their data must be updated. To do this, send a PATCH  <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.<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Update legal entity'\" :id=\"''\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/kyc-test.adyen.com\\\/lem\\\/v3\\\/legalEntities\\\/LE00000000000000000000001 \\\\\\n-H 'x-api-key: ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY' \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-X PATCH \\\\\\n-d '{\\n    \\&quot;individual\\&quot;: {\\n      \\&quot;name\\&quot;: {\\n        \\&quot;firstName\\&quot; : \\&quot;Shelly\\&quot;,\\n        \\&quot;lastName\\&quot; : \\&quot;Eller\\&quot;\\n       }\\n    }\\n}'&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<p>After you update the data, Adyen sends another webhook with the <code>verificationStatus<\/code> set to <span translate=\"no\"><strong>pending<\/strong><\/span>.<\/p>\n<p>Once again, you will get updates about the status of the verification from the webhook or by making an API request.<\/p>\n<h2 id=\"upload-documents\">Step 10 (Optional): Upload documents<\/h2>\n<p>Adyen attempts to verify the data that you provide. However, in some cases, the automatic verification might fail. This could be due to incorrect data or when the data cannot be verified. In these cases, Adyen may ask you to provide <a href=\"\/managed-model\/verification-requirements\/document-requirements\">additional documents<\/a>. Make sure your onboarding flow supports the collection of documents from users.<\/p>\n<p>For example, a remediating action code <span translate=\"no\"><strong>1_301<\/strong><\/span> indicates that you need to upload an ID document for the user.<\/p>\n<p><\/p>\n<p>To submit a document to Adyen:<\/p>\n<ol>\n<li>Collect the document from the account holder.<\/li>\n<li>Upload the document with a POST <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/documents\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/documents<\/a> request, specifying:<\/li>\n<\/ol>\n<table>\n<thead>\n<tr>\n<th>Parameter<\/th>\n<th style=\"text-align: center;\">Required<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/documents#request-attachments\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">attachments<\/a><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>Array that contains the document.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/documents#request-owner\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">owner<\/a><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>Object that contains the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/documents#request-owner-id\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">owner.id<\/a> of the resource that owns the document and the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/documents#request-owner-type\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">owner.type<\/a> of resource. For type <span translate=\"no\"><strong>legalEntity<\/strong><\/span>,  the <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities#responses-200-id\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">id<\/a> is the unique identifier of the legal entity. For type <span translate=\"no\"><strong>bankAccount<\/strong><\/span>, the <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/2\/post\/transferInstruments#responses-200-id\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">id<\/a> is the unique identifier of the transfer instrument.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/documents#request-type\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">type<\/a><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>The type of document that you can upload depends on the legal entity type. Refer to <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/documents#request-type\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">types<\/a> for a full list.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div class=\"notices green\">\n<p>The combination of <code>owner.id<\/code>, <code>type<\/code>, and <code>attachments.content<\/code> must be unique. If you have already submitted the same combination, you'll receive an error message. Either update the existing document resource, or delete the resource and create a new one.<\/p>\n<\/div>\n<p>Here is an example of how to upload an identity document for an individual:<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Upload documents'\" :id=\"'upload-documents-request'\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/kyc-test.adyen.com\\\/lem\\\/v3\\\/documents \\\\\\n-H 'x-api-key: ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY' \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-X POST \\\\\\n-d '{\\n      \\&quot;owner\\&quot; : {\\n        \\&quot;id\\&quot; : \\&quot;LE00000000000000000000001\\&quot;,\\n        \\&quot;type\\&quot; : \\&quot;legalEntity\\&quot;\\n      },\\n      \\&quot;description\\&quot; : \\&quot;ID for individual\\&quot;,\\n      \\&quot;type\\&quot; : \\&quot;identityCard\\&quot;,\\n      \\&quot;attachments\\&quot; : [\\n        {\\n          \\&quot;content\\&quot;: \\&quot;AAQSkZJRgABAQEAYABgAAD\\\/s..\\&quot;\\n        }\\n      ]\\n   }'&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<p>The response returns the <strong>document<\/strong> resource, identified by its unique <code>id<\/code>.<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Response'\" :id=\"'upload-documents-response'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n  \\\"type\\\": \\\"identityCard\\\",\\n  \\\"attachments\\\": [\\n    {\\n      \\\"content\\\": \\\"AAQSkZJRgABAQEAYABgAAD\\\/s..\\\"\\n    }\\n  ],\\n  \\\"description\\\": \\\"ID for individual\\\",\\n  \\\"owner\\\": {\\n    \\\"id\\\": \\\"LE00000000000000000000001\\\",\\n    \\\"type\\\": \\\"legalEntity\\\"\\n  },\\n  \\\"id\\\": \\\"SE00000000000000000000001\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<p>After you successfully upload the additional documents, wait for Adyen to inform you of the <a href=\"#get-updates-ah\">verification results<\/a>. Adyen validates documents asynchronously. On average, it takes about 30 seconds to validate a photo ID, and two days for registration documents and bank statements.<\/p>","url":"https:\/\/docs.adyen.com\/managed-model\/onboard-users\/api","articleFields":{"description":"Build your own UI and collect information from your users.","next_steps":[{"title":"Activate merchant account","description":"Configure your user's payment methods and payout settings, and activate their merchant account.","url":"\/managed-model\/activate-merchant-account","required":true}],"parameters":{"integrationType":"managed","onboardingType":"custom","directoryPath":"\/managed-model"},"feedback_component":true,"last_edit_on":"19-04-2023 13:53","filters_component":false},"algolia":{"url":"https:\/\/docs.adyen.com\/managed-model\/onboard-users\/api","title":"API-only onboarding","content":"To onboard users on your platform, you need to build your own UI where you collect data from your users and submit this data to Adyen. You can onboard users operating in any of the supported countries. On this page, we explain how you can onboard and verify your users using the  Legal Entity Management API.\nRequirements\nMake sure that:\n\nYou have API credentials for the  Legal Entity Management API and the  Management API.\nYou have reviewed the verification process and the required information for your users.\nYour server is properly configured to accept webhooks and you have subscribed to the Account data notifications in your Customer Area.\n\nStep 1: Create legal entities\nA  legal entity resource holds information required for the verification checks. You need to create a legal entity for the user that has a contractual relationship with your platform, and the individuals representing that entity.\nSelect a tab below to create a legal entity for your user:\n\n\n    \n        \n        \n    \n\n\nStep 2: Associate legal entities\n\n\n    \n        \n        \n    \n\n\nThe response contains the updated legal entity resource, identified by its unique id.\nStep 3: Create transfer instruments\nAdyen must perform checks on the bank account where your user will receive their payouts. We refer to this bank account as a  transfer instrument resource.\nCollect the required information and provide this in a POST \/transferInstruments request, specifying:\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\n type\n\nSet to bankAccount.\n\n\n legalEntityId\n\nUnique identifier of the legal entity that has the contractual relationship with your platform and owns the bank account. For sole proprietorships, this is the legal entity ID of the individual owner.\n\n\n bankAccount\n\nObject that contains required information about the legal entity's bank account.\n\n\n\nHere is an example request to add a transfer instrument for a bank account in the US:\n\n    \n\nThe response returns the transferInstrument resource, identified by its unique id.\n\n    \n\nIf we are not able to verify the bank account details, you will need to provide additional documents.\nStep 4: Create business lines\nTo submit the details of your user's business line information, make a POST  \/businessLinesrequest specifying the following:\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\nservice\n\nThe service for which you are creating the business line. Set this to paymentProcessing.\n\n\n industryCode\n\nThe industry code.\n\n\n legalEntityId\n\nThe unique identifier of the legal entity that has a contractual relationship with your platform. For example, for an individual who has a sole proprietorship business, this must be the legal entity ID of the individual.\n\n\n salesChannels\n\nArray of channels in which your user sells goods or services.Possible values: eCommerce, ecomMoto, pos, posMoto, and payByLink. Sales channels may have different PCI DSS requirements. We recommend that you be familiar with these requirements before creating business lines for your user.\n\n\n webData\n\nRequired when salesChannel is eCommerce. The user's web address or the app store URL.\n\n\n\n\n    \n\nIn the response, you receive the id of the business line. You will use this ID to create store and add payment methods.\n\n    \n\nStep 5: Create merchant account\nYour user's payments are processed in sub-accounts of your company account, called merchant accounts. The merchant account is where they receive the payout of funds, as well as the reports used for reconciliation. It is also where you can configure their payment methods, processing currencies, and override risk management rules set at company level.\nTo create a merchant account, make a POST  \/merchants call, specifying:\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\n businessLineId\n\nThe unique identifier of your user's  business line.\n\n\n companyId\n\nThe unique identifier of your company account.\n\n\n legalEntityId\n\nThe unique identifier of the legal entity that has a contractual relationship with your platform. For example, for an individual who has a sole proprietorship business, this must be the legal entity ID of the individual.\n\n\n pricingPlan\n\nThe previously agreed pricing plan for the merchant account. Your Adyen contact will provide the values that you can use.\n\n\n reference\n\nYour reference for the merchant account. If your company account has a template, then the reference is required and must be unique within the company account.\n\n\n description\n\nYour description for the merchant account.\n\n\n salesChannels\n\nThe list of  sales channels of your user's business line(s).\n\n\n\n\n    \n\nIn the response, you receive the id of the merchant account. You will need to use this ID to create stores and to activate your user's account.\n\n    \n\nStep 6: Check security requirements\nBecause your users have a direct connection with card schemes, they must comply with the requirements laid down in the Payment Card Industry Data Security Standards (PCI DSS) for collecting, processing, storing, and transmitting cardholder data in a secure environment. To prove their compliance, they must sign a Self-Assessment Questionnaire (SAQ) before they can start processing card payments. The questionnaire asks them to confirm the security of their cardholder data environment, which typically includes their website, web servers, and employees who can access them.\nListen to webhooks to determine if your user needs to sign PCI questionnaires. You must generate the required security questionnaires and ask your user to sign them.\nStep 7: Determine the terms of service\nYour users must accept Adyen's Terms of Service before they can perform particular actions in your platform. The type of the Terms of Service agreement depends on your specific integration.\nListen to webhooks to determine if your user needs to accept the Terms of Service. You must generate the required agreement type and present it to your user, then ask them to accept it.\nStep 8 (Optional): Create stores\nIf your user wants to accept in-person payments, you must create a store in their merchant account. A store ensures that the processed transactions correspond to an accurate payer statement.\nStores are linked to the legal entity of your user through business lines. To create a store, you first need to collect from your user the address and phone number of the store, and the name of the store that will appear on the bank and credit card statements of customers.\nTo create a store, make a POST  \/stores request, specifying:\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\n address\n\nAn object that contains: city: the city of the store. country: the country of the store. line1 line2 line3: up to three lines can be used for the street name, street number, and other information. Only the first line is mandatory. postalCode: the postal code of the store.  stateOrProvince: Required only for the United States. The state or province of the store as defined in ISO 3166-2. For example, IL for Illinois.  \n\n\n description\n\nA description for the store.\n \n\n\n merchantId\n\nThe merchant account ID.\n\n\n phoneNumber\n\nThe complete phone number of the store, beginning with + and the country code.\n\n\n reference\n\nA unique reference to recognize the store by. Allowed characters: Lowercase and uppercase letters without diacritics, numbers 0 through 9, hyphen (-), and underscore (_).  If you do not provide a reference in your POST request, it is populated with the Adyen-generated  id. \n\n\n shopperStatement\n\nThe store name shown on the shopper's bank or credit card statement and the shopper receipt. Maximum length: 22 characters. Cannot be all numerals.\n \n\n\n\nYou can also make a POST request to  \/merchants\/{merchantId}\/stores using the same parameters. In that case you do not need to include the merchant account ID in the request body.\n\n\n   \n\n    \n        \n        \n    \n\n\nThe response includes the Adyen-generated  id for the store.\n\n\n\n    \n\n\n\nStep 9: Get the verification results\nTo get updates about the verification status and results, listen to the  merchant.updated webhook.\nThe  merchant.updated webhook provides the status of the verification: valid, invalid, or rejected. The webhook examples below show when the verification is successful and when the capability is not allowed because the verification is invalid.\n\n\n    \n        \n        \n    \n\n\nResolve verification errors\nIf the webhook has a  problems array, check remediatingActions. In this array, you'll find the actions that you can take to resolve the error, such as updating the data or uploading documents. Refer to verification error codes for a list of verification errors.\nLet's say that the legal entity's name changed and now their data must be updated. To do this, send a PATCH  \/legalEntities\/{id}  request.\n\n    \n\nAfter you update the data, Adyen sends another webhook with the verificationStatus set to pending.\nOnce again, you will get updates about the status of the verification from the webhook or by making an API request.\nStep 10 (Optional): Upload documents\nAdyen attempts to verify the data that you provide. However, in some cases, the automatic verification might fail. This could be due to incorrect data or when the data cannot be verified. In these cases, Adyen may ask you to provide additional documents. Make sure your onboarding flow supports the collection of documents from users.\nFor example, a remediating action code 1_301 indicates that you need to upload an ID document for the user.\n\nTo submit a document to Adyen:\n\nCollect the document from the account holder.\nUpload the document with a POST \/documents request, specifying:\n\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\n attachments\n\nArray that contains the document.\n\n\n owner\n\nObject that contains the  owner.id of the resource that owns the document and the  owner.type of resource. For type legalEntity,  the id is the unique identifier of the legal entity. For type bankAccount, the id is the unique identifier of the transfer instrument.\n\n\n type\n\nThe type of document that you can upload depends on the legal entity type. Refer to types for a full list.\n\n\n\n\nThe combination of owner.id, type, and attachments.content must be unique. If you have already submitted the same combination, you'll receive an error message. Either update the existing document resource, or delete the resource and create a new one.\n\nHere is an example of how to upload an identity document for an individual:\n\n    \n\nThe response returns the document resource, identified by its unique id.\n\n    \n\nAfter you successfully upload the additional documents, wait for Adyen to inform you of the verification results. Adyen validates documents asynchronously. On average, it takes about 30 seconds to validate a photo ID, and two days for registration documents and bank statements.","type":"page","locale":"en","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Adyen for Platforms - Managed model","lvl2":"Onboard and verify users","lvl3":"API-only onboarding"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/managed-model","lvl2":"https:\/\/docs.adyen.com\/managed-model\/onboard-users","lvl3":"\/managed-model\/onboard-users\/api"},"levels":4,"category":"","category_color":"","tags":["API-only","onboarding"]}}