# 가맹점 관리 API - 별도 계약 필요

{% hint style="warning" %}
**Deprecated**

이 문서는 더 이상 관리되지 않습니다.

[PortOne 개발자센터](https://developers.portone.io/)를 이용해주세요.
{% endhint %}

## ⌨ 하위상점 다건 조회

## 하위상점 다건 조회

<mark style="color:blue;">`GET`</mark> `https://api.portone.io/v2/stores`

하위상점 다건 조회

#### Headers

| Name                                            | Type   | Description |
| ----------------------------------------------- | ------ | ----------- |
| Authorization<mark style="color:red;">\*</mark> | string | jwt 토큰 헤더   |

{% tabs %}
{% tab title="200 조회 성공" %}
{% tabs %}
{% tab title="Response" %}
**`stores`** <mark style="color:red;">**\***</mark> <mark style="color:red;">**Array\[PublicStoreResponse]**</mark>

store 목록

<details>

<summary>PublicStoreResponse</summary>

**`id`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

상점 아이디

***

**`name`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

상점 이름

***

**`tier_code`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

상점 식별 코드 ex) ABC 영문, 숫자 3자리

***

**`service_urls`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**Array\[string]**</mark>

서비스 url 리스트

***

**`manager_name`** <mark style="color:green;">**string**</mark>

담당자명

***

**`manager_phone_number`** <mark style="color:green;">**string**</mark>

담당자 휴대폰번호

***

**`manager_email`** <mark style="color:green;">**string**</mark>

담당자 이메일

***

**`representative`** <mark style="color:red;">**\***</mark> <mark style="color:red;">**PublicStoreRepresentativeResponse**</mark>

상점 대표자 정보

***

**`business_license`** <mark style="color:red;">**\***</mark> <mark style="color:red;">**PublicStoreBusinessLicense**</mark>

사업자 정보

***

</details>

***

{% endtab %}

{% tab title="PublicStoreBusinessLicense" %}
**`taxation_type`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**TaxationType**</mark>

사업자 구분

`"PERSON"`, `"CORPORATE"`

***

**`company_name`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

회사명

***

**`registration_number`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

사업자번호

***

**`business_location`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

회사 주소

***

**`business_location_detail`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

회사 상세 주소

***

**`postal_code`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

우편번호

***

**`business_types`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**Array\[string]**</mark>

업태

***

**`business_items`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**Array\[string]**</mark>

종목

***

**`corporate_registration_number`** <mark style="color:green;">**string**</mark>

법인등록번호 - 법인 only

***

**`headquarter_location`** <mark style="color:green;">**string**</mark>

본사 주소 - 법인 only

***

**`business_establishment_date`** <mark style="color:green;">**string**</mark>

개업 연월일

***

**`issuance_date`** <mark style="color:green;">**string**</mark>

사업자등록증 발급일

***

**`issuance_reason`** <mark style="color:green;">**string**</mark>

발급 사유

***

{% endtab %}

{% tab title="PublicStoreRepresentativeResponse" %}
**`name_ko`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

대표자 이름

***

**`name_en`** <mark style="color:green;">**string**</mark>

대표자 영문 이름

***

**`email`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

대표자 이메일

***

**`phone_number`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

대표자 전화번호

***

**`birth_date`** <mark style="color:green;">**string**</mark>

대표자 생년월일 format: yyyy-MM-dd ex) 2000-01-01

***

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="400 요청 에러" %}
{% tabs %}
{% tab title="Response" %}
**`code`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

에러 코드

***

**`params`** <mark style="color:red;">**\***</mark> <mark style="color:red;">**object**</mark>

에러 세부사항

<details>

<summary>params</summary>

**`message`** <mark style="color:green;">**string**</mark>

에러 메시지

***

</details>

***

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="401 토큰 인증 실패" %}
{% tabs %}
{% tab title="Response" %}
**`code`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

에러 코드

***

**`params`** <mark style="color:red;">**\***</mark> <mark style="color:red;">**object**</mark>

에러 세부사항

<details>

<summary>params</summary>

**`message`** <mark style="color:green;">**string**</mark>

에러 메시지

***

</details>

***

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="403 권한 에러" %}
{% tabs %}
{% tab title="Response" %}
**`code`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

