# 가맹점 관리 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://portone.gitbook.io/docs/api-v2/store.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.