# 관리자 및 하위 상점 계정 관리

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

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

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

## 포트원 관리자콘솔 계정 체계

* 가맹점 관리자 계정 (Admin): 최초 관리자 콘솔 가입시 회원가입한 계정을 가맹점을 대표하는 관리자 계정으로 칭합니다. 해당 계정은 모든 기능을 사용하실 수 있습니다.
* 가맹점 매니저 계정 (Manager) : 가맹점 관리자 계정이 해당계정을 생성 및 발급하실 수 있습니다. 해당 계정은 상점 및 계정관리 와 연동은 조회만 가능하며 나머지 관리자 콘솔 기능들은 사용하실 수 있습니다.
* 가맹점 개발 계정 (Dev): 가맹점 관리자 계정이 해당계정을 생성 및 발급하실 수 있습니다. 해당계정은 연동 기능은 사용 가능하며 상점 계정 관리는 조회만 가능합니다. 나머지 기능들은 사용하실 수 없습니다.
* 가맹점 조회 계정 (Read Only) : 가맹점 관리자 계정이 해당계정을 생성 및 발급하실 수 있습니다. 해당 계정은 모든 기능의 조회만 가능합니다.
* 하위 상점 매니저 계정(Manager) : 가맹점 관리자 계정이나 동일한 하위상점의 매니저 계정이 해당계정을 생성 및 발급하실 수 있습니다. 해당 계정은 소속된 하위 상점의 모든 기능을 사용하실 수 있으며 가맹점 관리자 계정 관리 및 가맹점의 사업자 정보를 조회할 수 있습니다.
* 하위 상점 조회 계정(Read Only) : 가맹점 관리자 계정이나 동일한 하위상점의 매니저 계정이 해당계정을 생성 및 발급하실 수 있습니다. 해당 계정은 소속된 하위 상점의 모든 기능을 조회 만 하실 수 있습니다.

## 관리자 계정 관리

*파란색 부분은 사용가능한 버튼 표기입니다*

![관리자 계정 시점](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FbFokcFWNrETabFuhvcHv%2Fimage.png?alt=media\&token=9b159cee-049d-4933-ab5c-bc99352b7d3e)

![그 외 계정 시점](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FIgR00tF72EesCk391w5u%2Fimage.png?alt=media\&token=8209aebe-37b0-478c-bf70-55f14d3254b4)

* 관리자 계정은 해당 화면에서 가맹점에 소속된 계정들을 신규 생성, 발급, 역할 및 정보 수정, 삭제 하실 수 있습니다.
* 나머지 계정은 해당 화면을 통해 가맹점에 소속된 계정들을 조회하실 수 있습니다.

![](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FXpr0Kr6PXQ4WyR8V0GLB%2Fimage.png?alt=media\&token=97fde87f-8ad4-468f-ac25-f5165c083a27) ![](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2F3KgoFlfWiFL7fimJ5LG2%2Fimage.png?alt=media\&token=503d1036-bb2e-45c9-94b9-ec28915cde47)

## 가맹점, 하위 상점 체계

* 가맹점: 포트원에서 가맹점이란 고유한 사업자등록번호를 가지고있는 사업체로 정의합니다. 유일한 예외는 타 가맹점들을 위해 결제를 개발해주시는 에이전시 뿐 입니다.
* 하위상점: 가맹점은 서비스 및 상품군 별, 지역별, 등등 사업을 나누어 관리자 콘솔로 관리하고 결제를 연동할 수 있습니다. 해당사항으로 나뉘는 단위를 하위상점으로 정의합니다.
  * 결제 연동: 가맹점이 신청한 결제수단 및 대행사를 특정 하위상점에 관리자 콘솔에서 할당할 수 있습니다.
  * 하위상점 계정: 하위상점에 소속된 계정은 하위상점관련된 기능 및 결제건만 확인 하실 수 있습니다.

## 하위 상점 관리

### 가맹점 관리자 계정 시점