에러 코드

***

**`params`** <mark style="color:red;">**\***</mark> <mark style="color:red;">**object**</mark>

에러 세부사항

<details>

<summary>params</summary>

**`message`** <mark style="color:green;">**string**</mark>

에러 메시지

***

</details>

***

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="500 서버 에러" %}
{% tabs %}
{% tab title="Response" %}
**`code`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

에러 코드

***

**`params`** <mark style="color:red;">**\***</mark> <mark style="color:red;">**object**</mark>

에러 세부사항

<details>

<summary>params</summary>

**`message`** <mark style="color:green;">**string**</mark>

에러 메시지

***

</details>

***

{% endtab %}
{% endtabs %}
{% endtab %}
{% endtabs %}

## ⌨ 하위상점 생성

## 하위상점 생성

<mark style="color:green;">`POST`</mark> `https://api.portone.io/v2/stores`

하위상점 생성

#### Headers

| Name                                            | Type   | Description |
| ----------------------------------------------- | ------ | ----------- |
| Authorization<mark style="color:red;">\*</mark> | string | jwt 토큰 헤더   |

#### Request Body

| Name                                                     | Type                             | Description                                                                                                |
| -------------------------------------------------------- | -------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| name<mark style="color:red;">\*</mark>                   | string                           | 상점 이름                                                                                                      |
| tier\_code<mark style="color:red;">\*</mark>             | string                           | 상점 식별 코드 ex) ABC 영문, 숫자 3자리                                                                                |
| service\_urls<mark style="color:red;">\*</mark>          | Array\[string]                   | 서비스 url 리스트                                                                                                |
| manager\_name<mark style="color:red;">\*</mark>          | string                           | 담당자명                                                                                                       |
| manager\_phone\_number<mark style="color:red;">\*</mark> | string                           | 담당자 휴대폰번호                                                                                                  |
| manager\_email<mark style="color:red;">\*</mark>         | string                           | 담당자 이메일                                                                                                    |
| representative<mark style="color:red;">\*</mark>         | PublicStoreRepresentativeRequest | 상점 대표자 정보                                                                                                  |
| business\_license<mark style="color:red;">\*</mark>      | PublicStoreBusinessLicense       | 사업자 정보                                                                                                     |
| terms\_agreed<mark style="color:red;">\*</mark>          | Array\[boolean]                  | 약관 동의 여부, 두 가지 필수 약관 모두 동의 필요 첫번째 약관: 개인정보 수집 동의 두번째 약관: 상위 가맹점에게 상점 정보 제공 동의 ex) 두 약관 모두 동의 \[true, true] |

{% tabs %}
{% tab title="200 등록 성공" %}
{% tabs %}
{% tab title="Response" %}
**`id`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

상점 아이디

***

**`name`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

상점 이름

***

**`tier_code`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

상점 식별 코드 ex) ABC 영문, 숫자 3자리

***

**`service_urls`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**Array\[string]**</mark>

서비스 url 리스트

***

**`manager_name`** <mark style="color:green;">**string**</mark>

담당자명

***

**`manager_phone_number`** <mark style="color:green;">**string**</mark>

담당자 휴대폰번호

***

**`manager_email`** <mark style="color:green;">**string**</mark>

담당자 이메일

***

**`representative`** <mark style="color:red;">**\***</mark> <mark style="color:red;">**PublicStoreRepresentativeResponse**</mark>

상점 대표자 정보

<details>

<summary>PublicStoreRepresentativeResponse</summary>

**`name_ko`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

대표자 이름

***

**`name_en`** <mark style="color:green;">**string**</mark>

대표자 영문 이름

***

**`email`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

대표자 이메일

***

**`phone_number`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

대표자 전화번호

***

**`birth_date`** <mark style="color:green;">**string**</mark>

대표자 생년월일 format: yyyy-MM-dd ex) 2000-01-01

***

</details>

***

**`business_license`** <mark style="color:red;">**\***</mark> <mark style="color:red;">**PublicStoreBusinessLicense**</mark>

사업자 정보

<details>

<summary>PublicStoreBusinessLicense</summary>

**`taxation_type`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**TaxationType**</mark>

