{"title":"Manage stores","category":"default","creationDate":1676901600,"content":"<p>Stores are linked to the legal entity of your user through business lines. Stores ensure that payments are processed in a compliant manner and each processed transaction has an accurate payer statement.<\/p>\n<p>For every payment processed through your user's store, you can split the funds between the balance accounts in your platform, including your liable balance account. You can split funds manually for each payment, or you can add a <a href=\"\/pt\/platforms\/automatic-split-configuration\/create-split-configuration\">split configuration profile<\/a> to your user's store to automatically split all payments processed through that store.<\/p>\n<p>This page contains instructions for common store operations, including how to:<\/p>\n<ul>\n<li><a href=\"#create-store\">Create a new store<\/a><\/li>\n<li><a href=\"#view-stores\">View store details<\/a><\/li>\n<li><a href=\"#update-store\">Update store information<\/a><\/li>\n<\/ul>\n<h2 id=\"store-identification\">Store identification<\/h2>\n<p>When you create a store, Adyen automatically assigns a unique ID to the store. You can also optionally provide a store reference for your reports. The store ID is unique to the entire Adyen platform, while the reference is only unique to your <a href=\"\/pt\/platforms\/account-structure-resources#your-adyen-account\">merchant account<\/a>. To update the store, you need to know the store ID.<\/p>\n<h2 id=\"store-statuses\">Store statuses<\/h2>\n<p>Stores can have three statuses that determine how they operate:<\/p>\n<ul>\n<li>\n<p><strong>Active<\/strong>: When you create a store, it is automatically set to <strong>active<\/strong>.  The store can then immediately process payments.  <\/p>\n<\/li>\n<li>\n<p><strong>Inactive<\/strong>: When you change the store status from <strong>active<\/strong> to <strong>inactive<\/strong>, the store is blocked from accepting new transactions, but capturing outstanding transactions is still possible.  When you change the store status back to <strong>active<\/strong>, this restriction is removed.<\/p>\n<\/li>\n<li>\n<p><strong>Closed<\/strong>: Before you can close a store, you must first change the store status to <strong>inactive<\/strong>.  It is not possible to change the status anymore because a closed store cannot be reopened.<\/p>\n<\/li>\n<\/ul>\n<h2 id=\"create-store\">Create a new store<\/h2>\n<p>During the initial onboarding process, you need to create a store for the user. Later, you might also need to create an additional store if the user wants to:<\/p>\n<ul>\n<li>Add a new store location or website.<\/li>\n<li>Operate in a new industry or offer additional services.<\/li>\n<\/ul>\n<p>You can create a store using the <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a> or 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>. The following tabs contain instructions for both options.<\/p>\n\n<div id=\"tabZ3avn\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Customer Area&quot;,&quot;content&quot;:&quot;\\n&lt;div class=\\&quot;notices green\\&quot;&gt;\\n&lt;p&gt;For platforms that utilize &lt;a href=\\&quot;\\\/pt\\\/platforms\\\/onboard-users?tab=onboarding-on-invite_1\\&quot;&gt;onboarding on invite&lt;\\\/a&gt;, this feature is enabled by default. For all other platforms, contact your Adyen representative to activate this feature in your Customer Area.&lt;\\\/p&gt;\\n&lt;\\\/div&gt;\\n&lt;p&gt;Before you begin, make sure you have the following &lt;a href=\\&quot;\\\/pt\\\/account\\\/user-roles\\&quot;&gt;user role&lt;\\\/a&gt;:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;&lt;strong&gt;Merchant POS terminal management admin&lt;\\\/strong&gt;&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;To create a store in the &lt;a href=\\&quot;https:\\\/\\\/ca-test.adyen.com\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Customer Area&lt;\\\/a&gt;:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;Go to &lt;strong&gt;Accounts &amp;amp; balances&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Account holders&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;In the &lt;strong&gt;Balance platform&lt;\\\/strong&gt; list, select the balance platform. You can view account holders from one balance platform at a time.&lt;\\\/li&gt;\\n&lt;li&gt;In the account holder table, select an Account holder ID to open the &lt;strong&gt;Account holder details&lt;\\\/strong&gt; page.&lt;\\\/li&gt;\\n&lt;li&gt;On the &lt;strong&gt;Account holder details&lt;\\\/strong&gt; page, select &lt;strong&gt;Stores&lt;\\\/strong&gt;, then &lt;strong&gt;Add store&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Review the country\\\/region of the new store. You can only create a new store in a country\\\/region that is already associated with the account holder. To open a store in a different country\\\/region, you must create a new account holder.&lt;\\\/li&gt;\\n&lt;li&gt;Provide information about the primary line of business for this store. You can either select from the industry codes that are already associated with this account holder or add a new one. To avoid duplicate entries, ensure that you create a unique business line for each combination of industry code and sales channel.&lt;\\\/li&gt;\\n&lt;li&gt;Review the website URL and the sales channels associated with the industry code you specified.&lt;\\\/li&gt;\\n&lt;li&gt;Select the sales channel that indicates the type of payments of this store.\\n&lt;ul&gt;\\n&lt;li&gt;For all sales channels, provide the reference of the store (also known as the store code) and a shopper statement.&lt;\\\/li&gt;\\n&lt;li&gt;For the &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;eCommerce&lt;\\\/strong&gt;&lt;\\\/span&gt; sales channel, include a phone number that shoppers can use to contact the store. Adyen automatically sets the store description as \\&quot;Ecommerce store for [Legal entity name]\\&quot;.&lt;\\\/li&gt;\\n&lt;li&gt;For the &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;pos&lt;\\\/strong&gt;&lt;\\\/span&gt; sales channel, include both the store&#039;s address and a phone number.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;&lt;\\\/li&gt;\\n&lt;li&gt;Provide the reference of the store (also known as the store code) and the shopper statement. If you choose to process in-person payments, you should also provide the address of the store.&lt;\\\/li&gt;\\n&lt;li&gt;Provide the reference of the store (also known as the store code) and the shopper statement.&lt;\\\/li&gt;\\n&lt;li&gt;(Optional) Select a &lt;a href=\\&quot;\\\/pt\\\/platforms\\\/automatic-split-configuration\\&quot;&gt;split configuration profile&lt;\\\/a&gt; to link to the store.&lt;\\\/li&gt;\\n&lt;li&gt;Review the default payment methods created based on the country\\\/region of the account holder. You can add or remove the available payment methods by selecting &lt;strong&gt;Edit payment methods&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Review the entered information, then select &lt;strong&gt;Add store&lt;\\\/strong&gt; to submit the request to Adyen.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:&quot;ca&quot;,&quot;oldTabId&quot;:&quot;CA-1_1&quot;,&quot;relation&quot;:&quot;ca&quot;},{&quot;title&quot;:&quot;API&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;Before you begin, you must:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;Have access to API credentials for the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Management\\\/latest\\\/overview\\&quot; class=\\&quot; external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;Management API&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Have the &lt;a href=\\&quot;\\\/pt\\\/development-resources\\\/api-credentials\\\/roles\\\/#management-api\\&quot;&gt;Management API-Stores read and write role&lt;\\\/a&gt; assigned to your API credential.&lt;\\\/li&gt;\\n&lt;li&gt;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 shoppers.&lt;\\\/li&gt;\\n&lt;li&gt;Know the merchant account ID and the business lines that the store will be associated with.\\n&lt;ul&gt;\\n&lt;li&gt;For a list of merchant account IDs accessible with your API key, make a GET request to  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Management\\\/latest\\\/get\\\/merchants\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/merchants&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;For a list of business lines, make a GET request to  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/legalentity\\\/latest\\\/get\\\/legalEntities\\\/(id)\\\/businessLines\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/legalEntities\\\/{id}\\\/businessLines&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;For a list of split configuration profiles created for your merchant account, make a GET request to  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Management\\\/latest\\\/get\\\/merchants\\\/(merchantId)\\\/splitConfigurations\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/merchants\\\/{merchantId}\\\/splitConfigurations&lt;\\\/a&gt;&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;To create a store:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;Collect the required information shown below from the user.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Make a POST  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Management\\\/latest\\\/post\\\/stores\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/stores&lt;\\\/a&gt; request, specifying:&lt;\\\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Parameter&lt;\\\/th&gt;\\n&lt;th style=\\&quot;text-align: center;\\&quot;&gt;Required&lt;\\\/th&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Description&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Management\\\/latest\\\/post\\\/stores#request-address\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;address&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 style=\\&quot;text-align: left;\\&quot;&gt;The address of the store.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Management\\\/latest\\\/post\\\/stores#request-description\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;description&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 style=\\&quot;text-align: left;\\&quot;&gt;A description for the store.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Management\\\/latest\\\/post\\\/stores#request-businessLineIds\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;businessLineIds&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The unique identifier of the business line that the store is associated with. If not specified, the business line of the merchant account is used. Required when there are multiple business lines under the merchant account. Only one businessLineId can be provided.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Management\\\/latest\\\/post\\\/stores#request-merchantId\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;merchantId&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 style=\\&quot;text-align: left;\\&quot;&gt;The merchant account ID.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Management\\\/latest\\\/post\\\/stores#request-phoneNumber\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;phoneNumber&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 style=\\&quot;text-align: left;\\&quot;&gt;The complete phone number of the store, beginning with + and the country code.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Management\\\/latest\\\/post\\\/stores#request-reference\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;reference&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;A 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.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Management\\\/latest\\\/post\\\/stores#request-shopperStatement\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;shopperStatement&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 style=\\&quot;text-align: left;\\&quot;&gt;The store name shown on the shopper&#039;s bank or credit card statement and the shopper receipt. Maximum length: 22 characters. Cannot be all numerals.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Management\\\/latest\\\/post\\\/stores#request-splitConfiguration\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;splitConfiguration&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;Rules for Adyen for Platforms merchants to split the transaction amount and fees.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/tbody&gt;\\n&lt;\\\/table&gt;\\n&lt;p&gt;You can also make a POST request to  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Management\\\/latest\\\/post\\\/merchants\\\/(merchantId)\\\/stores\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/merchants\\\/{merchantId}\\\/stores&lt;\\\/a&gt; using the same parameters. In that case you do not need to include the merchant account ID in the request body.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;In the response, note the following:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Management\\\/latest\\\/post\\\/stores#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;: the Adyen-generated ID for the store. You can use this as a path parameter to update the store&#039;s details. For more information, see &lt;a href=\\&quot;\\\/pt\\\/platforms\\\/manage-stores\\&quot;&gt;manage stores&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Management\\\/latest\\\/get\\\/stores\\\/(storeId)#responses-200-reference\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;reference&lt;\\\/a&gt;: a unique reference to the store. When making a  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/payments\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/payments&lt;\\\/a&gt; or  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/paymentMethods\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/paymentMethods&lt;\\\/a&gt; request, you need this reference to &lt;a href=\\&quot;\\\/pt\\\/platforms\\\/online-payments\\\/split-transactions\\\/split-payments-at-authorization\\&quot;&gt;route a payment to a store&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:&quot;api&quot;,&quot;oldTabId&quot;:&quot;API-1_2&quot;,&quot;relation&quot;:&quot;api&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<h2 id=\"view-stores\">View store details<\/h2>\n<p>After creating a store, you can view the resource at any time using the <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a> or 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>. The following tabs contain instructions for both options.<\/p>\n\n<div id=\"tabYC8vo\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Customer Area&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;Before you begin, make sure you have the following &lt;a href=\\&quot;\\\/pt\\\/account\\\/user-roles\\&quot;&gt;user role&lt;\\\/a&gt;:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;&lt;strong&gt;Balance platform base role&lt;\\\/strong&gt;&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;To view store details in the &lt;a href=\\&quot;https:\\\/\\\/ca-test.adyen.com\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Customer Area&lt;\\\/a&gt;:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;Go to &lt;strong&gt;Accounts &amp;amp; balances&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Account holders&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;In the &lt;strong&gt;Balance platform&lt;\\\/strong&gt; list, select the balance platform. You can view account holders from one balance platform at a time.&lt;\\\/li&gt;\\n&lt;li&gt;In the account holder table, select an Account holder ID to open the &lt;strong&gt;Account holder details&lt;\\\/strong&gt; page.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Stores&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Choose a store from the list to see the store details.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;p&gt;The &lt;strong&gt;Stores&lt;\\\/strong&gt; tab shows all the relevant details regarding stores, such as: &lt;strong&gt;Balance account&lt;\\\/strong&gt;, &lt;strong&gt;Merchant account ID&lt;\\\/strong&gt;, &lt;strong&gt;Sales channels&lt;\\\/strong&gt;, &lt;strong&gt;Store ID&lt;\\\/strong&gt;. You can choose the store details on the page by selecting the settings icon &lt;i class=\\&quot;adl-icon-settings\\&quot; role=\\&quot;img\\&quot; aria-label=\\&quot;settings icon\\&quot;&gt;&lt;\\\/i&gt;.&lt;\\\/p&gt;\\n&quot;,&quot;altTitle&quot;:&quot;ca&quot;,&quot;oldTabId&quot;:&quot;CA-2_1&quot;,&quot;relation&quot;:&quot;ca&quot;},{&quot;title&quot;:&quot;API&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;Before you begin, you must:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;Have access to API credentials for the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Management\\\/latest\\\/overview\\&quot; class=\\&quot; external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;Management API&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Have the &lt;a href=\\&quot;\\\/pt\\\/development-resources\\\/api-credentials\\\/roles\\\/#management-api\\&quot;&gt;Management API-Stores read role&lt;\\\/a&gt; assigned to your API credential.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&quot;,&quot;altTitle&quot;:&quot;api&quot;,&quot;oldTabId&quot;:&quot;API-2_2&quot;,&quot;relation&quot;:&quot;api&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<h2 id=\"update-store\">Update a store<\/h2>\n<p>You can update a store through the <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a> or 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>. Depending on the option you choose, you can make various changes.<\/p>\n<table>\n<thead>\n<tr>\n<th>Update method<\/th>\n<th>Available store operations<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a><\/td>\n<td><ul><li markdown=\"1\">Update your store information, including:<ul><li markdown=\"1\">Store description.<\/li><li markdown=\"1\">Store location and contact details.<\/li><li markdown=\"1\">Split configuration profile ID assigned to the store.<\/li><\/ul><\/li><li markdown=\"1\">Access your store's transaction descriptions and payment methods using the quick links.<\/li><li markdown=\"1\">Manage your store's status, with options to inactivate, reactivate, or close the store.<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td> <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><\/td>\n<td>Update your store information, including:<ul><li markdown=\"1\">Store description and the store ID.<\/li><li markdown=\"1\">Store location and contact details.<\/li><li markdown=\"1\">Split configuration profile ID assigned to the store.<\/li><li markdown=\"1\">Business line ID that the store is associated with.<\/li><\/ul>See the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/patch\/merchants\/(merchantId)\/stores\/(storeId)\" class=\" external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">full list of the available parameters<\/a> for more information.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>The following tabs contain instructions for both options.<\/p>\n\n<div id=\"tabolbPt\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Customer Area&quot;,&quot;content&quot;:&quot;\\n&lt;div class=\\&quot;notices green\\&quot;&gt;\\n&lt;p&gt;For platforms that utilize &lt;a href=\\&quot;\\\/pt\\\/platforms\\\/onboard-users?tab=onboarding-on-invite_1\\&quot;&gt;onboarding on invite&lt;\\\/a&gt;, this feature is enabled by default. For all other platforms, contact your Adyen representative to activate this feature in your Customer Area.&lt;\\\/p&gt;\\n&lt;\\\/div&gt;\\n&lt;p&gt;Before you begin, make sure you have the following &lt;a href=\\&quot;\\\/pt\\\/account\\\/user-roles\\&quot;&gt;user roles&lt;\\\/a&gt;:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;&lt;strong&gt;Merchant POS terminal management admin&lt;\\\/strong&gt;&lt;\\\/li&gt;\\n&lt;li&gt;(Optional) &lt;strong&gt;Change payment methods&lt;\\\/strong&gt;: This role is required to access your store&#039;s transaction descriptions.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;To update your store information in the &lt;a href=\\&quot;https:\\\/\\\/ca-test.adyen.com\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Customer Area&lt;\\\/a&gt;:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;Go to &lt;strong&gt;Accounts &amp;amp; balances&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Account holders&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;In the &lt;strong&gt;Balance platform&lt;\\\/strong&gt; list, select the balance platform. You can view account holders from one balance platform at a time.&lt;\\\/li&gt;\\n&lt;li&gt;In the account holder table, select an account holder ID to open the &lt;strong&gt;Account holder details&lt;\\\/strong&gt; page.&lt;\\\/li&gt;\\n&lt;li&gt;On the &lt;strong&gt;Account holder details&lt;\\\/strong&gt; page, select &lt;strong&gt;Stores&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;For the specific store in the list, select the options icon &lt;i class=\\&quot;adl-icon-options-vertical\\&quot;&gt;&lt;\\\/i&gt; and choose the desired action, such as:\\n&lt;ul&gt;\\n&lt;li&gt;&lt;strong&gt;Edit store details&lt;\\\/strong&gt;: This will open a modal window where you can update the store information.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;strong&gt;Go to transaction description&lt;\\\/strong&gt;: This will take you to the &lt;strong&gt;Transaction description&lt;\\\/strong&gt; page. Follow the &lt;a href=\\&quot;\\\/pt\\\/account\\\/transaction-description\\\/?tab=ca-2_1#customize-the-transaction-description\\&quot;&gt;instructions to customize the description&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;strong&gt;Go to payment methods&lt;\\\/strong&gt;: This will take you to the &lt;strong&gt;Payment methods&lt;\\\/strong&gt; page. Follow the &lt;a href=\\&quot;\\\/pt\\\/platforms\\\/payment-methods\\\/customer-area\\&quot;&gt;instructions to manage payment methods&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;&lt;\\\/li&gt;\\n&lt;li&gt;Verify and save your changes.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;p&gt;To manage the status of your store in your &lt;a href=\\&quot;https:\\\/\\\/ca-test.adyen.com\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Customer Area&lt;\\\/a&gt;:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;For the specific store, select the edit icon &lt;i class=\\&quot;adl-icon-edit\\&quot;&gt;&lt;\\\/i&gt; next to the store status.&lt;\\\/li&gt;\\n&lt;li&gt;Make the necessary changes to the &lt;a href=\\&quot;#store-statuses\\&quot;&gt;store status&lt;\\\/a&gt;, such as:\\n&lt;ul&gt;\\n&lt;li&gt;&lt;strong&gt;Deactivate&lt;\\\/strong&gt; an active store.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;strong&gt;Reactivate&lt;\\\/strong&gt; an inactive store.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;strong&gt;Close&lt;\\\/strong&gt; an inactive store. Note, that closing a store is permanent and cannot be undone.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;&lt;\\\/li&gt;\\n&lt;li&gt;When prompted, confirm your changes in the confirmation modal window.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:&quot;ca&quot;,&quot;oldTabId&quot;:&quot;CA-3_1&quot;,&quot;relation&quot;:&quot;ca&quot;},{&quot;title&quot;:&quot;API&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;Before you begin, you must:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;Have access to API credentials for the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Management\\\/latest\\\/overview\\&quot; class=\\&quot; external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;Management API&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Have the &lt;a href=\\&quot;\\\/pt\\\/development-resources\\\/api-credentials\\\/roles\\\/#management-api\\&quot;&gt;Management API-Stores read and write role&lt;\\\/a&gt; assigned to your API credential.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;To update a store, you need to know its &lt;a href=\\&quot;#store-identification\\&quot;&gt;unique store ID&lt;\\\/a&gt;. In your request, include only the parameters you want to update. The same applies if the parameter is inside an object.&lt;\\\/p&gt;\\n&lt;p&gt;For example, to change the postal code and remove the third address line from the store address, the &lt;code&gt;address&lt;\\\/code&gt; object should include the &lt;code&gt;postalCode&lt;\\\/code&gt; parameter with the new value, and the &lt;code&gt;line3&lt;\\\/code&gt; parameter with an empty value.&lt;\\\/p&gt;\\n&lt;p&gt;To update a store:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;Make sure that you know the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Management\\\/latest\\\/get\\\/stores#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; of the store. To find this value, get a &lt;a href=\\&quot;#get-all-stores\\&quot;&gt;list of stores&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;To update the store, use the following endpoints:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;PATCH  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Management\\\/latest\\\/patch\\\/stores\\\/(storeId)\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/stores\\\/{storeId}&lt;\\\/a&gt;&lt;\\\/li&gt;\\n&lt;li&gt;PATCH  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Management\\\/latest\\\/patch\\\/merchants\\\/(merchantId)\\\/stores\\\/(storeId)\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/merchants\\\/{merchantId}\\\/stores\\\/{storeId}&lt;\\\/a&gt;&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;In the request body, include any of the following parameters:&lt;\\\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Parameter&lt;\\\/th&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Description&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Management\\\/latest\\\/patch\\\/stores\\\/(storeId)#request-address\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;address&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;Can contain string values for the following parameters: &lt;ul&gt;&lt;li&gt;&lt;code&gt;city&lt;\\\/code&gt;: The city of the store.&lt;\\\/li&gt; &lt;li&gt;&lt;code&gt;line1&lt;\\\/code&gt; &lt;code&gt;line2&lt;\\\/code&gt; &lt;code&gt;line3&lt;\\\/code&gt;: Up to three lines can be used for the street name, street number, and other information. &lt;\\\/li&gt; &lt;li&gt;&lt;code&gt;postalCode&lt;\\\/code&gt;: The postal code of the store. Must be in the same postal code format as the country of the store. &lt;\\\/li&gt; &lt;li&gt;&lt;code&gt;stateOrProvince&lt;\\\/code&gt;: &lt;em&gt;Required only for the United States.&lt;\\\/em&gt; The state or province of the store as defined in &lt;a href=\\&quot;https:\\\/\\\/www.iso.org\\\/iso-3166-country-codes.html\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;ISO 3166-2&lt;\\\/a&gt;. For example, &lt;strong&gt;IL&lt;\\\/strong&gt; for Illinois in the United States.&lt;\\\/li&gt;&lt;\\\/ul&gt;  &lt;div class=\\&quot;notices green\\&quot;&gt;It is not possible to update the country of the store.&lt;\\\/div&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Management\\\/latest\\\/patch\\\/stores\\\/(storeId)#request-description\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;description&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;Your description of the store.&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Management\\\/latest\\\/patch\\\/stores\\\/(storeId)#request-businessLineIds\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;businessLineIds&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The unique identifier of the business line that the store is associated with. If not specified, the business line of the merchant account is used. Required when there are multiple business lines under the merchant account. Only one businessLineId can be provided.&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Management\\\/latest\\\/patch\\\/stores\\\/(storeId)#request-splitConfiguration\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;splitConfiguration&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; An object containing the information required to &lt;a href=\\&quot;\\\/pt\\\/platforms\\\/automatic-split-configuration\\&quot;&gt;automatically split transactions&lt;\\\/a&gt; that are routed through this store.&lt;p&gt;This object consists of: &lt;ul&gt;&lt;li&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Management\\\/latest\\\/post\\\/merchants\\\/(merchantId)\\\/splitConfigurations#responses-200-splitConfigurationId\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;splitConfigurationId&lt;\\\/a&gt;: the unique identifier of the &lt;a href=\\&quot;\\\/pt\\\/platforms\\\/automatic-split-configuration\\\/create-split-configuration\\&quot;&gt;split configuration&lt;\\\/a&gt; that you want to add to the store.&lt;\\\/li&gt;&lt;li&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/get\\\/accountHolders\\\/(id)\\\/balanceAccounts#responses-200-balanceAccounts-id\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;balanceAccountId&lt;\\\/a&gt;: The unique identifier of the balance account to which the split amount must be booked, depending on the defined  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Management\\\/latest\\\/post\\\/merchants\\\/(merchantId)\\\/splitConfigurations#request-rules-splitLogic\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;splitLogic&lt;\\\/a&gt;.&lt;\\\/li&gt;&lt;\\\/ul&gt;&lt;\\\/p&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Management\\\/latest\\\/patch\\\/stores\\\/(storeId)#request-status\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;status&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The &lt;a href=\\&quot;#store-status\\&quot;&gt;status&lt;\\\/a&gt; of the store. You can change the status from &lt;strong&gt;active&lt;\\\/strong&gt; to &lt;strong&gt;inactive&lt;\\\/strong&gt; or from &lt;strong&gt;inactive&lt;\\\/strong&gt; to &lt;strong&gt;active&lt;\\\/strong&gt; or &lt;strong&gt;closed&lt;\\\/strong&gt;. After a store is &lt;strong&gt;closed&lt;\\\/strong&gt;, you cannot change the status anymore.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/tbody&gt;\\n&lt;\\\/table&gt;\\n&lt;p&gt;This example shows how you update a store&#039;s street address and postal code, identifying the store by ID. The first two lines of the address are changed and the third line is removed by including an empty value:&lt;\\\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n&lt;code-sample :title=\\&quot;&#039;Update a store\\\\&#039;s address&#039;\\&quot; :id=\\&quot;&#039;update-store-address&#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\\\\\\\/ST322LJ223223K5F4SQNR9XL5 \\\\\\\\\\\\n-H &#039;content-type: application\\\\\\\/json&#039; \\\\\\\\\\\\n-H &#039;x-api-key: ADYEN_API_KEY&#039; \\\\\\\\\\\\n-X PATCH \\\\\\\\\\\\n-d &#039;{\\\\n   \\\\&amp;quot;address\\\\&amp;quot;:{\\\\n      \\\\&amp;quot;line1\\\\&amp;quot;: \\\\&amp;quot;1776 West Pinewood Avenue\\\\&amp;quot;,\\\\n      \\\\&amp;quot;line2\\\\&amp;quot;: \\\\&amp;quot;Heartland Building\\\\&amp;quot;,\\\\n      \\\\&amp;quot;line3\\\\&amp;quot;: \\\\&amp;quot;\\\\&amp;quot;,\\\\n      \\\\&amp;quot;postalCode\\\\&amp;quot;:\\\\&amp;quot;20251\\\\&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 v25.0.0\\\\nimport com.adyen.Client;\\\\nimport com.adyen.enums.Environment;\\\\nimport com.adyen.model.management.*;\\\\nimport java.time.OffsetDateTime;\\\\nimport java.util.*;\\\\nimport com.adyen.service.management.*;\\\\n\\\\nClient client = new Client(\\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;, Environment.TEST);\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\nUpdatableAddress updatableAddress = new UpdatableAddress()\\\\n  .postalCode(\\\\&amp;quot;20251\\\\&amp;quot;)\\\\n  .line3(\\\\&amp;quot;\\\\&amp;quot;)\\\\n  .line2(\\\\&amp;quot;Heartland Building\\\\&amp;quot;)\\\\n  .line1(\\\\&amp;quot;1776 West Pinewood Avenue\\\\&amp;quot;);\\\\n\\\\nUpdateStoreRequest updateStoreRequest = new UpdateStoreRequest()\\\\n  .address(updatableAddress);\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nAccountStoreLevelApi service = new AccountStoreLevelApi(client);\\\\nStore response = service.updateStoreById(\\\\&amp;quot;storeId\\\\&amp;quot;, updateStoreRequest, 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;\\\\\\\/\\\\\\\/ Adyen PHP API Library v17.4.0\\\\nuse Adyen\\\\\\\\Client;\\\\nuse Adyen\\\\\\\\Environment;\\\\nuse Adyen\\\\\\\\Model\\\\\\\\Management\\\\\\\\UpdatableAddress;\\\\nuse Adyen\\\\\\\\Model\\\\\\\\Management\\\\\\\\UpdateStoreRequest;\\\\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$updatableAddress = new UpdatableAddress();\\\\n$updatableAddress\\\\n  -&amp;gt;setPostalCode(\\\\&amp;quot;20251\\\\&amp;quot;)\\\\n  -&amp;gt;setLine3(\\\\&amp;quot;\\\\&amp;quot;)\\\\n  -&amp;gt;setLine2(\\\\&amp;quot;Heartland Building\\\\&amp;quot;)\\\\n  -&amp;gt;setLine1(\\\\&amp;quot;1776 West Pinewood Avenue\\\\&amp;quot;);\\\\n\\\\n$updateStoreRequest = new UpdateStoreRequest();\\\\n$updateStoreRequest\\\\n  -&amp;gt;setAddress($updatableAddress);\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\n$service = new AccountStoreLevelApi($client);\\\\n$response = $service-&amp;gt;updateStoreById(&#039;storeId&#039;, $updateStoreRequest);&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 v14.4.0\\\\nusing Adyen;\\\\nusing Environment = Adyen.Model.Environment;\\\\nusing Adyen.Model;\\\\nusing Adyen.Model.Management;\\\\nusing Adyen.Service.Management;\\\\n\\\\nvar config = new Config()\\\\n{\\\\n    XApiKey = \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;,\\\\n    Environment = Environment.Test\\\\n};\\\\nvar client = new Client(config);\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\nUpdatableAddress updatableAddress = new UpdatableAddress\\\\n{\\\\n  PostalCode = \\\\&amp;quot;20251\\\\&amp;quot;,\\\\n  Line3 = \\\\&amp;quot;\\\\&amp;quot;,\\\\n  Line2 = \\\\&amp;quot;Heartland Building\\\\&amp;quot;,\\\\n  Line1 = \\\\&amp;quot;1776 West Pinewood Avenue\\\\&amp;quot;\\\\n};\\\\n\\\\nUpdateStoreRequest updateStoreRequest = new UpdateStoreRequest\\\\n{\\\\n  Address = updatableAddress\\\\n};\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nvar service = new AccountStoreLevelService(client);\\\\nvar response = service.UpdateStoreById(\\\\&amp;quot;storeId\\\\&amp;quot;, updateStoreRequest);&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 v16.2.0\\\\n\\\\\\\/\\\\\\\/ Require the parts of the module you want to use\\\\nconst { Client, ManagementAPI } = require(&#039;@adyen\\\\\\\/api-library&#039;);\\\\n\\\\\\\/\\\\\\\/ Initialize the client object\\\\nconst client = new Client({apiKey: \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;, environment: \\\\&amp;quot;TEST\\\\&amp;quot;});\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\nconst updateStoreRequest = {\\\\n  address: {\\\\n    line1: \\\\&amp;quot;1776 West Pinewood Avenue\\\\&amp;quot;,\\\\n    line2: \\\\&amp;quot;Heartland Building\\\\&amp;quot;,\\\\n    line3: \\\\&amp;quot;\\\\&amp;quot;,\\\\n    postalCode: \\\\&amp;quot;20251\\\\&amp;quot;\\\\n  }\\\\n}\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nconst managementAPI = new ManagementAPI(client);\\\\nconst response = managementAPI.AccountStoreLevelApi.updateStoreById(\\\\&amp;quot;storeId\\\\&amp;quot;, updateStoreRequest);&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 v9.3.0\\\\nimport (\\\\n  \\\\&amp;quot;context\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\\\/adyen\\\\\\\/adyen-go-api-library\\\\\\\/v9\\\\\\\/src\\\\\\\/common\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\\\/adyen\\\\\\\/adyen-go-api-library\\\\\\\/v9\\\\\\\/src\\\\\\\/adyen\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\\\/adyen\\\\\\\/adyen-go-api-library\\\\\\\/v9\\\\\\\/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)\\\\nupdatableAddress := management.UpdatableAddress{\\\\n  PostalCode: common.PtrString(\\\\&amp;quot;20251\\\\&amp;quot;),\\\\n  Line3: common.PtrString(\\\\&amp;quot;\\\\&amp;quot;),\\\\n  Line2: common.PtrString(\\\\&amp;quot;Heartland Building\\\\&amp;quot;),\\\\n  Line1: common.PtrString(\\\\&amp;quot;1776 West Pinewood Avenue\\\\&amp;quot;),\\\\n}\\\\n\\\\nupdateStoreRequest := management.UpdateStoreRequest{\\\\n  Address: &amp;amp;updatableAddress,\\\\n}\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nservice := client.Management()\\\\nreq := service.AccountStoreLevelApi.UpdateStoreByIdInput(\\\\&amp;quot;storeId\\\\&amp;quot;).UpdateStoreRequest(updateStoreRequest)\\\\nres, httpRes, err := service.AccountStoreLevelApi.UpdateStoreById(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 v12.2.0\\\\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;address\\\\&amp;quot;: {\\\\n    \\\\&amp;quot;line1\\\\&amp;quot;: \\\\&amp;quot;1776 West Pinewood Avenue\\\\&amp;quot;,\\\\n    \\\\&amp;quot;line2\\\\&amp;quot;: \\\\&amp;quot;Heartland Building\\\\&amp;quot;,\\\\n    \\\\&amp;quot;line3\\\\&amp;quot;: \\\\&amp;quot;\\\\&amp;quot;,\\\\n    \\\\&amp;quot;postalCode\\\\&amp;quot;: \\\\&amp;quot;20251\\\\&amp;quot;\\\\n  }\\\\n}\\\\n\\\\n# Make the API call\\\\nresult = adyen.management.account_store_level_api.update_store_by_id(request=json_request, storeId=\\\\&amp;quot;storeId\\\\&amp;quot;)&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 v9.3.0\\\\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  :address =&amp;gt; {\\\\n    :line1 =&amp;gt; &#039;1776 West Pinewood Avenue&#039;,\\\\n    :line2 =&amp;gt; &#039;Heartland Building&#039;,\\\\n    :line3 =&amp;gt; &#039;&#039;,\\\\n    :postalCode =&amp;gt; &#039;20251&#039;\\\\n  }\\\\n}\\\\n\\\\n# Make the API call\\\\nresult = adyen.management.account_store_level_api.update_store_by_id(request_body, &#039;storeId&#039;)&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 v16.2.0\\\\n\\\\\\\/\\\\\\\/ Require the parts of the module you want to use\\\\nimport { Client, ManagementAPI, Types } from \\\\&amp;quot;@adyen\\\\\\\/api-library\\\\&amp;quot;;\\\\n\\\\\\\/\\\\\\\/ Initialize the client object\\\\nconst client = new Client({apiKey: \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;, environment: \\\\&amp;quot;TEST\\\\&amp;quot;});\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\nconst updatableAddress: Types.management.UpdatableAddress = {\\\\n  postalCode: \\\\&amp;quot;20251\\\\&amp;quot;,\\\\n  line3: \\\\&amp;quot;\\\\&amp;quot;,\\\\n  line2: \\\\&amp;quot;Heartland Building\\\\&amp;quot;,\\\\n  line1: \\\\&amp;quot;1776 West Pinewood Avenue\\\\&amp;quot;\\\\n};\\\\n\\\\nconst updateStoreRequest: Types.management.UpdateStoreRequest = {\\\\n  address: updatableAddress\\\\n};\\\\n\\\\n\\\\\\\/\\\\\\\/ Make the API call\\\\nconst managementAPI = new ManagementAPI(client);\\\\nconst response = managementAPI.AccountStoreLevelApi.updateStoreById(\\\\&amp;quot;storeId\\\\&amp;quot;, updateStoreRequest);&amp;quot;}]\\&quot; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Note that the response includes the full store details.&lt;\\\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n&lt;code-sample :title=\\&quot;&#039;Store address updated&#039;\\&quot; :id=\\&quot;&#039;&#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;id\\\\&amp;quot;: \\\\&amp;quot;ST322LJ223223K5F4SQNR9XL5\\\\&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;1776 West Pinewood Avenue\\\\&amp;quot;,\\\\n        \\\\&amp;quot;line2\\\\&amp;quot;: \\\\&amp;quot;Heartland Building\\\\&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;20251\\\\&amp;quot;\\\\n    },\\\\n    \\\\&amp;quot;description\\\\&amp;quot;: \\\\&amp;quot;City Centre store\\\\&amp;quot;,\\\\n    \\\\&amp;quot;merchantId\\\\&amp;quot;: \\\\&amp;quot;YOUR_MERCHANT_ACCOUNT_ID\\\\&amp;quot;,\\\\n    \\\\&amp;quot;phoneNumber\\\\&amp;quot;: \\\\&amp;quot;+13121112222\\\\&amp;quot;,\\\\n    \\\\&amp;quot;reference\\\\&amp;quot;: \\\\&amp;quot;Spring_store_2\\\\&amp;quot;,\\\\n    \\\\&amp;quot;status\\\\&amp;quot;: \\\\&amp;quot;active\\\\&amp;quot;,\\\\n    \\\\&amp;quot;_links\\\\&amp;quot;: {\\\\n        \\\\&amp;quot;self\\\\&amp;quot;: {\\\\n            \\\\&amp;quot;href\\\\&amp;quot;: \\\\&amp;quot;https:\\\\\\\/\\\\\\\/management-test.adyen.com\\\\\\\/latest\\\\\\\/stores\\\\\\\/ST322LJ223223K5F4SQNR9XL5\\\\&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;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:&quot;api&quot;,&quot;oldTabId&quot;:&quot;API-3_2&quot;,&quot;relation&quot;:&quot;api&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/platforms\/manage-stores","articleFields":{"description":"Learn how to manage stores for your users.","feedback_component":true,"next_steps":[{"title":"Payment methods","description":"Add payment methods to your users' stores.","url":"\/platforms\/payment-methods","required":true},{"title":"Route payments to a store","description":"Learn how to process a payment through your users' stores.","url":"\/platforms\/online-payments\/split-transactions\/split-payments-at-authorization#route-payment-to-store","required":false}],"parameters":{"directoryPath":"\/platforms","model":"platform"},"id":"25142904","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"19-06-2025 09:05","page_id":"b2209892-aeba-40bd-874b-286e786a5c63","filters_component":false,"decision_tree":"[]"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/platforms\/manage-stores","title":"Manage stores","content":"Stores are linked to the legal entity of your user through business lines. Stores ensure that payments are processed in a compliant manner and each processed transaction has an accurate payer statement.\nFor every payment processed through your user's store, you can split the funds between the balance accounts in your platform, including your liable balance account. You can split funds manually for each payment, or you can add a split configuration profile to your user's store to automatically split all payments processed through that store.\nThis page contains instructions for common store operations, including how to:\n\nCreate a new store\nView store details\nUpdate store information\n\nStore identification\nWhen you create a store, Adyen automatically assigns a unique ID to the store. You can also optionally provide a store reference for your reports. The store ID is unique to the entire Adyen platform, while the reference is only unique to your merchant account. To update the store, you need to know the store ID.\nStore statuses\nStores can have three statuses that determine how they operate:\n\n\nActive: When you create a store, it is automatically set to active.  The store can then immediately process payments.  \n\n\nInactive: When you change the store status from active to inactive, the store is blocked from accepting new transactions, but capturing outstanding transactions is still possible.  When you change the store status back to active, this restriction is removed.\n\n\nClosed: Before you can close a store, you must first change the store status to inactive.  It is not possible to change the status anymore because a closed store cannot be reopened.\n\n\nCreate a new store\nDuring the initial onboarding process, you need to create a store for the user. Later, you might also need to create an additional store if the user wants to:\n\nAdd a new store location or website.\nOperate in a new industry or offer additional services.\n\nYou can create a store using the Customer Area or the  Management API. The following tabs contain instructions for both options.\n\n\n    \n        \n        \n    \n\n\nView store details\nAfter creating a store, you can view the resource at any time using the Customer Area or the  Management API. The following tabs contain instructions for both options.\n\n\n    \n        \n        \n    \n\n\nUpdate a store\nYou can update a store through the Customer Area or the  Management API. Depending on the option you choose, you can make various changes.\n\n\n\nUpdate method\nAvailable store operations\n\n\n\n\nCustomer Area\nUpdate your store information, including:Store description.Store location and contact details.Split configuration profile ID assigned to the store.Access your store's transaction descriptions and payment methods using the quick links.Manage your store's status, with options to inactivate, reactivate, or close the store.\n\n\n Management API\nUpdate your store information, including:Store description and the store ID.Store location and contact details.Split configuration profile ID assigned to the store.Business line ID that the store is associated with.See the  full list of the available parameters for more information.\n\n\n\nThe following tabs contain instructions for both options.\n\n\n    \n        \n        \n    \n\n","type":"page","locale":"pt","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Platforms","lvl2":"Manage stores"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/platforms","lvl2":"\/pt\/platforms\/manage-stores"},"levels":3,"category":"Platforms","category_color":"green","tags":["Manage","stores"]}}
