# Agency & Tier 란?

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

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

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

### **하나의 계정으로 하위 가맹점 PG설정이 필요하신 경우(하위가맹점 관리) 아임**포트에서 제공하는 **Agent기능**을 이용하시면됩니다.

**마스터 계정으로 여러개의 하위가맹점코드(Tier 코드)를 적용하여 등록 하시면 하위 가맹점 별 상점정보 등록 및 결제내역 조회(취소)가 가능합니다.**

(하위가맹점에 대해 3자리 고유코드 부여와 명칭 지정 가능)

{% hint style="info" %}
이용을 원하시면 권한 적용할 포트원 이메일 계정을 아래 이메일 주소로 전달해 주시면 됩니다.

[**cs@portone.io**](mailto:cs@portone.io)
{% endhint %}

### 자세한 사용방법 안내

포트원 Agent 기능을 통하여 기존보다 더욱 편리하고 효율적으로 가맹점들을 관리할 수 있습니다.

* **Agent 관리자 페이지 체험하기 :** [**admin.portone.io**](http://admin.portone.io/)
* **테스트용 ID :** [**demo.agency@siot.do**](mailto:demo.agency@siot.do)
* **테스트용 PW : dkdlavhxm (한글로 포트원)**

데모 버전 Agent 아이디로 하위몰 설정 및 결제내역 조회 기능 체험이 가능합니다.

<주요 기능>

**1. 하위몰별 PG설정**

* 하위 가맹점을 추가 혹은 삭제하고, 하위 가맹점의 PG사 MID 설정 및 관리를 하실 수 있습니다.

![하위 가맹점 PG설정 예시 화면](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2Fb1JL5uBpsQYRH5VhyN0M%2Fimage.png?alt=media\&token=9ee235f6-7aef-4d0b-87de-00bc06ef12c5)

![하위 가맹점 PG설정 예시 화면](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2F3GFmwkULgcNlr5njUd2l%2Fimage.png?alt=media\&token=c36bfff4-5134-4fd3-bc6a-2263228756ea)

![하위 가맹점 코드 생성 화면](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FHsI2G3cxmMpmqlhTRFYu%2Fimage.png?alt=media\&token=50cda0d7-b698-4c4e-9a2d-6be4a2f97708)

**2. 결제 조회/취소**

* 관리하시는 모든 하위 가맹점의 결제승인 내역을 조회/취소 하실 수 있습니다.

![하위 가맹점 결제내역 조회 예시](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2F8J99P29oK13XqDl5EYHZ%2Fimage.png?alt=media\&token=9bd9cdaf-1a15-4868-b263-ec2049680b6c)

{% hint style="info" %}
**하위 가맹점 결제창 활성화 주의사항**

하위몰별로 결제요청시 **JavaScript SDK** 에서 다음과 같이 **Tier를 구분하여 호출**하실 수 있습니다.

**IMP.agency(가맹점식별코드, Tier(고유)코드 3자리)**

`ex) IMP.agency('imp12345678', '001')`
{% endhint %}

{% hint style="info" %}
**REST API호출시 주의 사항**

REST API호출시에는 Header에 Tier정보를 같이 보내야 해당 Tier에 대한 접근이 가능

HTTP Header 에 아래와 같은 파라미터 설정 필요

`"Tier" : "티어코드 3자리"`
{% endhint %}