사업자 구분

`"PERSON"`, `"CORPORATE"`

***

**`company_name`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

회사명

***

**`registration_number`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

사업자번호

***

**`business_location`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

회사 주소

***

**`business_location_detail`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

회사 상세 주소

***

**`postal_code`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

우편번호

***

**`business_types`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**Array\[string]**</mark>

업태

***

**`business_items`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**Array\[string]**</mark>

종목

***

**`corporate_registration_number`** <mark style="color:green;">**string**</mark>

법인등록번호 - 법인 only

***

**`headquarter_location`** <mark style="color:green;">**string**</mark>

본사 주소 - 법인 only

***

**`business_establishment_date`** <mark style="color:green;">**string**</mark>

개업 연월일

***

**`issuance_date`** <mark style="color:green;">**string**</mark>

사업자등록증 발급일

***

**`issuance_reason`** <mark style="color:green;">**string**</mark>

발급 사유

***

</details>

***

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="400 요청 에러" %}
{% tabs %}
{% tab title="Response" %}
**`code`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

에러 코드

***

**`params`** <mark style="color:red;">**\***</mark> <mark style="color:red;">**object**</mark>

에러 세부사항

<details>

<summary>params</summary>

**`message`** <mark style="color:green;">**string**</mark>

에러 메시지

***

</details>

***

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="401 토큰 인증 실패" %}
{% tabs %}
{% tab title="Response" %}
**`code`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

에러 코드

***

**`params`** <mark style="color:red;">**\***</mark> <mark style="color:red;">**object**</mark>

에러 세부사항

<details>

<summary>params</summary>

**`message`** <mark style="color:green;">**string**</mark>

에러 메시지

***

</details>

***

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="403 권한 에러" %}
{% tabs %}
{% tab title="Response" %}
**`code`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

에러 코드

***

**`params`** <mark style="color:red;">**\***</mark> <mark style="color:red;">**object**</mark>

에러 세부사항

<details>

<summary>params</summary>

**`message`** <mark style="color:green;">**string**</mark>

에러 메시지

***

</details>

***

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="404 존재하지 않는 리소스 에러" %}
{% tabs %}
{% tab title="Response" %}
**`code`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

에러 코드

***

**`params`** <mark style="color:red;">**\***</mark> <mark style="color:red;">**object**</mark>

에러 세부사항

<details>

<summary>params</summary>

**`message`** <mark style="color:green;">**string**</mark>

에러 메시지

***

</details>

***

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="500 서버 에러" %}
{% tabs %}
{% tab title="Response" %}
**`code`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

에러 코드

***

**`params`** <mark style="color:red;">**\***</mark> <mark style="color:red;">**object**</mark>

에러 세부사항

<details>

<summary>params</summary>

**`message`** <mark style="color:green;">**string**</mark>

에러 메시지

***

</details>

***

{% endtab %}
{% endtabs %}
{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="PublicStoreBusinessLicense" %}
**`taxation_type`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**TaxationType**</mark>

사업자 구분

`"PERSON"`, `"CORPORATE"`

***

**`company_name`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

회사명

***

**`registration_number`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

사업자번호

***

**`business_location`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

회사 주소

***

**`business_location_detail`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

회사 상세 주소

***

**`postal_code`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

우편번호

***

**`business_types`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**Array\[string]**</mark>

업태

***

**`business_items`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**Array\[string]**</mark>

종목

***

**`corporate_registration_number`** <mark style="color:green;">**string**</mark>

법인등록번호 - 법인 only

***

**`headquarter_location`** <mark style="color:green;">**string**</mark>

본사 주소 - 법인 only

***

**`business_establishment_date`** <mark style="color:green;">**string**</mark>

개업 연월일

***

**`issuance_date`** <mark style="color:green;">**string**</mark>

사업자등록증 발급일

***

**`issuance_reason`** <mark style="color:green;">**string**</mark>

발급 사유

***

{% endtab %}

{% tab title="PublicStoreRepresentativeRequest" %}
**`name_ko`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

대표자 이름

***

**`name_en`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

대표자 영문 이름

***

**`email`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

대표자 이메일

***

**`phone_number`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

대표자 전화번호

***

**`birth_date`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