![가맹점 관리자 계정 계정 시점](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2F8MacQZlHZ7bPfuLpsg6Y%2Fimage.png?alt=media\&token=dc3b29f3-1f17-45a2-b713-a9d0557eff5f)

* 가맹점 관리자 계정은 하위상점을 추가, 수정 할 수 있으며 해당 하위상점의 소속된 계정을 생성, 수정, 삭제 하실 수 있으십니다.

#### 하위상점 추가 및 수정

![](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2F7FxXuOVPwwY5sSpSvjDi%2Fimage.png?alt=media\&token=7dd154f1-384d-4fdc-97f5-48c081c772c2) ![](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FxhiCL2R64vOCZSNB0vio%2Fimage.png?alt=media\&token=4c565c69-2afa-463b-94df-7f4ade639a7a)

* 상점 명 입력, 사용할 결제채널 선택, 서비스 url 입력, 담당자 정보 입력, 티어코드 입력 후 하위상점을 추가하실 수 있습니다
  * 사용할 결제 채널은 전자결제 신청하기를 통해서 발급되고 연동에서 관리중인 가맹점의 결제채널을 할당 해 줄 수 있습니다.
  * 타 하위상점에게 이미 할당된 결제 채널은 중복 할당할 수 없습니다.
  * 티어코드는 하위상점 url에서 포트원 결제 sdk 호출시 import.agency(‘티어코드’)로 결제를 호출 하실 수 있습니다.

#### 하위계정 추가

![](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FaeDOqqipAsW77nks7XDZ%2Fimage.png?alt=media\&token=6c194631-8aa8-4922-a037-31c5dcd682fa) ![](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FuXZ7LbyyQfrVRdQBMBLO%2Fimage.png?alt=media\&token=8a65a739-120b-469e-bfa6-40d2a000fbc7)

* 계정 아이디, 역할 (Manager, Read Only), 메모를 입력하신 뒤 하위계정을 생성 하실 수 있습니다.

### 그 외 계정 시점

![관리자 계정 외 가맹점 계정 시점](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FSJsz9F2ARByQIM4BB2Jr%2Fimage.png?alt=media\&token=2bc5b3f8-258f-4aec-988b-77f9e2c6d8e4)

![하위 상점 매니저 계정 시점](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2Ftfnx6YTuBU2kB36LrVTO%2Fimage.png?alt=media\&token=763fb9f1-4901-465b-a901-14b5bc4ec9ab)

![매니저 계정 외 하위 상점 계정 시점](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FiWFvphF0a69xa90pe0rZ%2Fimage.png?alt=media\&token=b9162483-19a1-4934-bbe5-921f14526cf1)

## 하위상점별 웹훅 설정 <a href="#agency-webhook" id="agency-webhook"></a>

하위상점 수정에서 결제알림 동일 설정 옵션을 해제하면 하위상점별 웹훅 설정을 할 수 있습니다.

1. 상점/계정 관리에서 하위상점 관리 > 별도로 웹훅을 설정할 하위상점 선택
2. 하위상점 수정에서 `결제알림은 대표 가맹점과 동일하게 설정할게요` 체크박스 해제
3. 결제 연동에서 별도로 웹훅을 설정할 하위상점으로 변경
4. 결제알림(Webhook) 관리 탭에서 설정

<figure><img src="https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FNGvY5RDbdpmbROd7oSpN%2Fimage.png?alt=media&#x26;token=ea4fe649-fb9e-4952-9656-b89a94828720" alt=""><figcaption><p>하단의 결제알림 동일설정 체크박스를 해제해주세요</p></figcaption></figure>

<figure><img src="https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2Fgit-blob-7aaa672b0d4077d323e83d24574f698b08685cc9%2Fimage%20(2)%20(2)%20(1)%20(1)%20(1).png?alt=media" alt=""><figcaption><p>웹훅 연동을 원하시는 하위상점을 선택한 뒤 결제알림 관리 탭에서 웹훅을 수정해주세요</p></figcaption></figure>