---
title: "aid_account_management_stores_post"
method: POST
path: "/accounts/{aid}/stores"
tags: ["account-stores"]
---

# aid_account_management_stores_post

`POST /accounts/{aid}/stores`

Create a store

scopes:
- admin:accounts
- write:accounts

## Path parameters

- `aid` string, ^[PT]{1}\d{8}$, required

## Request body

- StoreCreateInput
  - `organization` object, required — The organization for the store
    - `organization_number` string, required
    - `country` string — ISO 3166-1 country code for the organization number
    - `type` 'main_unit' | 'sub_unit'
    - `name` string
    - `trade_name` string
  - `store_name` string, required
  - `email` string, email
  - `phone_number` string, E.164, required — A phone number in E.164 format
  - `address` object
    - `address_line` string, required
    - `address_line_2` string
    - `postal_code` string, required
    - `postal_place` string, required
    - `country` string, iso-3166-1, required — ISO 3166-1 country code
  - `coordinates` object — The coordinates of the store
    - `latitude` number, float, required
    - `longitude` number, float, required
  - `website` string
  - `payout_destination` object — The payout destination associated with this store. A store with a payout destination will get all its properties (address, phone_number +++) set by validated data so you will not be allowed to set custom address when payout destination is set The organization_number must match the organization number of the payout destination These exceptions do not apply to payout destination's sub-units where different sub-unit organization_number is allowed and the details will be set by what is available in the public registers.
    - `payout_destination_id` string, required
  - `store_id` string — Client-supplied store identifier. If omitted, the server generates one (e.g. T12345678-0001) and uses it as the store_id.
  - `configuration` object — Optional store configuration. Unset values default per property; see `StoreConfiguration` for defaults.
    - `auto_end_of_day` object — Automatic end-of-day settlement for this store's terminals. Set `enabled` to false to disable the automatic timed end-of-day and trigger it manually via the terminal operations API instead.
      - `enabled` boolean
      - `time` string — Automatic end-of-day time in HHMM format.
      - `timezone` string — Automatic end-of-day time zone TZ name.

## Response `200`

Store

- Store
  - `id` string, required
  - `name` string — name of the store, aka trade name of the store
  - `business_name` string — Official name of the person or entity that owns the store.
  - `address` Address
    - `address_line` string, required
    - `address_line_2` string
    - `postal_code` string
    - `postal_place` string, required
    - `country` string, iso-3166-1, required — ISO 3166-1 country code
  - `chain` string
  - `email` string
  - `gln` string
  - `organization_number` string
  - `phone_number` string
  - `mcc` string, iso-18245 — A four-digit Merchant Category Code (MCC) for the store [ISO 18245:2003](https://www.iso.org/standard/33365.html)
  - `bax` string — Merchant number associated with the stores payment terminal
  - `terminal_id` string — Id to a specific point-of-sale (POS) terminal or workstation
  - `payout_destination_id` string — The payout destination id for the merchant of record, i.e. the seller responsible for the transaction. Required when `seitatech.in_person` payment is enabled.

## Other responses

- `400` — Bad / Invalid request
- `401` — Access forbidden, invalid JWT token was used
- `403` — Forbidden
- `500` — Unexpected Error

---

[API](https://skmtc.net/dintero/apis/account-management-api.md) · [All operations](https://skmtc.net/dintero/apis/account-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dintero/account-management-api/revisions/9b83a4199008/schema)