대표자 생년월일 format: yyyy-MM-dd ex) 2000-01-01

***

{% endtab %}

{% tab title="TaxationType" %}
사업자 구분

`"PERSON"`, `"CORPORATE"`
{% endtab %}
{% endtabs %}

## ⌨ 하위상점 단건 조회

## 하위상점 단건 조회

<mark style="color:blue;">`GET`</mark> `https://api.portone.io/v2/stores/{store-id}`

하위상점 단건 조회

#### Path Parameters

| Name                                       | Type   | Description |
| ------------------------------------------ | ------ | ----------- |
| store-id<mark style="color:red;">\*</mark> | string | store의 id   |

#### Headers

| Name                                            | Type   | Description |
| ----------------------------------------------- | ------ | ----------- |
| Authorization<mark style="color:red;">\*</mark> | string | jwt 토큰 헤더   |

{% tabs %}
{% tab title="200 조회 성공" %}
{% tabs %}
{% tab title="Response" %}
**`id`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

상점 아이디

***

**`name`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

상점 이름

***

**`tier_code`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

상점 식별 코드 ex) ABC 영문, 숫자 3자리

***

**`service_urls`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**Array\[string]**</mark>

서비스 url 리스트

***

**`manager_name`** <mark style="color:green;">**string**</mark>

담당자명

***

**`manager_phone_number`** <mark style="color:green;">**string**</mark>

담당자 휴대폰번호

***

**`manager_email`** <mark style="color:green;">**string**</mark>

담당자 이메일

***

**`representative`** <mark style="color:red;">**\***</mark> <mark style="color:red;">**PublicStoreRepresentativeResponse**</mark>

상점 대표자 정보

<details>

<summary>PublicStoreRepresentativeResponse</summary>

**`name_ko`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

대표자 이름

***

**`name_en`** <mark style="color:green;">**string**</mark>

대표자 영문 이름

***

**`email`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

대표자 이메일

***

**`phone_number`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

대표자 전화번호

***

**`birth_date`** <mark style="color:green;">**string**</mark>

대표자 생년월일 format: yyyy-MM-dd ex) 2000-01-01

***

</details>

***

**`business_license`** <mark style="color:red;">**\***</mark> <mark style="color:red;">**PublicStoreBusinessLicense**</mark>

사업자 정보

<details>

<summary>PublicStoreBusinessLicense</summary>

**`taxation_type`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**TaxationType**</mark>

사업자 구분

`"PERSON"`, `"CORPORATE"`

***

**`company_name`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

회사명

***

**`registration_number`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

사업자번호

***

**`business_location`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

회사 주소

***

**`business_location_detail`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

회사 상세 주소

***

**`postal_code`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

우편번호

***

**`business_types`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**Array\[string]**</mark>

업태

***

**`business_items`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**Array\[string]**</mark>

종목

***

**`corporate_registration_number`** <mark style="color:green;">**string**</mark>

법인등록번호 - 법인 only

***

**`headquarter_location`** <mark style="color:green;">**string**</mark>

본사 주소 - 법인 only

***

**`business_establishment_date`** <mark style="color:green;">**string**</mark>

개업 연월일

***

**`issuance_date`** <mark style="color:green;">**string**</mark>

사업자등록증 발급일

***

**`issuance_reason`** <mark style="color:green;">**string**</mark>

발급 사유

***

</details>

***

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="400 요청 에러" %}
{% tabs %}
{% tab title="Response" %}
**`code`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

에러 코드

***

**`params`** <mark style="color:red;">**\***</mark> <mark style="color:red;">**object**</mark>

에러 세부사항

<details>

<summary>params</summary>

**`message`** <mark style="color:green;">**string**</mark>

에러 메시지

***

</details>

***

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="401 토큰 인증 실패" %}
{% tabs %}
{% tab title="Response" %}
**`code`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

에러 코드

***

**`params`** <mark style="color:red;">**\***</mark> <mark style="color:red;">**object**</mark>

에러 세부사항

<details>

<summary>params</summary>

**`message`** <mark style="color:green;">**string**</mark>

에러 메시지

***

</details>

***

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="403 권한 에러" %}
{% tabs %}
{% tab title="Response" %}
**`code`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

