---
title: "Create a store"
method: POST
path: "/merchants/{merchantId}/stores"
tags: ["Account - store level"]
---

# Create a store

`POST /merchants/{merchantId}/stores`

Creates a store for the merchant account identified in the path.

To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions):
* Management API—Stores read and write

In the live environment, requests to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment).

## Path parameters

- `merchantId` string, required

## Request body

- StoreCreationRequest
  - `address` StoreLocation, required
    - `city` string — The name of the city.
    - `country` string, required — The two-letter country code in [ISO_3166-1_alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format.
    - `line1` string — The street address.
    - `line2` string — Second address line.
    - `line3` string — Third address line.
    - `postalCode` string — The postal code.
    - `stateOrProvince` string — The state or province code as defined in [ISO 3166-2](https://www.iso.org/standard/72483.html). For example, **ON** for Ontario, Canada. Required for the following countries: - Australia - Brazil - Canada - India - Mexico - New Zealand - United States
  - `businessLineIds` string[] — The unique identifiers of the [business lines](https://docs.adyen.com/api-explorer/legalentity/latest/post/businessLines#responses-200-id) that the store is associated with. If not specified, the business line of the merchant account is used. Required when there are multiple business lines under the merchant account.
  - `description` string, required — Your description of the store.
  - `externalReferenceId` string
  - `localizedInformation` LocalizedInformation
    - `localShopperStatement` LocalShopperStatement[], required — An array of local shopper statements. Card schemes use this in the bank statement. For Japan local shopper statements in both ja-Hani and ja-Kana are required.
      - `script` string, required — The character set of the local shopper statement. Possible values: **ja-Hani**, **ja-Kana**.
      - `value` string, required — The text of the local shopper statement in the specified character set.
  - `phoneNumber` string, required — The phone number of the store, including '+' and country code.
  - `reference` string — Your reference to recognize the store by. Also known as the store code. 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](https://docs.adyen.com/api-explorer/Management/latest/post/stores#responses-200-id).
  - `shopperStatement` string, required — The store name to be shown on the shopper's bank or credit card statement and on the shopper receipt. Maximum length: 22 characters; can't be all numbers.
  - `splitConfiguration` StoreSplitConfiguration
    - `balanceAccountId` string — The [unique identifier of the balance account](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/get/balanceAccounts/{id}__queryParam_id) to which the split amount must be booked, depending on the defined [split logic](https://docs.adyen.com/api-explorer/Management/latest/post/merchants/_merchantId_/splitConfigurations#request-rules-splitLogic).
    - `splitConfigurationId` string — The unique identifier of the [split configuration profile](https://docs.adyen.com/platforms/automatic-split-configuration/create-split-configuration/).

## Response `200`

OK - the request has succeeded.

- Store
  - `_links` Links
    - `self` LinksElement, required
      - `href` string
  - `address` StoreLocation
    - `city` string — The name of the city.
    - `country` string, required — The two-letter country code in [ISO_3166-1_alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format.
    - `line1` string — The street address.
    - `line2` string — Second address line.
    - `line3` string — Third address line.
    - `postalCode` string — The postal code.
    - `stateOrProvince` string — The state or province code as defined in [ISO 3166-2](https://www.iso.org/standard/72483.html). For example, **ON** for Ontario, Canada. Required for the following countries: - Australia - Brazil - Canada - India - Mexico - New Zealand - United States
  - `businessLineIds` string[] — The unique identifiers of the [business lines](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/businesslines__resParam_id) that the store is associated with. If not specified, the business line of the merchant account is used. Required when there are multiple business lines under the merchant account.
  - `description` string — The description of the store.
  - `externalReferenceId` string
  - `id` string — The unique identifier of the store. This value is generated by Adyen.
  - `localizedInformation` LocalizedInformation
    - `localShopperStatement` LocalShopperStatement[], required — An array of local shopper statements. Card schemes use this in the bank statement. For Japan local shopper statements in both ja-Hani and ja-Kana are required.
      - `script` string, required — The character set of the local shopper statement. Possible values: **ja-Hani**, **ja-Kana**.
      - `value` string, required — The text of the local shopper statement in the specified character set.
  - `merchantId` string — The unique identifier of the merchant account that the store belongs to.
  - `phoneNumber` string — The phone number of the store, including '+' and country code.
  - `reference` string — A reference to recognize the store by. Also known as the store code. Allowed characters: lowercase and uppercase letters without diacritics, numbers 0 through 9, hyphen (-), and underscore (_)
  - `shopperStatement` string — The store name shown on the shopper's bank or credit card statement and on the shopper receipt.
  - `splitConfiguration` StoreSplitConfiguration
    - `balanceAccountId` string — The [unique identifier of the balance account](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/get/balanceAccounts/{id}__queryParam_id) to which the split amount must be booked, depending on the defined [split logic](https://docs.adyen.com/api-explorer/Management/latest/post/merchants/_merchantId_/splitConfigurations#request-rules-splitLogic).
    - `splitConfigurationId` string — The unique identifier of the [split configuration profile](https://docs.adyen.com/platforms/automatic-split-configuration/create-split-configuration/).
  - `status` 'active' | 'closed' | 'inactive' — The status of the store. Possible values are: - **active**. This value is assigned automatically when a store is created. - **inactive**. The terminals under the store are blocked from accepting new transactions, but capturing outstanding transactions is still possible. - **closed**. This status is irreversible. The terminals under the store are reassigned to the merchant inventory.

## Other responses

- `204` — No Content - the request has been successfully processed, but there is no additional content.
- `400` — Bad Request - a problem reading or understanding the request.
- `401` — Unauthorized - authentication required.
- `403` — Forbidden - insufficient permissions to process the request.
- `422` — Unprocessable Entity - a request validation error.
- `500` — Internal Server Error - the server could not process the request.

---

[API](https://skmtc.net/adyen/apis/management-api.md) · [All operations](https://skmtc.net/adyen/apis/management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adyen/management-api/versions/1089ade06e17/schema)