{"title":"Automate store management","category":"default","creationDate":1776961627,"content":"<p>The Management API lets you <a href=\"#retrieve-stores\">retrieve<\/a>, <a href=\"#create-store\">create<\/a>, and <a href=\"#update-store\">update<\/a> your stores by making API requests. You can also do this manually in your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>, but with API requests you can automate these processes.<\/p>\n<p>For more information about stores and point-of-sale account structures, see <a href=\"\/pt\/point-of-sale\/design-your-integration\/determine-account-structure\">Set up your Adyen account for point of sale<\/a>.<\/p>\n<p>When creating and managing stores using API requests, you need to be aware of:<\/p>\n<ul>\n<li>How stores are <a href=\"#store-identification\">identified<\/a>.<\/li>\n<li>The <a href=\"#store-status\">status<\/a> that a store can have.<\/li>\n<\/ul>\n<h2>Requirements<\/h2>\n<p>Before you begin, take into account the following requirements, limitations, and preparations.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Requirement<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><strong>Integration type<\/strong><\/td>\n<td style=\"text-align: left;\">A point-of-sale integration with Adyen.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong><a href=\"\/pt\/development-resources\/api-credentials\">API credentials<\/a><\/strong><\/td>\n<td style=\"text-align: left;\">You must have an API credential with an API key and the following <a href=\"\/pt\/development-resources\/api-credentials#api-permissions\">roles<\/a>: <ul><li markdown=\"1\">Management API\u2014Stores read<\/li> <li markdown=\"1\">Management API\u2014Stores read and write<\/li> <li markdown=\"1\">Management API\u2014Payment methods read<\/li> <li markdown=\"1\">Management API\u2014Payment methods read and write<\/li><\/ul> <br>If you have a Terminal API integration with <a href=\"\/pt\/point-of-sale\/design-your-integration\/choose-your-architecture#cloud-communications\">cloud-based communications<\/a>, you can use the existing API key that you use for Terminal API requests.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Limitations<\/strong><\/td>\n<td style=\"text-align: left;\">Requests to live Management API endpoints related to stores are subject to <a href=\"\/pt\/point-of-sale\/automating-terminal-management#rate-limits-in-the-live-environment\">rate limits<\/a>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"store-identification\">Store identification<\/h2>\n<p>Historically, stores under a merchant account have a human-readable <strong>reference<\/strong>, also known as the store code. This reference is unique for the merchant account. However, it is possible that a store reference is not unique on our platform. So we introduced a platform-generated <strong>unique store ID<\/strong> for each store.<\/p>\n<p>When you create a store, you can provide a reference for it, and Adyen will automatically assign a unique ID.<\/p>\n<p>For existing stores, the situation can vary. We are currently assigning unique IDs to existing stores, but it will take a while before this is completed. This means that if your existing store doesn't have an ID yet, you cannot make a PATCH request to update the store.<\/p>\n<h2 id=\"store-status\">Opening and closing stores<\/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>.   After assigning and boarding payment terminals, the store is immediately open for business. <\/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.  The maximum <a href=\"\/pt\/point-of-sale\/design-your-integration\/determine-account-structure\/configure-features#payment-features\">transaction limits and number of Store-and-Forward transactions<\/a> for the store are set to zero (0).  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>.  Then, when you change the store status from <strong>inactive<\/strong> to <strong>closed<\/strong>, all payment terminals under the store are immediately reassigned to the merchant inventory. This means the terminals need to be assigned to a different store and boarded before they can process transactions again.  It is not possible to change the status anymore because a closed store cannot be reopened.<\/p>\n<\/li>\n<\/ul>\n<h2 id=\"retrieve-stores\">Retrieve store details<\/h2>\n<p>You can make API requests to:<\/p>\n<ul>\n<li><a href=\"#get-all-stores\">Get a list of stores<\/a>. For each store, the response includes the full details.<\/li>\n<li><a href=\"#get-specific-store\">Get the details of a specific store<\/a>.<\/li>\n<\/ul>\n<h3 id=\"get-all-stores\">Get a list of stores<\/h3>\n<ol>\n<li>\n<p>To get a list of stores, use one of the following endpoints:<\/p>\n<ul>\n<li>GET  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/stores\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/stores<\/a> for the details of all stores that your API key has access to.<\/li>\n<li>GET  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/merchants\/(merchantId)\/stores\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/merchants\/{merchantId}\/stores<\/a> for the details of the stores under a specific merchant account. To find the <code>merchantId<\/code>, make a GET request to  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/merchants\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/merchants<\/a>.<\/li>\n<\/ul>\n<p>You can filter the paginated response using the following query parameters:<\/p>\n<ul>\n<li> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/stores#query-pageNumber\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">pageNumber<\/a>&#58; returns the stores listed on the specified page.<\/li>\n<li> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/stores#query-pageSize\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">pageSize<\/a>&#58; the number of stores to have on a page. The default is 10, the maximum is 100.<\/li>\n<li> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/stores#query-merchantId\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">merchantId<\/a>&#58; the merchant account ID that a store belongs to. You can only use this query parameter with a GET  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/stores\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/stores<\/a> request.<\/li>\n<li> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/stores#query-reference\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">reference<\/a>&#58; the reference of the store. Because a store reference is only unique within a merchant account, a GET  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/stores\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/stores<\/a> request using the store reference as a query parameter returns all stores with that reference, including those of different merchant accounts.<\/li>\n<\/ul>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Get a list of your stores'\" :id=\"'get-stores'\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;curl&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/management-test.adyen.com\\\/v3\\\/stores \\\\\\n-H 'x-api-key: ADYEN_API_KEY' \\\\\\n-X GET \\\\\\n-d ''&quot;},{&quot;language&quot;:&quot;java&quot;,&quot;tabTitle&quot;:&quot;Java&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Java API Library v33.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(\\&quot;ADYEN_API_KEY\\&quot;, Environment.TEST);\\n\\\/\\\/ Send the request\\nAccountStoreLevelApi service = new AccountStoreLevelApi(client);\\nListStoresResponse response = service.listStores(1, 1, \\&quot;String\\&quot;, \\&quot;String\\&quot;, null);&quot;},{&quot;language&quot;:&quot;php&quot;,&quot;tabTitle&quot;:&quot;PHP&quot;,&quot;content&quot;:&quot;&lt;?php\\n\\\/\\\/ Adyen PHP API Library v24.0.0\\nuse Adyen\\\\Client;\\nuse Adyen\\\\Environment;\\nuse Adyen\\\\Service\\\\Management\\\\AccountStoreLevelApi;\\n\\n$client = new Client();\\n$client-&gt;setXApiKey(\\&quot;ADYEN_API_KEY\\&quot;);\\n$client-&gt;setEnvironment(Environment::TEST);\\n\\n$requestOptions['queryParams'] = array('pageNumber' =&gt; 'integer', 'pageSize' =&gt; 'integer', 'reference' =&gt; 'string', 'merchantId' =&gt; 'string');\\n\\n\\\/\\\/ Send the request\\n$service = new AccountStoreLevelApi($client);\\n$response = $service-&gt;listStores($requestOptions);&quot;},{&quot;language&quot;:&quot;cs&quot;,&quot;tabTitle&quot;:&quot;C#&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen .net API Library v28.0.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 = \\&quot;ADYEN_API_KEY\\&quot;,\\n    Environment = Environment.Test\\n};\\nvar client = new Client(config);\\n\\n\\\/\\\/ Send the request\\nvar service = new AccountStoreLevelService(client);\\nvar response = service.ListStores(pageNumber: 1, pageSize: 1, reference: \\&quot;string\\&quot;, merchantId: \\&quot;string\\&quot;);&quot;},{&quot;language&quot;:&quot;js&quot;,&quot;tabTitle&quot;:&quot;NodeJS (JavaScript)&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Node API Library v23.3.0\\nconst { Client, ManagementAPI } = require('@adyen\\\/api-library');\\n\\nconst client = new Client({ apiKey: \\&quot;ADYEN_API_KEY\\&quot;, environment: \\&quot;TEST\\&quot; });\\n\\n\\\/\\\/ Send the request\\nconst managementAPI = new ManagementAPI(client);\\nconst response = managementAPI.AccountStoreLevelApi.listStores(1, 1, \\&quot;string\\&quot;, \\&quot;string\\&quot;);&quot;},{&quot;language&quot;:&quot;go&quot;,&quot;tabTitle&quot;:&quot;Go&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Go API Library v17.0.0\\nimport (\\n  \\&quot;context\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v17\\\/src\\\/common\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v17\\\/src\\\/adyen\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v17\\\/src\\\/management\\&quot;\\n)\\nclient := adyen.NewClient(&amp;common.Config{\\n  ApiKey:      \\&quot;ADYEN_API_KEY\\&quot;,\\n  Environment: common.TestEnv,\\n})\\n\\n\\\/\\\/ Send the request\\nservice := client.Management()\\nreq := service.AccountStoreLevelApi.ListStoresInput()\\nreq = req.PageNumber(1).PageSize(1).Reference(\\&quot;string\\&quot;).MerchantId(\\&quot;string\\&quot;)\\nres, httpRes, err := service.AccountStoreLevelApi.ListStores(context.Background(), req)&quot;},{&quot;language&quot;:&quot;py&quot;,&quot;tabTitle&quot;:&quot;Python&quot;,&quot;content&quot;:&quot;# Adyen Python API Library v13.3.0\\nimport Adyen\\n\\nadyen = Adyen.Adyen()\\nadyen.client.xapikey = \\&quot;ADYEN_API_KEY\\&quot;\\nadyen.client.platform = \\&quot;test\\&quot; # The environment to use library in.\\n\\nquery_parameters = {\\n  \\&quot;pageNumber\\&quot; : \\&quot;integer\\&quot;,\\n  \\&quot;pageSize\\&quot; : \\&quot;integer\\&quot;,\\n  \\&quot;reference\\&quot; : \\&quot;string\\&quot;,\\n  \\&quot;merchantId\\&quot; : \\&quot;string\\&quot;\\n}\\n\\n# Send the request\\nresult = adyen.management.account_store_level_api.list_stores(query_parameters=query_parameters)&quot;},{&quot;language&quot;:&quot;rb&quot;,&quot;tabTitle&quot;:&quot;Ruby&quot;,&quot;content&quot;:&quot;# Adyen Ruby API Library v10.1.1\\nrequire \\&quot;adyen-ruby-api-library\\&quot;\\n\\nadyen = Adyen::Client.new\\nadyen.api_key = 'ADYEN_API_KEY'\\nadyen.env = :test # Set to \\&quot;live\\&quot; for live environment\\n\\n# Create the request object(s)\\nquery_params = {\\n  :pageNumber =&gt; 'integer',\\n  :pageSize =&gt; 'integer',\\n  :reference =&gt; 'string',\\n  :merchantId =&gt; 'string'\\n}\\n\\n# Send the request\\nresult = adyen.management.account_store_level_api.list_stores(query_params: query_params)&quot;},{&quot;language&quot;:&quot;ts&quot;,&quot;tabTitle&quot;:&quot;NodeJS (TypeScript)&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Node API Library v23.3.0\\nimport { Client, ManagementAPI, Types } from \\&quot;@adyen\\\/api-library\\&quot;;\\n\\nconst client = new Client({ apiKey: \\&quot;ADYEN_API_KEY\\&quot;, environment: \\&quot;TEST\\&quot; });\\n\\n\\\/\\\/ Send the request\\nconst managementAPI = new ManagementAPI(client);\\nconst response = managementAPI.AccountStoreLevelApi.listStores(1, 1, \\&quot;string\\&quot;, \\&quot;string\\&quot;);&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<li>\n<p>In the response, note the <code>id<\/code> of the store. You can use this value to <a href=\"#get-specific-store\">get the details of a specific store<\/a> or to <a href=\"#update-store\">update a store<\/a>.<\/p>\n<p>The next table shows the store details that the response can include.<\/p>\n<table>\n<thead>\n<tr>\n<th>Parameter<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/stores#responses-200-data-address\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">address<\/a><\/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 used for the street name, street number, and other information.<\/li> <li markdown=\"1\"><code>postalCode<\/code>: The postal code of the store.<\/li> <li markdown=\"1\"><code>stateOrProvince<\/code>: The state or province code as defined in <a href=\"https:\/\/www.iso.org\/iso-3166-country-codes.html\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">ISO 3166-2<\/a>. For example, <strong>IL<\/strong> for Illinois in the United States.<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/stores#responses-200-data-description\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">description<\/a><\/td>\n<td style=\"text-align: left;\">The description of the store.<\/td>\n<td style=\"text-align: left;\"><\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/stores#responses-200-data-externalReferenceId\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">externalReferenceId<\/a><\/td>\n<td style=\"text-align: left;\">The unique identifier of the store, used by certain payment methods and tax authorities.<\/td>\n<td style=\"text-align: left;\"><\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/stores#responses-200-data-id\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">id<\/a><\/td>\n<td style=\"text-align: left;\">Unique identifier of the store, starting with <strong>ST<\/strong>. This value is generated by Adyen.<\/td>\n<td style=\"text-align: left;\"><\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/stores#responses-200-_links\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">_links<\/a><\/td>\n<td style=\"text-align: left;\">The URL of the store.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/stores#responses-200-data-merchantId\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">merchantId<\/a><\/td>\n<td style=\"text-align: left;\">The ID of the merchant account that the store belongs to.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/stores#responses-200-data-phoneNumber\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">phoneNumber<\/a><\/td>\n<td style=\"text-align: left;\">The phone number of the store, including the country code.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/stores#responses-200-data-reference\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">reference<\/a><\/td>\n<td style=\"text-align: left;\">Your reference to recognize the store by. If a reference was not specified when the store was created, the reference is populated with the store <code>id<\/code>.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/stores#responses-200-data-shopperStatement\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">shopperStatement<\/a><\/td>\n<td style=\"text-align: left;\">Store name shown on the shopper's bank or credit card statement and on the shopper receipt.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/stores#responses-200-data-splitConfiguration\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">splitConfiguration<\/a><\/td>\n<td style=\"text-align: left;\"> <em>Only for Adyen for Platforms merchants.<\/em><br><br> An object containing the information required to <a href=\"\/pt\/platforms\/automatic-split-configuration\">automatically split transactions<\/a> that are routed through this store.<p>This object consists of: <ul><li markdown=\"1\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/merchants\/(merchantId)\/splitConfigurations#responses-200-splitConfigurationId\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">splitConfigurationId<\/a>: the unique identifier of the <a href=\"\/pt\/platforms\/automatic-split-configuration\/create-split-configuration\">split configuration profile<\/a> that you want to add to the store.<\/li><li markdown=\"1\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/balanceplatform\/latest\/get\/accountHolders\/(id)\/balanceAccounts#responses-200-balanceAccounts-id\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balanceAccountId<\/a>: The unique identifier of the balance account to which the split amount must be booked, depending on the defined  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/merchants\/(merchantId)\/splitConfigurations#request-rules-splitLogic\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">splitLogic<\/a>.<\/li><\/ul><\/p><\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/stores#responses-200-data-status\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">status<\/a><\/td>\n<td style=\"text-align: left;\">The <a href=\"#store-status\">status<\/a> of the store.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'List of stores'\" :id=\"''\" :code-data=\"[{&quot;language&quot;:&quot;json&quot;,&quot;tabTitle&quot;:&quot;&quot;,&quot;content&quot;:&quot;{\\n  \\&quot;_links\\&quot;: {\\n      \\&quot;first\\&quot;: {\\n          \\&quot;href\\&quot;: \\&quot;https:\\\/\\\/management-test.adyen.com\\\/v3\\\/merchants\\\/YOUR_MERCHANT_ACCOUNT_ID\\\/stores?pageNumber=1&amp;pageSize=1\\&quot;\\n      },\\n      \\&quot;last\\&quot;: {\\n          \\&quot;href\\&quot;: \\&quot;https:\\\/\\\/management-test.adyen.com\\\/v3\\\/merchants\\\/YOUR_MERCHANT_ACCOUNT_ID\\\/stores?pageNumber=2&amp;pageSize=1\\&quot;\\n      },\\n      \\&quot;next\\&quot;: {\\n          \\&quot;href\\&quot;: \\&quot;https:\\\/\\\/management-test.adyen.com\\\/v3\\\/merchants\\\/YOUR_MERCHANT_ACCOUNT_ID\\\/stores?pageNumber=2&amp;pageSize=1\\&quot;\\n      },\\n      \\&quot;self\\&quot;: {\\n          \\&quot;href\\&quot;: \\&quot;https:\\\/\\\/management-test.adyen.com\\\/v3\\\/merchants\\\/YOUR_MERCHANT_ACCOUNT_ID\\\/stores?pageNumber=1&amp;pageSize=1\\&quot;\\n      }\\n  },\\n  \\&quot;itemsTotal\\&quot;: 2,\\n  \\&quot;pagesTotal\\&quot;: 1,\\n  \\&quot;data\\&quot;: [\\n      {\\n          \\&quot;id\\&quot;: \\&quot;ST322LJ223223K5F4SQNR9XL5\\&quot;,\\n          \\&quot;address\\&quot;: {\\n              \\&quot;city\\&quot;: \\&quot;Springfield\\&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;postalCode\\&quot;:\\&quot;20250\\&quot;,\\n              \\&quot;stateOrProvince\\&quot;:\\&quot;NY\\&quot;\\n          },\\n          \\&quot;description\\&quot;: \\&quot;City centre store\\&quot;,\\n          \\&quot;merchantId\\&quot;: \\&quot;YOUR_MERCHANT_ACCOUNT_ID\\&quot;,\\n          \\&quot;phoneNumber\\&quot;: \\&quot;+1813702551707653\\&quot;,\\n          \\&quot;reference\\&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\\\/v3\\\/stores\\\/ST322LJ223223K5F4SQNR9XL5\\&quot;\\n               }\\n          }\\n      },\\n      {\\n          \\&quot;id\\&quot;: \\&quot;ST322LJ223223K5F4SQNR9XL6\\&quot;,\\n          \\&quot;address\\&quot;: {\\n              \\&quot;city\\&quot;: \\&quot;North Madison\\&quot;,\\n              \\&quot;country\\&quot;: \\&quot;US\\&quot;,\\n              \\&quot;line1\\&quot;: \\&quot;1492 Townline Road\\&quot;,\\n              \\&quot;line2\\&quot;: \\&quot;Rowland Business Park\\&quot;,\\n              \\&quot;postalCode\\&quot;:\\&quot;20577\\&quot;,\\n              \\&quot;stateOrProvince\\&quot;:\\&quot;NY\\&quot;\\n          },\\n          \\&quot;description\\&quot;: \\&quot;West location\\&quot;,\\n          \\&quot;merchantId\\&quot;: \\&quot;YOUR_MERCHANT_ACCOUNT_ID\\&quot;,\\n         \\&quot;phoneNumber\\&quot;: \\&quot;+1211992213193020\\&quot;,\\n         \\&quot;reference\\&quot;: \\&quot;Second Madison store\\&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\\\/v3\\\/stores\\\/ST322LJ223223K5F4SQNR9XL6\\&quot;\\n              }\\n         }\\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<h3 id=\"get-specific-store\">Get the details of a specific store<\/h3>\n<ol>\n<li>\n<p>Make sure that you know the <code>id<\/code> or the <code>reference<\/code> of the store. To find these values, get a <a href=\"#get-all-stores\">list of stores<\/a>.<\/p>\n<\/li>\n<li>\n<p>To get the details of a single store, use the following endpoints:<\/p>\n<ul>\n<li>GET  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/stores\/(storeId)\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/stores\/{storeId}<\/a><\/li>\n<li>GET  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/merchants\/(merchantId)\/stores\/(storeId)\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/merchants\/{merchantId}\/stores\/{storeId}<\/a><\/li>\n<\/ul>\n<p>You can also use the store  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/stores#query-reference\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">reference<\/a> as a query parameter. Because the reference is only unique within a merchant account, if you use the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/stores\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/stores<\/a> endpoint you get all stores with that reference, including those of different merchant accounts.<\/p>\n<p>To get the details of a store under a merchant account using the store reference, make a GET request to  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/merchants\/(merchantId)\/stores#query-reference\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/merchants\/{merchantId}\/stores?reference={reference}<\/a>.<\/p>\n<p>This example shows how to get information about a store using the store ID in the path.<\/p>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Get the details of a specific store'\" :id=\"'get-a-store'\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;curl&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/management-test.adyen.com\\\/v3\\\/stores\\\/ST322LJ223223K5F4SQNR9XL6 \\\\\\n-H 'x-api-key: ADYEN_API_KEY' \\\\\\n-X GET \\\\\\n-d ''&quot;},{&quot;language&quot;:&quot;java&quot;,&quot;tabTitle&quot;:&quot;Java&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Java API Library v33.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(\\&quot;ADYEN_API_KEY\\&quot;, Environment.TEST);\\n\\\/\\\/ Send the request\\nAccountStoreLevelApi service = new AccountStoreLevelApi(client);\\nStore response = service.getStoreById(\\&quot;storeId\\&quot;, null);&quot;},{&quot;language&quot;:&quot;php&quot;,&quot;tabTitle&quot;:&quot;PHP&quot;,&quot;content&quot;:&quot;&lt;?php\\n\\\/\\\/ Adyen PHP API Library v24.0.0\\nuse Adyen\\\\Client;\\nuse Adyen\\\\Environment;\\nuse Adyen\\\\Service\\\\Management\\\\AccountStoreLevelApi;\\n\\n$client = new Client();\\n$client-&gt;setXApiKey(\\&quot;ADYEN_API_KEY\\&quot;);\\n$client-&gt;setEnvironment(Environment::TEST);\\n\\n\\\/\\\/ Send the request\\n$service = new AccountStoreLevelApi($client);\\n$response = $service-&gt;getStoreById('storeId');&quot;},{&quot;language&quot;:&quot;cs&quot;,&quot;tabTitle&quot;:&quot;C#&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen .net API Library v28.0.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 = \\&quot;ADYEN_API_KEY\\&quot;,\\n    Environment = Environment.Test\\n};\\nvar client = new Client(config);\\n\\n\\\/\\\/ Send the request\\nvar service = new AccountStoreLevelService(client);\\nvar response = service.GetStoreById(\\&quot;storeId\\&quot;);&quot;},{&quot;language&quot;:&quot;js&quot;,&quot;tabTitle&quot;:&quot;NodeJS (JavaScript)&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Node API Library v23.3.0\\nconst { Client, ManagementAPI } = require('@adyen\\\/api-library');\\n\\nconst client = new Client({ apiKey: \\&quot;ADYEN_API_KEY\\&quot;, environment: \\&quot;TEST\\&quot; });\\n\\n\\\/\\\/ Send the request\\nconst managementAPI = new ManagementAPI(client);\\nconst response = managementAPI.AccountStoreLevelApi.getStoreById(\\&quot;storeId\\&quot;);&quot;},{&quot;language&quot;:&quot;go&quot;,&quot;tabTitle&quot;:&quot;Go&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Go API Library v17.0.0\\nimport (\\n  \\&quot;context\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v17\\\/src\\\/common\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v17\\\/src\\\/adyen\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v17\\\/src\\\/management\\&quot;\\n)\\nclient := adyen.NewClient(&amp;common.Config{\\n  ApiKey:      \\&quot;ADYEN_API_KEY\\&quot;,\\n  Environment: common.TestEnv,\\n})\\n\\n\\\/\\\/ Send the request\\nservice := client.Management()\\nreq := service.AccountStoreLevelApi.GetStoreByIdInput(\\&quot;storeId\\&quot;)\\nres, httpRes, err := service.AccountStoreLevelApi.GetStoreById(context.Background(), req)&quot;},{&quot;language&quot;:&quot;py&quot;,&quot;tabTitle&quot;:&quot;Python&quot;,&quot;content&quot;:&quot;# Adyen Python API Library v13.3.0\\nimport Adyen\\n\\nadyen = Adyen.Adyen()\\nadyen.client.xapikey = \\&quot;ADYEN_API_KEY\\&quot;\\nadyen.client.platform = \\&quot;test\\&quot; # The environment to use library in.\\n\\n# Send the request\\nresult = adyen.management.account_store_level_api.get_store_by_id(storeId=\\&quot;storeId\\&quot;)&quot;},{&quot;language&quot;:&quot;rb&quot;,&quot;tabTitle&quot;:&quot;Ruby&quot;,&quot;content&quot;:&quot;# Adyen Ruby API Library v10.1.1\\nrequire \\&quot;adyen-ruby-api-library\\&quot;\\n\\nadyen = Adyen::Client.new\\nadyen.api_key = 'ADYEN_API_KEY'\\nadyen.env = :test # Set to \\&quot;live\\&quot; for live environment\\n\\n# Send the request\\nresult = adyen.management.account_store_level_api.get_store_by_id('storeId')&quot;},{&quot;language&quot;:&quot;ts&quot;,&quot;tabTitle&quot;:&quot;NodeJS (TypeScript)&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Node API Library v23.3.0\\nimport { Client, ManagementAPI, Types } from \\&quot;@adyen\\\/api-library\\&quot;;\\n\\nconst client = new Client({ apiKey: \\&quot;ADYEN_API_KEY\\&quot;, environment: \\&quot;TEST\\&quot; });\\n\\n\\\/\\\/ Send the request\\nconst managementAPI = new ManagementAPI(client);\\nconst response = managementAPI.AccountStoreLevelApi.getStoreById(\\&quot;storeId\\&quot;);&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<li>\n<p>Note that the response returns the same details as when you get a <a href=\"#get-all-stores\">list of stores<\/a>, but only for the specified store.<\/p>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Response showing the store details'\" :id=\"''\" :code-data=\"[{&quot;language&quot;:&quot;json&quot;,&quot;tabTitle&quot;:&quot;&quot;,&quot;content&quot;:&quot;{\\n    \\&quot;id\\&quot;: \\&quot;ST322LJ223223K5F4SQNR9XL6\\&quot;,\\n    \\&quot;address\\&quot;: {\\n        \\&quot;city\\&quot;: \\&quot;North Madison\\&quot;,\\n        \\&quot;country\\&quot;: \\&quot;US\\&quot;,\\n        \\&quot;line1\\&quot;: \\&quot;1492 Townline Road\\&quot;,\\n        \\&quot;line2\\&quot;: \\&quot;Rowland Business Park\\&quot;,\\n        \\&quot;postalCode\\&quot;:\\&quot;20577\\&quot;,\\n        \\&quot;stateOrProvince\\&quot;:\\&quot;NY\\&quot;\\n    },\\n    \\&quot;description\\&quot;: \\&quot;West location\\&quot;,\\n    \\&quot;merchantId\\&quot;: \\&quot;YOUR_MERCHANT_ACCOUNT_ID\\&quot;,\\n    \\&quot;phoneNumber\\&quot;: \\&quot;+1211992213193020\\&quot;,\\n    \\&quot;reference\\&quot;: \\&quot;Second Madison store\\&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\\\/v3\\\/stores\\\/ST322LJ223223K5F4SQNR9XL6\\&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=\"create-store\">Create a store<\/h2>\n<p>Before you create a store, make sure you know the merchant account ID that the store will be associated with.<br \/>\nFor a list of merchant account IDs accessible with your API key, make a GET  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/merchants\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/merchants<\/a> request.<\/p>\n<ol>\n<li>\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 for Australia, Brazil, Canada, India, Mexico, New Zealand, United States.<\/em> The state or province of the store as defined in <a href=\"https:\/\/www.iso.org\/iso-3166-country-codes.html\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">ISO 3166-2<\/a>. For example, <strong>ON<\/strong> for Ontario, Canada.<\/li> <\/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-externalReferenceId\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">externalReferenceId<\/a><\/td>\n<td style=\"text-align: center;\"><\/td>\n<td style=\"text-align: left;\"><em>Only when using the Zip payment method.<\/em> <p>The location ID that Zip has assigned to your store.<\/p><\/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<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/stores#request-splitConfiguration\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">splitConfiguration<\/a><\/td>\n<td style=\"text-align: center;\"><\/td>\n<td style=\"text-align: left;\"> <em>Only for Adyen for Platforms merchants.<\/em><br><br> An object containing the information required to <a href=\"\/pt\/platforms\/automatic-split-configuration\">automatically split transactions<\/a> that are routed through this store.<p>This object consists of: <ul><li markdown=\"1\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/merchants\/(merchantId)\/splitConfigurations#responses-200-splitConfigurationId\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">splitConfigurationId<\/a>: the unique identifier of the <a href=\"\/pt\/platforms\/automatic-split-configuration\/create-split-configuration\">split configuration<\/a> that you want to add to the store.<\/li><li markdown=\"1\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/balanceplatform\/latest\/get\/accountHolders\/(id)\/balanceAccounts#responses-200-balanceAccounts-id\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balanceAccountId<\/a>: The unique identifier of the balance account to which the split amount must be booked, depending on the defined  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/merchants\/(merchantId)\/splitConfigurations\/(splitConfigurationId)#request-splitLogic\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">splitLogic<\/a>.<\/li><\/ul><\/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-localizedInformation\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">localizedInformation<\/a><\/td>\n<td style=\"text-align: center;\"><\/td>\n<td style=\"text-align: left;\"><em>Only for stores in Japan.<\/em><br><br> An object that provides localized information about the store, in the relevant character set. <p>This object consists of: <ul><li markdown=\"1\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/stores#request-localizedInformation-localShopperStatement\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">localShopperStatement<\/a>: an array with localized shopper statements which card schemes use in the bank statement. Each array item consists of: <ul><li markdown=\"1\"><code>script<\/code>: the character set. Allowed values: <span translate=\"no\"><strong>ja-Hani<\/strong><\/span> (Kanji) and <span translate=\"no\"><strong>ja-Kana<\/strong><\/span> (Katakana).<\/li> <li markdown=\"1\"><code>value<\/code>: the text of the shopper statement, in the specified character set.<\/li><\/ul> <div class=\"sc-notice info\"><div> For Japan, the card schemes require two local shopper statements, one in ja-Hani and one in ja-Kana.<\/div><\/div> <\/i><\/ul><\/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=\"tab8Tyzt\">\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 v41.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)\\\\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 v29.0.0\\\\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 v33.0.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)\\\\nStoreLocation 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\\\\nStoreCreationWithMerchantCodeRequest 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 service = new AccountStoreLevelService(client);\\\\nvar response = service.CreateStore(storeCreationWithMerchantCodeRequest);&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.1.0\\\\nconst { Client, 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 storeCreationWithMerchantCodeRequest = {\\\\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  phoneNumber: \\\\&amp;quot;1813702551707653\\\\&amp;quot;,\\\\n  reference: \\\\&amp;quot;Spring_store_2\\\\&amp;quot;,\\\\n  address: {\\\\n    country: \\\\&amp;quot;US\\\\&amp;quot;,\\\\n    line1: \\\\&amp;quot;200 Main Street\\\\&amp;quot;,\\\\n    line2: \\\\&amp;quot;Building 5A\\\\&amp;quot;,\\\\n    line3: \\\\&amp;quot;Suite 3\\\\&amp;quot;,\\\\n    city: \\\\&amp;quot;Springfield\\\\&amp;quot;,\\\\n    stateOrProvince: \\\\&amp;quot;NY\\\\&amp;quot;,\\\\n    postalCode: \\\\&amp;quot;20250\\\\&amp;quot;\\\\n  }\\\\n}\\\\n\\\\n\\\\\\\/\\\\\\\/ Send the request\\\\nconst managementAPI = new ManagementAPI(client);\\\\nconst response = 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.1.0\\\\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\\\\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.1.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  :merchantId =&amp;gt; &#039;MERCHANT_ACCOUNT_ID&#039;,\\\\n  :description =&amp;gt; &#039;City centre store&#039;,\\\\n  :shopperStatement =&amp;gt; &#039;Springfield Shop&#039;,\\\\n  :phoneNumber =&amp;gt; &#039;1813702551707653&#039;,\\\\n  :reference =&amp;gt; &#039;Spring_store_2&#039;,\\\\n  :address =&amp;gt; {\\\\n    :country =&amp;gt; &#039;US&#039;,\\\\n    :line1 =&amp;gt; &#039;200 Main Street&#039;,\\\\n    :line2 =&amp;gt; &#039;Building 5A&#039;,\\\\n    :line3 =&amp;gt; &#039;Suite 3&#039;,\\\\n    :city =&amp;gt; &#039;Springfield&#039;,\\\\n    :stateOrProvince =&amp;gt; &#039;NY&#039;,\\\\n    :postalCode =&amp;gt; &#039;20250&#039;\\\\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.1.0\\\\nimport { Client, 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 = 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;:&quot;create_a_store_-_general_0_1&quot;,&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;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\\\\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.1.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  :merchantId =&amp;gt; &#039;MERCHANT_ACCOUNT_ID&#039;,\\\\n  :description =&amp;gt; &#039;Tokyo Ginza store&#039;,\\\\n  :shopperStatement =&amp;gt; &#039;Adyen Co., Ltd.&#039;,\\\\n  :localizedInformation =&amp;gt; {\\\\n    :localShopperStatement =&amp;gt; [ {\\\\n      :script =&amp;gt; &#039;ja-Hani&#039;,\\\\n      :value =&amp;gt; &#039;\\\\u30a2\\\\u30c7\\\\u30a3\\\\u30a8\\\\u30f3\\\\u682a\\\\u5f0f\\\\u4f1a\\\\u793e&#039;\\\\n    }, {\\\\n      :script =&amp;gt; &#039;ja-Kana&#039;,\\\\n      :value =&amp;gt; &#039;\\\\uff71\\\\uff83\\\\uff9e\\\\uff68\\\\uff74\\\\uff9d\\\\uff7c\\\\uff9e\\\\uff6c\\\\uff8a\\\\uff9f\\\\uff9d&#039;\\\\n    } ]\\\\n  },\\\\n  :phoneNumber =&amp;gt; &#039;+81312345678&#039;,\\\\n  :reference =&amp;gt; &#039;Ginza_store_2&#039;,\\\\n  :address =&amp;gt; {\\\\n    :country =&amp;gt; &#039;JP&#039;,\\\\n    :line1 =&amp;gt; &#039;Tokyo Central Ginza&#039;,\\\\n    :line2 =&amp;gt; &#039;ACN Higashi Azabu Building Rokukai&#039;,\\\\n    :city =&amp;gt; &#039;Tokyo&#039;,\\\\n    :postalCode =&amp;gt; &#039;104-0061&#039;\\\\n  }\\\\n}\\\\n\\\\n# Send the request\\\\nresult = adyen.management.account_store_level_api.create_store(request_body)&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;:&quot;create_a_store_-_japan_1_2&quot;,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='false'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<ol start=\"2\">\n<li>\n<p>In the response, note that this 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. You can use this as a path parameter to <a href=\"#update-store\">update the store<\/a>.<\/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<ol start=\"3\">\n<li><a href=\"#add-payment-method\">Add payment methods<\/a> to the store.\n<\/li>\n<\/ol>\n<h2 id=\"payment-methods\">Manage payment methods<\/h2>\n<p>A newly created store doesn't have any payment methods yet. You need to <a href=\"#add-payment-method\">add<\/a> payment methods one at a time. Every payment method that you add, gets an ID that is unique for the combination of that payment method and store. Using this ID, you can <a href=\"#update-payment-method\">update<\/a> the settings of that payment method in the corresponding store.<\/p>\n<h3 id=\"add-payment-method\">Add a payment method<\/h3>\n<ol>\n<li>\n<p>To decide what payment method to add:<\/p>\n<ul>\n<li>\n<p>See the <a href=\"\/pt\/development-resources\/paymentmethodvariant#management-api\">list of payment methods<\/a> that you can add using Management API.<\/p>\n<div class=\"notices green\">\n<p>Some payment methods (like iDEAL) only apply to web shops and are not supported on payment terminals.<\/p>\n<\/div>\n<\/li>\n<li>\n<p>For a list of payment methods that are already enabled for your store, make a GET request to  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/merchants\/(merchantId)\/paymentMethodSettings\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/merchants\/{merchantId}\/paymentMethodSettings<\/a> with your store ID as a query parameter.<br \/>\nFor example,  <code>...\/paymentMethodSettings?storeID=ST322LJ223223K5F4SQNR9XL5<\/code>.<\/p>\n<!-- list separator -->\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>To add a payment method to your store, make a POST request to  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/merchants\/(merchantId)\/paymentMethodSettings\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/merchants\/{merchantId}\/paymentMethodSettings<\/a> with your store ID in the request body (not as a query parameter). Specify:<\/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\/merchants\/(merchantId)\/paymentMethodSettings#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 style=\"text-align: left;\">Payment method <a href=\"\/pt\/development-resources\/paymentmethodvariant#management-api\">type<\/a>. Some payment methods require an additional object with payment method details.<\/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\/merchants\/(merchantId)\/paymentMethodSettings#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 style=\"text-align: left;\">The unique identifier of your user's business line that you want to request a payment method for.<\/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\/merchants\/(merchantId)\/paymentMethodSettings#request-storeIds\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">storeIds<\/a><\/td>\n<td style=\"text-align: center;\"><\/td>\n<td style=\"text-align: left;\">The <code>id<\/code> of the store that you get when <a href=\"#create-store\">creating a store<\/a> .<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/merchants\/(merchantId)\/paymentMethodSettings#request-countries\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">countries<\/a><\/td>\n<td style=\"text-align: center;\"><\/td>\n<td style=\"text-align: left;\">The list of countries to enable with the payment method. To enable all countries supported by the payment method, set to <strong>ANY<\/strong> or send empty.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/merchants\/(merchantId)\/paymentMethodSettings#request-currencies\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">currencies<\/a><\/td>\n<td style=\"text-align: center;\"><\/td>\n<td style=\"text-align: left;\">The list of currencies to enable with the payment method. To enable all currencies supported by the payment method, set to <strong>ANY<\/strong> or send empty.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>The following example adds American Express.<\/p>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Add payment method'\" :id=\"'add-payment-method-9323982969'\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;curl&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/management-test.adyen.com\\\/v3\\\/merchants\\\/{merchantId}\\\/paymentMethodSettings \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-H 'x-API-key: ADYEN_API_KEY' \\\\\\n-X POST \\\\\\n-d '{\\n   \\&quot;type\\&quot;: \\&quot;amex\\&quot;,\\n   \\&quot;storeIds\\&quot;:[\\&quot;ST322LJ223223K5F4SQNR9XL5\\&quot;],\\n   \\&quot;currencies\\&quot;: [\\n        \\&quot;USD\\&quot;\\n   ],\\n   \\&quot;countries\\&quot;: []\\n}'&quot;},{&quot;language&quot;:&quot;java&quot;,&quot;tabTitle&quot;:&quot;Java&quot;,&quot;content&quot;:&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(\\&quot;ADYEN_API_KEY\\&quot;, Environment.TEST);\\n\\n\\\/\\\/ Request objects\\nPaymentMethodSetupInfo paymentMethodSetupInfo = new PaymentMethodSetupInfo()\\n\\t.countries(Arrays.asList())\\n\\t.type(PaymentMethodSetupInfo.TypeEnum.AMEX)\\n\\t.currencies(Arrays.asList(\\&quot;USD\\&quot;));\\n\\n\\\/\\\/ Make the request\\nPaymentMethodsMerchantLevelApi service = new PaymentMethodsMerchantLevelApi(client);\\nPaymentMethod response = service.requestPaymentMethod(\\&quot;merchantId\\&quot;, paymentMethodSetupInfo, null);&quot;},{&quot;language&quot;:&quot;php&quot;,&quot;tabTitle&quot;:&quot;PHP&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen PHP API Library v17.4.0\\nuse Adyen\\\\Client;\\nuse Adyen\\\\Environment;\\nuse Adyen\\\\Model\\\\Management\\\\PaymentMethodSetupInfo;\\nuse Adyen\\\\Service\\\\Management\\\\PaymentMethodsMerchantLevelApi;\\n\\n$client = new Client();\\n$client-&gt;setXApiKey(\\&quot;ADYEN_API_KEY\\&quot;);\\n$client-&gt;setEnvironment(Environment::TEST);\\n\\n\\n\\\/\\\/ Request objects\\n$paymentMethodSetupInfo = new PaymentMethodSetupInfo();\\n$paymentMethodSetupInfo\\n\\t-&gt;setCountries(array())\\n\\t-&gt;setType(\\&quot;amex\\&quot;)\\n\\t-&gt;setCurrencies(array(\\&quot;USD\\&quot;));\\n\\n\\\/\\\/ Make the request\\n$service = new PaymentMethodsMerchantLevelApi($client);\\n$response = $service-&gt;requestPaymentMethod('merchantId', $paymentMethodSetupInfo);&quot;},{&quot;language&quot;:&quot;cs&quot;,&quot;tabTitle&quot;:&quot;C#&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen .net API Library v14.3.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 = \\&quot;ADYEN_API_KEY\\&quot;,\\n    Environment = Environment.Test\\n};\\nvar client = new Client(config);\\n\\n\\\/\\\/ Fill in your request objects\\nPaymentMethodSetupInfo paymentMethodSetupInfo = new PaymentMethodSetupInfo\\n{\\n\\tCountries = {  },\\n\\tType = PaymentMethodSetupInfo.TypeEnum.Amex,\\n\\tCurrencies = { \\&quot;USD\\&quot; }\\n};\\n\\n\\\/\\\/ Make the request\\nvar service = new PaymentMethodsMerchantLevelService(client);\\nvar response = service.RequestPaymentMethod(\\&quot;merchantId\\&quot;, paymentMethodSetupInfo);&quot;},{&quot;language&quot;:&quot;js&quot;,&quot;tabTitle&quot;:&quot;NodeJS (JavaScript)&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Node API Library v16.2.0\\n\\\/\\\/ Require the parts of the module you want to use\\nconst { Client, ManagementAPI } = require('@adyen\\\/api-library');\\n\\n\\\/\\\/ Initialize the client object\\nconst client = new Client({apiKey: \\&quot;ADYEN_API_KEY\\&quot;, environment: \\&quot;TEST\\&quot;});\\n\\n\\\/\\\/ Create the request object\\nconst paymentMethodSetupInfo = {\\n  type: \\&quot;amex\\&quot;,\\n  storeId: \\&quot;ST322LJ223223K5F4SQNR9XL5\\&quot;,\\n  currencies: [ \\&quot;USD\\&quot; ],\\n  countries: [ ]\\n}\\n\\n\\\/\\\/ Make the request\\nconst managementAPI = new ManagementAPI(client);\\nconst response = managementAPI.PaymentMethodsMerchantLevelApi.requestPaymentMethod(\\&quot;merchantId\\&quot;, paymentMethodSetupInfo);&quot;},{&quot;language&quot;:&quot;go&quot;,&quot;tabTitle&quot;:&quot;Go&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Go API Library v9.2.0\\nimport (\\n\\t\\&quot;context\\&quot;\\n\\t\\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v9\\\/src\\\/common\\&quot;\\n\\t\\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v9\\\/src\\\/adyen\\&quot;\\n\\t\\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v9\\\/src\\\/management\\&quot;\\n)\\n\\nclient := adyen.NewClient(&amp;common.Config{\\n    ApiKey:      \\&quot;ADYEN_API_KEY\\&quot;,\\n    Environment: common.TestEnv,\\n})\\n\\n\\\/\\\/ Fill in your request objects\\npaymentMethodSetupInfo := management.PaymentMethodSetupInfo{\\n\\tCountries: []string{\\n\\t\\t,\\n\\t},\\n\\tType: \\&quot;amex\\&quot;,\\n\\tCurrencies: []string{\\n\\t\\t\\&quot;USD\\&quot;,\\n\\t},\\n}\\n\\n\\\/\\\/ Make the request\\nservice := client.Management()\\nreq := service.PaymentMethodsMerchantLevelApi.RequestPaymentMethodInput(\\&quot;merchantId\\&quot;).PaymentMethodSetupInfo(paymentMethodSetupInfo)\\nres, httpRes, err := service.PaymentMethodsMerchantLevelApi.RequestPaymentMethod(context.Background(), req)&quot;},{&quot;language&quot;:&quot;py&quot;,&quot;tabTitle&quot;:&quot;Python&quot;,&quot;content&quot;:&quot;# Adyen Python API Library v12.2.0\\nimport Adyen\\n\\nadyen = Adyen.Adyen()\\nadyen.client.xapikey = \\&quot;ADYEN_API_KEY\\&quot;\\nadyen.client.platform = \\&quot;test\\&quot; # The environment to use library in.\\n\\njson_request = {\\n  \\&quot;type\\&quot;: \\&quot;amex\\&quot;,\\n  \\&quot;storeId\\&quot;: \\&quot;ST322LJ223223K5F4SQNR9XL5\\&quot;,\\n  \\&quot;currencies\\&quot;: [ \\&quot;USD\\&quot; ],\\n  \\&quot;countries\\&quot;: [ ]\\n}\\n\\nresult = adyen.management.payment_methods_merchant_level_api.request_payment_method(request=json_request, merchantId=\\&quot;merchantId\\&quot;)&quot;},{&quot;language&quot;:&quot;rb&quot;,&quot;tabTitle&quot;:&quot;Ruby&quot;,&quot;content&quot;:&quot;# Adyen Ruby API Library v9.2.0\\nrequire \\&quot;adyen-ruby-api-library\\&quot;\\n\\nadyen = Adyen::Client.new\\nadyen.api_key = 'ADYEN_API_KEY'\\nadyen.env = :test # Set to \\&quot;live\\&quot; for live environment\\n\\nrequest_body = {\\n  :type =&gt; 'amex',\\n  :storeId =&gt; 'ST322LJ223223K5F4SQNR9XL5',\\n  :currencies =&gt; [ 'USD' ],\\n  :countries =&gt; [ ]\\n}\\n\\nresult = adyen.management.payment_methods_merchant_level_api.request_payment_method(request_body, 'merchantId')&quot;},{&quot;language&quot;:&quot;ts&quot;,&quot;tabTitle&quot;:&quot;NodeJS (TypeScript)&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Node API Library v16.2.0\\n\\\/\\\/ Require the parts of the module you want to use\\nimport { Client, ManagementAPI, Types } from \\&quot;@adyen\\\/api-library\\&quot;;\\n\\n\\\/\\\/ Initialize the client object\\nconst client = new Client({apiKey: \\&quot;ADYEN_API_KEY\\&quot;, environment: \\&quot;TEST\\&quot;});\\n\\n\\\/\\\/ Create the request objects\\nconst paymentMethodSetupInfo: Types.management.PaymentMethodSetupInfo = {\\n\\tcountries: [],\\n\\ttype: Types.management.PaymentMethodSetupInfo.TypeEnum.Amex,\\n\\tcurrencies: [\\&quot;USD\\&quot;]\\n};\\n\\n\\\/\\\/ Make the request\\nconst managementAPI = new ManagementAPI(client);\\nconst response = managementAPI.PaymentMethodsMerchantLevelApi.requestPaymentMethod(\\&quot;merchantId\\&quot;, paymentMethodSetupInfo);&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<li>\n<p>In the response, note that this includes the <code>id<\/code> of the payment method. This ID is specific for the combination of payment method and store. You can use this as a path parameter to <a href=\"#update-payment-method\">update the settings of the payment method<\/a>.<\/p>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Response'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"id\\\": \\\"PM3227C223224K5DSP4NSDKPK\\\",\\n    \\\"type\\\": \\\"amex\\\",\\n    \\\"storeIds\\\": [\\\"ST322LJ223223K5F4SQNR9XL5\\\"],\\n    \\\"countries\\\": [],\\n    \\\"currencies\\\": [\\n        \\\"USD\\\"\\n    ]\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<li>\n<p>To check if the added payment method is enabled, make a GET request to  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/merchants\/(merchantId)\/paymentMethodSettings\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/merchants\/{merchantId}\/paymentMethodSettings<\/a> with your store ID as a query parameter.<\/p>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Get payment methods for a store'\" :id=\"'get-payment-methods-for-a-store-6416537766'\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;curl&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/management-test.adyen.com\\\/v3\\\/merchants\\\/{merchantId}\\\/paymentMethodSettings?storeID=ST322LJ223223K5F4SQNR9XL5 \\\\\\n-H 'x-API-key: ADYEN_API_KEY' \\\\\\n-X GET&quot;},{&quot;language&quot;:&quot;java&quot;,&quot;tabTitle&quot;:&quot;Java&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Java API Library v25.0.0\\nimport com.adyen.Client;\\nimport com.adyen.enums.Environment;\\nimport com.adyen.service.management.*;\\n\\nClient client = new Client(\\&quot;ADYEN_API_KEY\\&quot;, Environment.TEST);\\n\\\/\\\/ Make the request\\nPaymentMethodsMerchantLevelApi service = new PaymentMethodsMerchantLevelApi(client);\\nPaymentMethodResponse response = service.getAllPaymentMethods(\\&quot;merchantId\\&quot;, \\&quot;String\\&quot;, \\&quot;String\\&quot;, 1, 1, null);&quot;},{&quot;language&quot;:&quot;php&quot;,&quot;tabTitle&quot;:&quot;PHP&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen PHP API Library v17.4.0\\nuse Adyen\\\\Client;\\nuse Adyen\\\\Environment;\\nuse Adyen\\\\Service\\\\Management\\\\PaymentMethodsMerchantLevelApi;\\n\\n$client = new Client();\\n$client-&gt;setXApiKey(\\&quot;ADYEN_API_KEY\\&quot;);\\n$client-&gt;setEnvironment(Environment::TEST);\\n\\n$requestOptions['queryParams'] = array('storeId' =&gt; 'string', 'businessLineId' =&gt; 'string', 'pageSize' =&gt; 'integer', 'pageNumber' =&gt; 'integer');\\n\\n\\\/\\\/ Make the request\\n$service = new PaymentMethodsMerchantLevelApi($client);\\n$response = $service-&gt;getAllPaymentMethods('merchantId', $requestOptions);&quot;},{&quot;language&quot;:&quot;cs&quot;,&quot;tabTitle&quot;:&quot;C#&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen .net API Library v14.3.0\\nusing Adyen;\\nusing Environment = Adyen.Model.Environment;\\nusing Adyen.Service.Management;\\n\\nvar config = new Config()\\n{\\n    XApiKey = \\&quot;ADYEN_API_KEY\\&quot;,\\n    Environment = Environment.Test\\n};\\nvar client = new Client(config);\\n\\n\\\/\\\/ Make the request\\nvar service = new PaymentMethodsMerchantLevelService(client);\\nvar response = service.GetAllPaymentMethods(\\&quot;merchantId\\&quot;, storeId: \\&quot;string\\&quot;, businessLineId: \\&quot;string\\&quot;, pageSize: 1, pageNumber: 1);&quot;},{&quot;language&quot;:&quot;js&quot;,&quot;tabTitle&quot;:&quot;NodeJS (JavaScript)&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Node API Library v16.2.0\\n\\\/\\\/ Require the parts of the module you want to use\\nconst { Client, ManagementAPI } = require('@adyen\\\/api-library');\\n\\n\\\/\\\/ Initialize the client object\\nconst client = new Client({apiKey: \\&quot;ADYEN_API_KEY\\&quot;, environment: \\&quot;TEST\\&quot;});\\n\\n\\\/\\\/ Make the request\\nconst managementAPI = new ManagementAPI(client);\\nconst response = managementAPI.PaymentMethodsMerchantLevelApi.getAllPaymentMethods(\\&quot;merchantId\\&quot;, \\&quot;string\\&quot;, \\&quot;string\\&quot;, 1, 1);&quot;},{&quot;language&quot;:&quot;go&quot;,&quot;tabTitle&quot;:&quot;Go&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Go API Library v9.2.0\\nimport (\\n\\t\\&quot;context\\&quot;\\n\\t\\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v9\\\/src\\\/common\\&quot;\\n\\t\\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v9\\\/src\\\/adyen\\&quot;\\n\\t\\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v9\\\/src\\\/management\\&quot;\\n)\\n\\nclient := adyen.NewClient(&amp;common.Config{\\n    ApiKey:      \\&quot;ADYEN_API_KEY\\&quot;,\\n    Environment: common.TestEnv,\\n})\\n\\n\\\/\\\/ Make the request\\nservice := client.Management()\\nreq := service.PaymentMethodsMerchantLevelApi.GetAllPaymentMethodsInput(\\&quot;merchantId\\&quot;)\\nreq = req.StoreId(\\&quot;string\\&quot;).BusinessLineId(\\&quot;string\\&quot;).PageSize(1).PageNumber(1)res, httpRes, err := service.PaymentMethodsMerchantLevelApi.GetAllPaymentMethods(context.Background(), req)&quot;},{&quot;language&quot;:&quot;py&quot;,&quot;tabTitle&quot;:&quot;Python&quot;,&quot;content&quot;:&quot;# Adyen Python API Library v12.2.0\\nimport Adyen\\n\\nadyen = Adyen.Adyen()\\nadyen.client.xapikey = \\&quot;ADYEN_API_KEY\\&quot;\\nadyen.client.platform = \\&quot;test\\&quot; # The environment to use library in.\\n\\nquery_parameters = {\\n  \\&quot;storeId\\&quot; : \\&quot;string\\&quot;,\\n  \\&quot;businessLineId\\&quot; : \\&quot;string\\&quot;,\\n  \\&quot;pageSize\\&quot; : \\&quot;integer\\&quot;,\\n  \\&quot;pageNumber\\&quot; : \\&quot;integer\\&quot;\\n}\\n\\nresult = adyen.management.payment_methods_merchant_level_api.get_all_payment_methods(merchantId=\\&quot;merchantId\\&quot;, query_parameters=query_parameters)&quot;},{&quot;language&quot;:&quot;rb&quot;,&quot;tabTitle&quot;:&quot;Ruby&quot;,&quot;content&quot;:&quot;# Adyen Ruby API Library v9.2.0\\nrequire \\&quot;adyen-ruby-api-library\\&quot;\\n\\nadyen = Adyen::Client.new\\nadyen.api_key = 'ADYEN_API_KEY'\\nadyen.env = :test # Set to \\&quot;live\\&quot; for live environment\\n\\nquery_params = {\\n  :storeId =&gt; 'string',\\n  :businessLineId =&gt; 'string',\\n  :pageSize =&gt; 'integer',\\n  :pageNumber =&gt; 'integer'\\n}\\n\\nresult = adyen.management.payment_methods_merchant_level_api.get_all_payment_methods('merchantId', query_params: query_params)&quot;},{&quot;language&quot;:&quot;ts&quot;,&quot;tabTitle&quot;:&quot;NodeJS (TypeScript)&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Node API Library v16.2.0\\n\\\/\\\/ Require the parts of the module you want to use\\nimport { Client, ManagementAPI, Types } from \\&quot;@adyen\\\/api-library\\&quot;;\\n\\n\\\/\\\/ Initialize the client object\\nconst client = new Client({apiKey: \\&quot;ADYEN_API_KEY\\&quot;, environment: \\&quot;TEST\\&quot;});\\n\\n\\\/\\\/ Make the request\\nconst managementAPI = new ManagementAPI(client);\\nconst response = managementAPI.PaymentMethodsMerchantLevelApi.getAllPaymentMethods(\\&quot;merchantId\\&quot;, \\&quot;string\\&quot;, \\&quot;string\\&quot;, 1, 1);&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Response'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    ...,\\n    \\\"data\\\": [\\n        {\\n            \\\"PaymentMethod\\\": {\\n                \\\"id\\\": \\\"PM3227C223224K5DSP4NSDKPK\\\",\\n                \\\"type\\\": \\\"amex\\\",\\n                \\\"storeId\\\": \\\"ST322LJ223223K5F4SQNR9XL5\\\",\\n                \\\"enabled\\\": true,\\n                \\\"countries\\\": [],\\n                \\\"currencies\\\": []\\n            }\\n        }\\n    ]\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<\/ol>\n<h3 id=\"update-payment-method\">Update a payment method<\/h3>\n<p>After adding a payment method to a store, you can change its settings. For example, to update the supported countries\/regions or currencies, or to disable the payment method.<\/p>\n<p>To update a payment method:<\/p>\n<ol>\n<li>\n<p>Make sure that you know the <code>id<\/code> of the payment method for the applicable store. To find this value, make a GET request to  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/merchants\/(merchantId)\/paymentMethodSettings\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/merchants\/{merchantId}\/paymentMethodSettings<\/a>.<\/p>\n<\/li>\n<li>\n<p>Make a PATCH request to  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/patch\/merchants\/(merchantId)\/paymentMethodSettings\/(paymentMethodId)\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/merchants\/{merchantId}\/paymentMethodSettings\/{paymentMethodId}<\/a>, 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\/(merchantId)\/paymentMethodSettings#request-countries\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">countries<\/a><\/td>\n<td style=\"text-align: center;\"><\/td>\n<td>The list of countries to enable with the payment method. If sent empty, then all countries are supported by the payment method.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/merchants\/(merchantId)\/paymentMethodSettings#request-currencies\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">currencies<\/a><\/td>\n<td style=\"text-align: center;\"><\/td>\n<td>The list of currencies to enable with the payment method. If sent empty, then all currencies are supported by the payment method.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/patch\/merchants\/(merchantId)\/paymentMethodSettings\/(paymentMethodId)#request-enabled\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">enabled<\/a><\/td>\n<td style=\"text-align: center;\"><\/td>\n<td>Indicates whether the payment method is enabled (<strong>true<\/strong>) or disabled (<strong>false<\/strong>).<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Because the payment method ID in the path is unique for the store where the payment method is set up, there is no need to specify a store.<\/p>\n<p>The next example updates American Express with payments in Canadian dollars:<\/p>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Update payment method settings'\" :id=\"'update-payment-method-settings-5309933059'\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;curl&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/management-test.adyen.com\\\/v3\\\/merchants\\\/{merchantId}\\\/paymentMethodSettings\\\/PM3227C223224K5DSP4NSDKPK \\\\\\n-H 'x-API-key: ADYEN_API_KEY' \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-X PATCH \\\\\\n-d '{\\n    \\&quot;currencies\\&quot;: [\\n       \\&quot;CAD\\&quot;,\\n       \\&quot;USD\\&quot;\\n    ]\\n}'&quot;},{&quot;language&quot;:&quot;java&quot;,&quot;tabTitle&quot;:&quot;Java&quot;,&quot;content&quot;:&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(\\&quot;ADYEN_API_KEY\\&quot;, Environment.TEST);\\n\\n\\\/\\\/ Request objects\\nUpdatePaymentMethodInfo updatePaymentMethodInfo = new UpdatePaymentMethodInfo()\\n\\t.currencies(Arrays.asList(\\&quot;CAD\\&quot;, \\&quot;USD\\&quot;));\\n\\n\\\/\\\/ Make the request\\nPaymentMethodsMerchantLevelApi service = new PaymentMethodsMerchantLevelApi(client);\\nPaymentMethod response = service.updatePaymentMethod(\\&quot;merchantId\\&quot;, \\&quot;paymentMethodId\\&quot;, updatePaymentMethodInfo, null);&quot;},{&quot;language&quot;:&quot;php&quot;,&quot;tabTitle&quot;:&quot;PHP&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen PHP API Library v17.4.0\\nuse Adyen\\\\Client;\\nuse Adyen\\\\Environment;\\nuse Adyen\\\\Model\\\\Management\\\\UpdatePaymentMethodInfo;\\nuse Adyen\\\\Service\\\\Management\\\\PaymentMethodsMerchantLevelApi;\\n\\n$client = new Client();\\n$client-&gt;setXApiKey(\\&quot;ADYEN_API_KEY\\&quot;);\\n$client-&gt;setEnvironment(Environment::TEST);\\n\\n\\n\\\/\\\/ Request objects\\n$updatePaymentMethodInfo = new UpdatePaymentMethodInfo();\\n$updatePaymentMethodInfo\\n\\t-&gt;setCurrencies(array(\\&quot;CAD\\&quot;, \\&quot;USD\\&quot;));\\n\\n\\\/\\\/ Make the request\\n$service = new PaymentMethodsMerchantLevelApi($client);\\n$response = $service-&gt;updatePaymentMethod('merchantId', 'paymentMethodId', $updatePaymentMethodInfo);&quot;},{&quot;language&quot;:&quot;cs&quot;,&quot;tabTitle&quot;:&quot;C#&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen .net API Library v14.3.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 = \\&quot;ADYEN_API_KEY\\&quot;,\\n    Environment = Environment.Test\\n};\\nvar client = new Client(config);\\n\\n\\\/\\\/ Fill in your request objects\\nUpdatePaymentMethodInfo updatePaymentMethodInfo = new UpdatePaymentMethodInfo\\n{\\n\\tCurrencies = { \\&quot;CAD\\&quot;, \\&quot;USD\\&quot; }\\n};\\n\\n\\\/\\\/ Make the request\\nvar service = new PaymentMethodsMerchantLevelService(client);\\nvar response = service.UpdatePaymentMethod(\\&quot;merchantId\\&quot;, \\&quot;paymentMethodId\\&quot;, updatePaymentMethodInfo);&quot;},{&quot;language&quot;:&quot;js&quot;,&quot;tabTitle&quot;:&quot;NodeJS (JavaScript)&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Node API Library v16.2.0\\n\\\/\\\/ Require the parts of the module you want to use\\nconst { Client, ManagementAPI } = require('@adyen\\\/api-library');\\n\\n\\\/\\\/ Initialize the client object\\nconst client = new Client({apiKey: \\&quot;ADYEN_API_KEY\\&quot;, environment: \\&quot;TEST\\&quot;});\\n\\n\\\/\\\/ Create the request object\\nconst updatePaymentMethodInfo = {\\n  currencies: [ \\&quot;CAD\\&quot;, \\&quot;USD\\&quot; ]\\n}\\n\\n\\\/\\\/ Make the request\\nconst managementAPI = new ManagementAPI(client);\\nconst response = managementAPI.PaymentMethodsMerchantLevelApi.updatePaymentMethod(\\&quot;merchantId\\&quot;, \\&quot;paymentMethodId\\&quot;, updatePaymentMethodInfo);&quot;},{&quot;language&quot;:&quot;go&quot;,&quot;tabTitle&quot;:&quot;Go&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Go API Library v9.2.0\\nimport (\\n\\t\\&quot;context\\&quot;\\n\\t\\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v9\\\/src\\\/common\\&quot;\\n\\t\\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v9\\\/src\\\/adyen\\&quot;\\n\\t\\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v9\\\/src\\\/management\\&quot;\\n)\\n\\nclient := adyen.NewClient(&amp;common.Config{\\n    ApiKey:      \\&quot;ADYEN_API_KEY\\&quot;,\\n    Environment: common.TestEnv,\\n})\\n\\n\\\/\\\/ Fill in your request objects\\nupdatePaymentMethodInfo := management.UpdatePaymentMethodInfo{\\n\\tCurrencies: []string{\\n\\t\\t\\&quot;CAD\\&quot;, \\&quot;USD\\&quot;,\\n\\t},\\n}\\n\\n\\\/\\\/ Make the request\\nservice := client.Management()\\nreq := service.PaymentMethodsMerchantLevelApi.UpdatePaymentMethodInput(\\&quot;merchantId\\&quot;,\\&quot;paymentMethodId\\&quot;).UpdatePaymentMethodInfo(updatePaymentMethodInfo)\\nres, httpRes, err := service.PaymentMethodsMerchantLevelApi.UpdatePaymentMethod(context.Background(), req)&quot;},{&quot;language&quot;:&quot;py&quot;,&quot;tabTitle&quot;:&quot;Python&quot;,&quot;content&quot;:&quot;# Adyen Python API Library v12.2.0\\nimport Adyen\\n\\nadyen = Adyen.Adyen()\\nadyen.client.xapikey = \\&quot;ADYEN_API_KEY\\&quot;\\nadyen.client.platform = \\&quot;test\\&quot; # The environment to use library in.\\n\\njson_request = {\\n  \\&quot;currencies\\&quot;: [ \\&quot;CAD\\&quot;, \\&quot;USD\\&quot; ]\\n}\\n\\nresult = adyen.management.payment_methods_merchant_level_api.update_payment_method(request=json_request, merchantId=\\&quot;merchantId\\&quot;, paymentMethodId=\\&quot;paymentMethodId\\&quot;)&quot;},{&quot;language&quot;:&quot;rb&quot;,&quot;tabTitle&quot;:&quot;Ruby&quot;,&quot;content&quot;:&quot;# Adyen Ruby API Library v9.2.0\\nrequire \\&quot;adyen-ruby-api-library\\&quot;\\n\\nadyen = Adyen::Client.new\\nadyen.api_key = 'ADYEN_API_KEY'\\nadyen.env = :test # Set to \\&quot;live\\&quot; for live environment\\n\\nrequest_body = {\\n  :currencies =&gt; [ 'CAD', 'USD' ]\\n}\\n\\nresult = adyen.management.payment_methods_merchant_level_api.update_payment_method(request_body, 'merchantId', 'paymentMethodId')&quot;},{&quot;language&quot;:&quot;ts&quot;,&quot;tabTitle&quot;:&quot;NodeJS (TypeScript)&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Node API Library v16.2.0\\n\\\/\\\/ Require the parts of the module you want to use\\nimport { Client, ManagementAPI, Types } from \\&quot;@adyen\\\/api-library\\&quot;;\\n\\n\\\/\\\/ Initialize the client object\\nconst client = new Client({apiKey: \\&quot;ADYEN_API_KEY\\&quot;, environment: \\&quot;TEST\\&quot;});\\n\\n\\\/\\\/ Create the request objects\\nconst updatePaymentMethodInfo: Types.management.UpdatePaymentMethodInfo = {\\n\\tcurrencies: [\\&quot;CAD\\&quot;, \\&quot;USD\\&quot;]\\n};\\n\\n\\\/\\\/ Make the request\\nconst managementAPI = new ManagementAPI(client);\\nconst response = managementAPI.PaymentMethodsMerchantLevelApi.updatePaymentMethod(\\&quot;merchantId\\&quot;, \\&quot;paymentMethodId\\&quot;, updatePaymentMethodInfo);&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<li>\n<p>In the response, note that this contains the <code>storeId<\/code> of the store that the payment method was updated for.<\/p>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Response'\" :id=\"'update-pm-response'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"id\\\": \\\"PM3227C223224K5DSP4NSDKPK\\\",\\n    \\\"type\\\": \\\"amex\\\",\\n    \\\"storeId\\\": \\\"ST322LJ223223K5F4SQNR9XL5\\\",\\n    \\\"enabled\\\": true,\\n    \\\"countries\\\": [],\\n    \\\"currencies\\\": [\\n        \\\"CAD\\\",\\n        \\\"USD\\\"\\n    ]\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<\/ol>\n<h2 id=\"update-store\">Update a store<\/h2>\n<p>To update a store, you need to know its <a href=\"#store-identification\">unique store ID<\/a>. In your request, include only the parameters you want to update. The same applies if the parameter is inside an object.<\/p>\n<p>For example, to change the postal code and remove the third address line from the store address, the <code>address<\/code> object should include the <code>postalCode<\/code> parameter with the new value, and the <code>line3<\/code> parameter with an empty value.<\/p>\n<p>To update a store:<\/p>\n<ol>\n<li>\n<p>Make sure that you know the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/get\/stores#responses-200-id\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">id<\/a> of the store. To find this value, get a <a href=\"#get-all-stores\">list of stores<\/a>.<\/p>\n<\/li>\n<li>\n<p>To update the store, use the following endpoints:<\/p>\n<ul>\n<li>PATCH  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/patch\/stores\/(storeId)\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/stores\/{storeId}<\/a><\/li>\n<li>PATCH  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/patch\/merchants\/(merchantId)\/stores\/(storeId)\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/merchants\/{merchantId}\/stores\/{storeId}<\/a><\/li>\n<\/ul>\n<p>In the request body, include any of the following parameters:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter<\/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\/patch\/stores\/(storeId)#request-address\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">address<\/a><\/td>\n<td style=\"text-align: left;\">Can contain string values for the following parameters: <ul><li><code>city<\/code>: The city of the store.<\/li> <li><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. <\/li> <li><code>postalCode<\/code>: The postal code of the store. Must be in the same postal code format as the country of the store. <\/li><code>stateOrProvince<\/code>: <em>Required for Australia, Brazil, Canada, India, Mexico, New Zealand, United States.<\/em> The state or province of the store as defined in <a href=\"https:\/\/www.iso.org\/iso-3166-country-codes.html\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">ISO 3166-2<\/a>. For example, <strong>ON<\/strong> for Ontario, Canada.<\/li><\/ul>  <div class=\"notices green\">It is not possible to update the country of the store.<\/div><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/patch\/stores\/(storeId)#request-description\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">description<\/a><\/td>\n<td style=\"text-align: left;\">Your description of the store.<\/td>\n<td style=\"text-align: left;\"> <\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/patch\/stores\/(storeId)#request-externalReferenceId\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">externalReferenceId<\/a><\/td>\n<td style=\"text-align: left;\"><em>Only when using the Zip payment method.<\/em> <p>The location ID that Zip has assigned to your store.<\/p><\/td>\n<td style=\"text-align: left;\"><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/patch\/stores\/(storeId)#request-splitConfiguration\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">splitConfiguration<\/a><\/td>\n<td style=\"text-align: left;\"> <em>Only for Adyen for Platforms merchants.<\/em><br><br> An object containing the information required to <a href=\"\/pt\/platforms\/automatic-split-configuration\">automatically split transactions<\/a> that are routed through this store.<p>This object consists of: <ul><li> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/merchants\/(merchantId)\/splitConfigurations#responses-200-splitConfigurationId\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">splitConfigurationId<\/a>: the unique identifier of the <a href=\"\/pt\/platforms\/automatic-split-configuration\/create-split-configuration\">split configuration<\/a> that you want to add to the store.<\/li><li> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/balanceplatform\/latest\/get\/accountHolders\/(id)\/balanceAccounts#responses-200-balanceAccounts-id\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balanceAccountId<\/a>: The unique identifier of the balance account to which the split amount must be booked, depending on the defined  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/post\/merchants\/(merchantId)\/splitConfigurations#request-rules-splitLogic\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">splitLogic<\/a>.<\/li><\/ul><\/p><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Management\/latest\/patch\/stores\/(storeId)#request-status\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">status<\/a><\/td>\n<td style=\"text-align: left;\">The <a href=\"#store-status\">status<\/a> of the store. You can change the status from <strong>active<\/strong> to <strong>inactive<\/strong> or from <strong>inactive<\/strong> to <strong>active<\/strong> or <strong>closed<\/strong>. After a store is <strong>closed<\/strong>, you cannot change the status anymore.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>This example shows how you update a store'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:<\/p>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Update a store\\'s address'\" :id=\"'update-store-address'\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;curl&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/management-test.adyen.com\\\/v3\\\/stores\\\/ST322LJ223223K5F4SQNR9XL5 \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-H 'x-api-key: ADYEN_API_KEY' \\\\\\n-X PATCH \\\\\\n-d '{\\n   \\&quot;address\\&quot;:{\\n      \\&quot;line1\\&quot;: \\&quot;1776 West Pinewood Avenue\\&quot;,\\n      \\&quot;line2\\&quot;: \\&quot;Heartland Building\\&quot;,\\n      \\&quot;line3\\&quot;: \\&quot;\\&quot;,\\n      \\&quot;postalCode\\&quot;:\\&quot;20251\\&quot;\\n   }\\n}'&quot;},{&quot;language&quot;:&quot;java&quot;,&quot;tabTitle&quot;:&quot;Java&quot;,&quot;content&quot;:&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(\\&quot;ADYEN_API_KEY\\&quot;, Environment.TEST);\\n\\n\\\/\\\/ Create the request object(s)\\nUpdatableAddress updatableAddress = new UpdatableAddress()\\n  .postalCode(\\&quot;20251\\&quot;)\\n  .line3(\\&quot;\\&quot;)\\n  .line2(\\&quot;Heartland Building\\&quot;)\\n  .line1(\\&quot;1776 West Pinewood Avenue\\&quot;);\\n\\nUpdateStoreRequest updateStoreRequest = new UpdateStoreRequest()\\n  .address(updatableAddress);\\n\\n\\\/\\\/ Make the API call\\nAccountStoreLevelApi service = new AccountStoreLevelApi(client);\\nStore response = service.updateStoreById(\\&quot;storeId\\&quot;, updateStoreRequest, null);&quot;},{&quot;language&quot;:&quot;php&quot;,&quot;tabTitle&quot;:&quot;PHP&quot;,&quot;content&quot;:&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-&gt;setXApiKey(\\&quot;ADYEN_API_KEY\\&quot;);\\n$client-&gt;setEnvironment(Environment::TEST);\\n\\n\\n\\\/\\\/ Create the request object(s)\\n$updatableAddress = new UpdatableAddress();\\n$updatableAddress\\n  -&gt;setPostalCode(\\&quot;20251\\&quot;)\\n  -&gt;setLine3(\\&quot;\\&quot;)\\n  -&gt;setLine2(\\&quot;Heartland Building\\&quot;)\\n  -&gt;setLine1(\\&quot;1776 West Pinewood Avenue\\&quot;);\\n\\n$updateStoreRequest = new UpdateStoreRequest();\\n$updateStoreRequest\\n  -&gt;setAddress($updatableAddress);\\n\\n\\\/\\\/ Make the API call\\n$service = new AccountStoreLevelApi($client);\\n$response = $service-&gt;updateStoreById('storeId', $updateStoreRequest);&quot;},{&quot;language&quot;:&quot;cs&quot;,&quot;tabTitle&quot;:&quot;C#&quot;,&quot;content&quot;:&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 = \\&quot;ADYEN_API_KEY\\&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 = \\&quot;20251\\&quot;,\\n  Line3 = \\&quot;\\&quot;,\\n  Line2 = \\&quot;Heartland Building\\&quot;,\\n  Line1 = \\&quot;1776 West Pinewood Avenue\\&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(\\&quot;storeId\\&quot;, updateStoreRequest);&quot;},{&quot;language&quot;:&quot;js&quot;,&quot;tabTitle&quot;:&quot;NodeJS (JavaScript)&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Node API Library v16.2.0\\n\\\/\\\/ Require the parts of the module you want to use\\nconst { Client, ManagementAPI } = require('@adyen\\\/api-library');\\n\\\/\\\/ Initialize the client object\\nconst client = new Client({apiKey: \\&quot;ADYEN_API_KEY\\&quot;, environment: \\&quot;TEST\\&quot;});\\n\\n\\\/\\\/ Create the request object(s)\\nconst updateStoreRequest = {\\n  address: {\\n    line1: \\&quot;1776 West Pinewood Avenue\\&quot;,\\n    line2: \\&quot;Heartland Building\\&quot;,\\n    line3: \\&quot;\\&quot;,\\n    postalCode: \\&quot;20251\\&quot;\\n  }\\n}\\n\\n\\\/\\\/ Make the API call\\nconst managementAPI = new ManagementAPI(client);\\nconst response = managementAPI.AccountStoreLevelApi.updateStoreById(\\&quot;storeId\\&quot;, updateStoreRequest);&quot;},{&quot;language&quot;:&quot;go&quot;,&quot;tabTitle&quot;:&quot;Go&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Go API Library v9.3.0\\nimport (\\n  \\&quot;context\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v9\\\/src\\\/common\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v9\\\/src\\\/adyen\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v9\\\/src\\\/management\\&quot;\\n)\\nclient := adyen.NewClient(&amp;common.Config{\\n  ApiKey:      \\&quot;ADYEN_API_KEY\\&quot;,\\n  Environment: common.TestEnv,\\n})\\n\\n\\\/\\\/ Create the request object(s)\\nupdatableAddress := management.UpdatableAddress{\\n  PostalCode: common.PtrString(\\&quot;20251\\&quot;),\\n  Line3: common.PtrString(\\&quot;\\&quot;),\\n  Line2: common.PtrString(\\&quot;Heartland Building\\&quot;),\\n  Line1: common.PtrString(\\&quot;1776 West Pinewood Avenue\\&quot;),\\n}\\n\\nupdateStoreRequest := management.UpdateStoreRequest{\\n  Address: &amp;updatableAddress,\\n}\\n\\n\\\/\\\/ Make the API call\\nservice := client.Management()\\nreq := service.AccountStoreLevelApi.UpdateStoreByIdInput(\\&quot;storeId\\&quot;).UpdateStoreRequest(updateStoreRequest)\\nres, httpRes, err := service.AccountStoreLevelApi.UpdateStoreById(context.Background(), req)&quot;},{&quot;language&quot;:&quot;py&quot;,&quot;tabTitle&quot;:&quot;Python&quot;,&quot;content&quot;:&quot;# Adyen Python API Library v12.2.0\\nimport Adyen\\n\\nadyen = Adyen.Adyen()\\nadyen.client.xapikey = \\&quot;ADYEN_API_KEY\\&quot;\\nadyen.client.platform = \\&quot;test\\&quot; # The environment to use library in.\\n\\n# Create the request object(s)\\njson_request = {\\n  \\&quot;address\\&quot;: {\\n    \\&quot;line1\\&quot;: \\&quot;1776 West Pinewood Avenue\\&quot;,\\n    \\&quot;line2\\&quot;: \\&quot;Heartland Building\\&quot;,\\n    \\&quot;line3\\&quot;: \\&quot;\\&quot;,\\n    \\&quot;postalCode\\&quot;: \\&quot;20251\\&quot;\\n  }\\n}\\n\\n# Make the API call\\nresult = adyen.management.account_store_level_api.update_store_by_id(request=json_request, storeId=\\&quot;storeId\\&quot;)&quot;},{&quot;language&quot;:&quot;rb&quot;,&quot;tabTitle&quot;:&quot;Ruby&quot;,&quot;content&quot;:&quot;# Adyen Ruby API Library v9.3.0\\nrequire \\&quot;adyen-ruby-api-library\\&quot;\\n\\nadyen = Adyen::Client.new\\nadyen.api_key = 'ADYEN_API_KEY'\\nadyen.env = :test # Set to \\&quot;live\\&quot; for live environment\\n\\n# Create the request object(s)\\nrequest_body = {\\n  :address =&gt; {\\n    :line1 =&gt; '1776 West Pinewood Avenue',\\n    :line2 =&gt; 'Heartland Building',\\n    :line3 =&gt; '',\\n    :postalCode =&gt; '20251'\\n  }\\n}\\n\\n# Make the API call\\nresult = adyen.management.account_store_level_api.update_store_by_id(request_body, 'storeId')&quot;},{&quot;language&quot;:&quot;ts&quot;,&quot;tabTitle&quot;:&quot;NodeJS (TypeScript)&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Node API Library v16.2.0\\n\\\/\\\/ Require the parts of the module you want to use\\nimport { Client, ManagementAPI, Types } from \\&quot;@adyen\\\/api-library\\&quot;;\\n\\\/\\\/ Initialize the client object\\nconst client = new Client({apiKey: \\&quot;ADYEN_API_KEY\\&quot;, environment: \\&quot;TEST\\&quot;});\\n\\n\\\/\\\/ Create the request object(s)\\nconst updatableAddress: Types.management.UpdatableAddress = {\\n  postalCode: \\&quot;20251\\&quot;,\\n  line3: \\&quot;\\&quot;,\\n  line2: \\&quot;Heartland Building\\&quot;,\\n  line1: \\&quot;1776 West Pinewood Avenue\\&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(\\&quot;storeId\\&quot;, updateStoreRequest);&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<li>\n<p>Note that the response includes the full store details.<\/p>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Store address updated'\" :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;1776 West Pinewood Avenue\\&quot;,\\n        \\&quot;line2\\&quot;: \\&quot;Heartland Building\\&quot;,\\n        \\&quot;city\\&quot;: \\&quot;Springfield\\&quot;,\\n        \\&quot;stateOrProvince\\&quot;: \\&quot;NY\\&quot;,\\n        \\&quot;postalCode\\&quot;:\\&quot;20251\\&quot;\\n    },\\n    \\&quot;description\\&quot;: \\&quot;City Centre store\\&quot;,\\n    \\&quot;merchantId\\&quot;: \\&quot;YOUR_MERCHANT_ACCOUNT_ID\\&quot;,\\n    \\&quot;phoneNumber\\&quot;: \\&quot;+13121112222\\&quot;,\\n    \\&quot;reference\\&quot;: \\&quot;Spring_store_2\\&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=\"see-also\">See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/point-of-sale\/automating-terminal-management\/order-terminals-api\"\n                        target=\"_self\"\n                        >\n                    Order terminals using API requests\n                <\/a><\/li><li><a href=\"\/point-of-sale\/automating-terminal-management\/assign-terminals-api\"\n                        target=\"_self\"\n                        >\n                    Assign terminals using API requests\n                <\/a><\/li><li><a href=\"\/point-of-sale\/automating-terminal-management\/configure-terminals-api\"\n                        target=\"_self\"\n                        >\n                    Configure terminals using API requests\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/design-your-integration\/determine-account-structure\/automate-store-management","articleFields":{"description":"Use API requests to create, retrieve, and update your stores","feedback_component":true,"parameters":{"integrationType":"direct"},"page_id":"8f62a710-3e9e-4955-a593-338050ac7f28","filters_component":false,"decision_tree":"[]"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/design-your-integration\/determine-account-structure\/automate-store-management","title":"Automate store management","content":"The Management API lets you retrieve, create, and update your stores by making API requests. You can also do this manually in your Customer Area, but with API requests you can automate these processes.\nFor more information about stores and point-of-sale account structures, see Set up your Adyen account for point of sale.\nWhen creating and managing stores using API requests, you need to be aware of:\n\nHow stores are identified.\nThe status that a store can have.\n\nRequirements\nBefore you begin, take into account the following requirements, limitations, and preparations.\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nA point-of-sale integration with Adyen.\n\n\nAPI credentials\nYou must have an API credential with an API key and the following roles: Management API\u2014Stores read Management API\u2014Stores read and write Management API\u2014Payment methods read Management API\u2014Payment methods read and write If you have a Terminal API integration with cloud-based communications, you can use the existing API key that you use for Terminal API requests.\n\n\nLimitations\nRequests to live Management API endpoints related to stores are subject to rate limits.\n\n\n\nStore identification\nHistorically, stores under a merchant account have a human-readable reference, also known as the store code. This reference is unique for the merchant account. However, it is possible that a store reference is not unique on our platform. So we introduced a platform-generated unique store ID for each store.\nWhen you create a store, you can provide a reference for it, and Adyen will automatically assign a unique ID.\nFor existing stores, the situation can vary. We are currently assigning unique IDs to existing stores, but it will take a while before this is completed. This means that if your existing store doesn't have an ID yet, you cannot make a PATCH request to update the store.\nOpening and closing stores\nStores can have three statuses that determine how they operate:\n\n\nActive: When you create a store, it is automatically set to active.   After assigning and boarding payment terminals, the store is immediately open for business. \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.  The maximum transaction limits and number of Store-and-Forward transactions for the store are set to zero (0).  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.  Then, when you change the store status from inactive to closed, all payment terminals under the store are immediately reassigned to the merchant inventory. This means the terminals need to be assigned to a different store and boarded before they can process transactions again.  It is not possible to change the status anymore because a closed store cannot be reopened.\n\n\nRetrieve store details\nYou can make API requests to:\n\nGet a list of stores. For each store, the response includes the full details.\nGet the details of a specific store.\n\nGet a list of stores\n\n\nTo get a list of stores, use one of the following endpoints:\n\nGET  \/stores for the details of all stores that your API key has access to.\nGET  \/merchants\/{merchantId}\/stores for the details of the stores under a specific merchant account. To find the merchantId, make a GET request to  \/merchants.\n\nYou can filter the paginated response using the following query parameters:\n\n pageNumber&#58; returns the stores listed on the specified page.\n pageSize&#58; the number of stores to have on a page. The default is 10, the maximum is 100.\n merchantId&#58; the merchant account ID that a store belongs to. You can only use this query parameter with a GET  \/stores request.\n reference&#58; the reference of the store. Because a store reference is only unique within a merchant account, a GET  \/stores request using the store reference as a query parameter returns all stores with that reference, including those of different merchant accounts.\n\n\n\n\n\n\nIn the response, note the id of the store. You can use this value to get the details of a specific store or to update a store.\nThe next table shows the store details that the response can include.\n\n\n\nParameter\nDescription\n\n\n\n\n address\nAn object that contains: city: The city of the store. country: The country of the store. line1 line2 line3: Up to three lines used for the street name, street number, and other information. postalCode: The postal code of the store. stateOrProvince: The state or province code as defined in ISO 3166-2. For example, IL for Illinois in the United States.\n\n\n description\nThe description of the store.\n\n\n\n externalReferenceId\nThe unique identifier of the store, used by certain payment methods and tax authorities.\n\n\n\n id\nUnique identifier of the store, starting with ST. This value is generated by Adyen.\n\n\n\n _links\nThe URL of the store.\n\n\n merchantId\nThe ID of the merchant account that the store belongs to.\n\n\n phoneNumber\nThe phone number of the store, including the country code.\n\n\n reference\nYour reference to recognize the store by. If a reference was not specified when the store was created, the reference is populated with the store id.\n\n\n shopperStatement\nStore name shown on the shopper's bank or credit card statement and on the shopper receipt.\n\n\n splitConfiguration\n Only for Adyen for Platforms merchants. An object containing the information required to automatically split transactions that are routed through this store.This object consists of:  splitConfigurationId: the unique identifier of the split configuration profile that you want to add to the store. balanceAccountId: The unique identifier of the balance account to which the split amount must be booked, depending on the defined  splitLogic.\n\n\n status\nThe status of the store.\n\n\n\n\n\n\n\n\nGet the details of a specific store\n\n\nMake sure that you know the id or the reference of the store. To find these values, get a list of stores.\n\n\nTo get the details of a single store, use the following endpoints:\n\nGET  \/stores\/{storeId}\nGET  \/merchants\/{merchantId}\/stores\/{storeId}\n\nYou can also use the store  reference as a query parameter. Because the reference is only unique within a merchant account, if you use the  \/stores endpoint you get all stores with that reference, including those of different merchant accounts.\nTo get the details of a store under a merchant account using the store reference, make a GET request to  \/merchants\/{merchantId}\/stores?reference={reference}.\nThis example shows how to get information about a store using the store ID in the path.\n\n\n\n\n\nNote that the response returns the same details as when you get a list of stores, but only for the specified store.\n\n\n\n\n\nCreate a store\nBefore you create a store, make sure you know the merchant account ID that the store will be associated with.\nFor a list of merchant account IDs accessible with your API key, make a GET  \/merchants request.\n\n\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 for Australia, Brazil, Canada, India, Mexico, New Zealand, United States. The state or province of the store as defined in ISO 3166-2. For example, ON for Ontario, Canada. \n\n\n description\n\nA description for the store.\n\n\n\n externalReferenceId\n\nOnly when using the Zip payment method. The location ID that Zip has assigned to your 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 splitConfiguration\n\n Only for Adyen for Platforms merchants. An object containing the information required to automatically split transactions that are routed through this store.This object consists of:  splitConfigurationId: the unique identifier of the split configuration that you want to add to the store. balanceAccountId: The unique identifier of the balance account to which the split amount must be booked, depending on the defined  splitLogic.\n \n\n\n localizedInformation\n\nOnly for stores in Japan. An object that provides localized information about the store, in the relevant character set. This object consists of:  localShopperStatement: an array with localized shopper statements which card schemes use in the bank statement. Each array item consists of: script: the character set. Allowed values: ja-Hani (Kanji) and ja-Kana (Katakana). value: the text of the shopper statement, in the specified character set.  For Japan, the card schemes require two local shopper statements, one in ja-Hani and one in ja-Kana. \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\n\n\nIn the response, note that this includes the Adyen-generated  id for the store. You can use this as a path parameter to update the store.\n\n\n\n    \n\n\nAdd payment methods to the store.\n\n\nManage payment methods\nA newly created store doesn't have any payment methods yet. You need to add payment methods one at a time. Every payment method that you add, gets an ID that is unique for the combination of that payment method and store. Using this ID, you can update the settings of that payment method in the corresponding store.\nAdd a payment method\n\n\nTo decide what payment method to add:\n\n\nSee the list of payment methods that you can add using Management API.\n\nSome payment methods (like iDEAL) only apply to web shops and are not supported on payment terminals.\n\n\n\nFor a list of payment methods that are already enabled for your store, make a GET request to  \/merchants\/{merchantId}\/paymentMethodSettings with your store ID as a query parameter.\nFor example,  ...\/paymentMethodSettings?storeID=ST322LJ223223K5F4SQNR9XL5.\n\n\n\n\n\nTo add a payment method to your store, make a POST request to  \/merchants\/{merchantId}\/paymentMethodSettings with your store ID in the request body (not as a query parameter). Specify:\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\n type\n\nPayment method type. Some payment methods require an additional object with payment method details.\n\n\n\n businessLineId\n\nThe unique identifier of your user's business line that you want to request a payment method for.\n\n\n\n storeIds\n\nThe id of the store that you get when creating a store .\n\n\n countries\n\nThe list of countries to enable with the payment method. To enable all countries supported by the payment method, set to ANY or send empty.\n\n\n currencies\n\nThe list of currencies to enable with the payment method. To enable all currencies supported by the payment method, set to ANY or send empty.\n\n\n\nThe following example adds American Express.\n\n\n\n\n\nIn the response, note that this includes the id of the payment method. This ID is specific for the combination of payment method and store. You can use this as a path parameter to update the settings of the payment method.\n\n\n\n\n\nTo check if the added payment method is enabled, make a GET request to  \/merchants\/{merchantId}\/paymentMethodSettings with your store ID as a query parameter.\n\n\n\n\n\n\n\n\nUpdate a payment method\nAfter adding a payment method to a store, you can change its settings. For example, to update the supported countries\/regions or currencies, or to disable the payment method.\nTo update a payment method:\n\n\nMake sure that you know the id of the payment method for the applicable store. To find this value, make a GET request to  \/merchants\/{merchantId}\/paymentMethodSettings.\n\n\nMake a PATCH request to  \/merchants\/{merchantId}\/paymentMethodSettings\/{paymentMethodId}, specifying:\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\n countries\n\nThe list of countries to enable with the payment method. If sent empty, then all countries are supported by the payment method.\n\n\n currencies\n\nThe list of currencies to enable with the payment method. If sent empty, then all currencies are supported by the payment method.\n\n\n enabled\n\nIndicates whether the payment method is enabled (true) or disabled (false).\n\n\n\nBecause the payment method ID in the path is unique for the store where the payment method is set up, there is no need to specify a store.\nThe next example updates American Express with payments in Canadian dollars:\n\n\n\n\n\nIn the response, note that this contains the storeId of the store that the payment method was updated for.\n\n\n\n\n\nUpdate a store\nTo update a store, you need to know its unique store ID. In your request, include only the parameters you want to update. The same applies if the parameter is inside an object.\nFor example, to change the postal code and remove the third address line from the store address, the address object should include the postalCode parameter with the new value, and the line3 parameter with an empty value.\nTo update a store:\n\n\nMake sure that you know the  id of the store. To find this value, get a list of stores.\n\n\nTo update the store, use the following endpoints:\n\nPATCH  \/stores\/{storeId}\nPATCH  \/merchants\/{merchantId}\/stores\/{storeId}\n\nIn the request body, include any of the following parameters:\n\n\n\nParameter\nDescription\n\n\n\n\n address\nCan contain string values for the following parameters: city: The city of the store. line1 line2 line3: Up to three lines can be used for the street name, street number, and other information.  postalCode: The postal code of the store. Must be in the same postal code format as the country of the store. stateOrProvince: Required for Australia, Brazil, Canada, India, Mexico, New Zealand, United States. The state or province of the store as defined in ISO 3166-2. For example, ON for Ontario, Canada.  It is not possible to update the country of the store.\n\n\n description\nYour description of the store.\n \n\n\n externalReferenceId\nOnly when using the Zip payment method. The location ID that Zip has assigned to your store.\n\n\n\n splitConfiguration\n Only for Adyen for Platforms merchants. An object containing the information required to automatically split transactions that are routed through this store.This object consists of:  splitConfigurationId: the unique identifier of the split configuration that you want to add to the store. balanceAccountId: The unique identifier of the balance account to which the split amount must be booked, depending on the defined  splitLogic.\n\n\n status\nThe status of the store. You can change the status from active to inactive or from inactive to active or closed. After a store is closed, you cannot change the status anymore.\n\n\n\nThis example shows how you update a store'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:\n\n\n\n\n\nNote that the response includes the full store details.\n\n\n\n\n\nSee also\n\n\n                    Order terminals using API requests\n                \n                    Assign terminals using API requests\n                \n                    Configure terminals using API requests\n                \n","type":"page","locale":"pt","boost":16,"hierarchy":{"lvl0":"Home","lvl1":"Terminais","lvl2":"Design your integration","lvl3":"Determinar a estrutura de sua conta de terminais","lvl4":"Automate store management"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/point-of-sale","lvl2":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/design-your-integration","lvl3":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/design-your-integration\/determine-account-structure","lvl4":"\/pt\/point-of-sale\/design-your-integration\/determine-account-structure\/automate-store-management"},"levels":5,"category":"In-person payments","category_color":"green","tags":["Automate","store","management"]},"articleFiles":{"add-payment-method-9323982969.js":"<p alt=\"\">add-payment-method-9323982969.js<\/p>","get-payment-methods-for-a-store-6416537766.js":"<p alt=\"\">get-payment-methods-for-a-store-6416537766.js<\/p>","update-payment-method-settings-5309933059.js":"<p alt=\"\">update-payment-method-settings-5309933059.js<\/p>"}}