에러 코드

***

**`params`** <mark style="color:red;">**\***</mark> <mark style="color:red;">**object**</mark>

에러 세부사항

<details>

<summary>params</summary>

**`message`** <mark style="color:green;">**string**</mark>

에러 메시지

***

</details>

***

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="404 존재하지 않는 리소스 에러" %}
{% tabs %}
{% tab title="Response" %}
**`code`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

에러 코드

***

**`params`** <mark style="color:red;">**\***</mark> <mark style="color:red;">**object**</mark>

에러 세부사항

<details>

<summary>params</summary>

**`message`** <mark style="color:green;">**string**</mark>

에러 메시지

***

</details>

***

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="500 서버 에러" %}
{% tabs %}
{% tab title="Response" %}
**`code`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

에러 코드

***

**`params`** <mark style="color:red;">**\***</mark> <mark style="color:red;">**object**</mark>

에러 세부사항

<details>

<summary>params</summary>

**`message`** <mark style="color:green;">**string**</mark>

에러 메시지

***

</details>

***

{% endtab %}
{% endtabs %}
{% endtab %}
{% endtabs %}

## ⌨ 하위상점 수정

## 하위상점 수정

<mark style="color:orange;">`PUT`</mark> `https://api.portone.io/v2/stores/{store-id}`

하위상점 수정

#### Path Parameters

| Name                                       | Type   | Description |
| ------------------------------------------ | ------ | ----------- |
| store-id<mark style="color:red;">\*</mark> | string | store의 id   |

#### Headers

| Name                                            | Type   | Description |
| ----------------------------------------------- | ------ | ----------- |
| Authorization<mark style="color:red;">\*</mark> | string | jwt 토큰 헤더   |

#### Request Body

| Name                                                     | Type                                    | Description |
| -------------------------------------------------------- | --------------------------------------- | ----------- |
| name<mark style="color:red;">\*</mark>                   | string                                  | 상점 이름       |
| service\_urls<mark style="color:red;">\*</mark>          | Array\[string]                          | 서비스 url 리스트 |
| manager\_name<mark style="color:red;">\*</mark>          | string                                  | 담당자명        |
| manager\_phone\_number<mark style="color:red;">\*</mark> | string                                  | 담당자 휴대폰번호   |
| manager\_email<mark style="color:red;">\*</mark>         | string                                  | 담당자 이메일     |
| representative<mark style="color:red;">\*</mark>         | PublicStoreRepresentativeRequest        | 상점 대표자 정보   |
| business\_license<mark style="color:red;">\*</mark>      | UpdatePublicStoreBusinessLicenseRequest | 사업자 정보      |

{% tabs %}
{% tab title="200 등록 성공" %}
{% tabs %}
{% tab title="Response" %}
**`id`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

상점 아이디

***

**`name`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

상점 이름

***

**`tier_code`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

상점 식별 코드 ex) ABC 영문, 숫자 3자리

***

**`service_urls`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**Array\[string]**</mark>

서비스 url 리스트

***

**`manager_name`** <mark style="color:green;">**string**</mark>

담당자명

***

**`manager_phone_number`** <mark style="color:green;">**string**</mark>

담당자 휴대폰번호

***

**`manager_email`** <mark style="color:green;">**string**</mark>

담당자 이메일

***

**`representative`** <mark style="color:red;">**\***</mark> <mark style="color:red;">**PublicStoreRepresentativeResponse**</mark>

상점 대표자 정보

<details>

<summary>PublicStoreRepresentativeResponse</summary>

**`name_ko`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

대표자 이름

***

**`name_en`** <mark style="color:green;">**string**</mark>

대표자 영문 이름

***

**`email`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

대표자 이메일

***

**`phone_number`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

대표자 전화번호

***

**`birth_date`** <mark style="color:green;">**string**</mark>

대표자 생년월일 format: yyyy-MM-dd ex) 2000-01-01

***

</details>

***

**`business_license`** <mark style="color:red;">**\***</mark> <mark style="color:red;">**PublicStoreBusinessLicense**</mark>

사업자 정보

<details>

<summary>PublicStoreBusinessLicense</summary>

**`taxation_type`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**TaxationType**</mark>

사업자 구분

`"PERSON"`, `"CORPORATE"`

***

**`company_name`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

회사명

***

**`registration_number`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

사업자번호

***

**`business_location`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

회사 주소

***

**`business_location_detail`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

회사 상세 주소

***

**`postal_code`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

우편번호

***

**`business_types`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**Array\[string]**</mark>

업태

***

**`business_items`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**Array\[string]**</mark>

종목

***

**`corporate_registration_number`** <mark style="color:green;">**string**</mark>

법인등록번호 - 법인 only

***

**`headquarter_location`** <mark style="color:green;">**string**</mark>

본사 주소 - 법인 only

***

**`business_establishment_date`** <mark style="color:green;">**string**</mark>

개업 연월일

***

**`issuance_date`** <mark style="color:green;">**string**</mark>

사업자등록증 발급일

***

**`issuance_reason`** <mark style="color:green;">**string**</mark>

발급 사유

***

</details>

***

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="400 요청 에러" %}
{% tabs %}
{% tab title="Response" %}
**`code`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

에러 코드

***

**`params`** <mark style="color:red;">**\***</mark> <mark style="color:red;">**object**</mark>

에러 세부사항

<details>

<summary>params</summary>

**`message`** <mark style="color:green;">**string**</mark>

에러 메시지

***

</details>

***

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="401 토큰 인증 실패" %}
{% tabs %}
{% tab title="Response" %}
**`code`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

에러 코드

***

**`params`** <mark style="color:red;">**\***</mark> <mark style="color:red;">**object**</mark>

에러 세부사항

<details>

<summary>params</summary>

**`message`** <mark style="color:green;">**string**</mark>

에러 메시지

***

</details>

***

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="403 권한 에러" %}
{% tabs %}
{% tab title="Response" %}
**`code`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

에러 코드

***

**`params`** <mark style="color:red;">**\***</mark> <mark style="color:red;">**object**</mark>

에러 세부사항

<details>

<summary>params</summary>

**`message`** <mark style="color:green;">**string**</mark>

에러 메시지

***

</details>

***

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="404 존재하지 않는 리소스 에러" %}
{% tabs %}
{% tab title="Response" %}
**`code`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

에러 코드

***

**`params`** <mark style="color:red;">**\***</mark> <mark style="color:red;">**object**</mark>

에러 세부사항

<details>

<summary>params</summary>

**`message`** <mark style="color:green;">**string**</mark>

에러 메시지

***

</details>

***

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="500 서버 에러" %}
{% tabs %}
{% tab title="Response" %}
**`code`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

에러 코드

***

**`params`** <mark style="color:red;">**\***</mark> <mark style="color:red;">**object**</mark>

에러 세부사항

<details>

<summary>params</summary>

**`message`** <mark style="color:green;">**string**</mark>

에러 메시지

***

</details>

***

{% endtab %}
{% endtabs %}
{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="PublicStoreRepresentativeRequest" %}
**`name_ko`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

대표자 이름

***

**`name_en`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

대표자 영문 이름

***

**`email`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

대표자 이메일

***

**`phone_number`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

대표자 전화번호

***

**`birth_date`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

대표자 생년월일 format: yyyy-MM-dd ex) 2000-01-01

***

{% endtab %}

{% tab title="UpdatePublicStoreBusinessLicenseRequest" %}
**`company_name`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

회사명

***

**`registration_number`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

사업자번호

***

**`business_location`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

회사 주소

***

**`business_location_detail`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

회사 상세 주소

***

**`postal_code`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

우편번호

***

**`business_types`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**Array\[string]**</mark>

업태

***

**`business_items`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**Array\[string]**</mark>

종목

***

**`corporate_registration_number`** <mark style="color:green;">**string**</mark>

법인등록번호 - 법인 only

***

**`headquarter_location`** <mark style="color:green;">**string**</mark>

본사 주소 - 법인 only

***

**`business_establishment_date`** <mark style="color:green;">**string**</mark>

개업 연월일

***

**`issuance_date`** <mark style="color:green;">**string**</mark>

사업자등록증 발급일

***

**`issuance_reason`** <mark style="color:green;">**string**</mark>

발급 사유

***

{% endtab %}
{% endtabs %}