> For the complete documentation index, see [llms.txt](https://developers.payssam.kr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.payssam.kr/development/merchant.md).

# 하위사업장 등록

하위사업장 등록 API는 파트너의 가맹점이 결제선생 사업장으로 등록하고 파트너의 하위사업장으로 등록하는 프로세스를 제공합니다. 하위사업장 등록 API는 하위사업장 등록이 빈번하게 발생하는 비즈니스 환경의 경우 운영 효율을 높일 수 있습니다.

{% hint style="info" icon="file-lines" %}
[하위사업장 가입 및 등록](/api/api-v2/sub-business.md)
{% endhint %}

## 하위사업장 등록 URL 요청

하위사업장 등록 API를 요청하여 반환 받은 `URL` 를 가맹점에게 제공하세요. 

<figure><img src="/files/wCUzgc6eA5AbxKEjj58W" alt=""><figcaption></figcaption></figure>

#### API 호출 시 전달 파라미터

<table><thead><tr><th width="222.578125">파라미터</th><th width="104.84375">필수 여부</th><th>설명</th></tr></thead><tbody><tr><td>멤버 ID (Member ID)</td><td><strong>필수</strong></td><td>파트너사에서 관리하는 회원 식별값</td></tr><tr><td>머천트 ID (Merchant ID)</td><td><strong>필수</strong></td><td>파트너사에서 관리하는 사업장 식별값</td></tr><tr><td>사업자등록번호</td><td>선택</td><td>등록하려고 하는 가맹점의 사업자등록번호</td></tr><tr><td>콜백 URL</td><td><strong>필수</strong></td><td>연동 결과를 수신받을 파트너사 서버 URL</td></tr><tr><td>리다이렉트 URL</td><td>선택</td><td>연동 완료 후 이동할 파트너사 페이지 URL</td></tr></tbody></table>

## 하위사업장 등록 화면 플로우

가맹점은 `URL`을 통해 결제선생이 제공하는 화면에 접속하여 <kbd>회원가입</kbd> 또는 <kbd>로그인</kbd>하여 사업장을 파트너의 하위사업장으로 등록할 수 있습니다.

#### 파라미터 및 연결 상태에 따른 표시 화면

API 호출 시 전달된 파라미터와 결제선생에 등록된 회원, 사업장의 상태에 따라 표시되는 화면이 달라집니다.

<figure><img src="/files/p2pb4pp3PWcA2tEtml7X" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="231.9609375">조건</th><th>설명</th></tr></thead><tbody><tr><td>멤버 ID 연결 여부</td><td>파트너가 전달한 멤버 ID가 결제선생 회원과 연결되어 있는지 확인</td></tr><tr><td>머천트 ID 연결 여부</td><td>파트너가 전달한 머천트 ID가 결제선생 사업장과 연결되어 있는지 확인</td></tr><tr><td>사업자등록번호 조회</td><td>전달된 사업자등록번호로 등록된 사업장이 있는지 조회</td></tr></tbody></table>

<figure><img src="/files/fX61hZhkQYNQQxrtQv6Z" alt=""><figcaption></figcaption></figure>

#### 플로우 단계별 Callback

각 단계가 완료될때마다 관련 내용을 해당 관련 Callback를 전달합니다.

<table><thead><tr><th width="153.63671875">단계</th><th width="152.796875">Callback</th><th>설명</th></tr></thead><tbody><tr><td>로그인 완료</td><td>맴버 ID 연결</td><td>기존 회원의 멤버 ID 연결</td></tr><tr><td>회원가입 완료</td><td>맴버 ID 연결</td><td>신규 가입한 회원의 멤버 ID 연결</td></tr><tr><td>사업장 등록</td><td>심사중</td><td>신규 사업장 등록 요청이 될 경우 </td></tr><tr><td>사업장 등록 심사</td><td>보완</td><td>심사 결과 보안 상태가 될 경우</td></tr><tr><td>사업장 등록 심사</td><td>반려</td><td>심사 결과 반려 상태가 될 경우</td></tr><tr><td>사업장 등록 심사</td><td>개시</td><td>심사 결과 개시 상태가 될 경우</td></tr><tr><td>사업장 연결 완료</td><td>머천트 ID 연결</td><td>기존 결제선생에 등록된 사업장이 연결될 경우</td></tr></tbody></table>

## 표시 화면 안내

### 회원가입

멤버 ID가 결제선생 회원과 연결되지 않은 경우 회원가입 화면이 제공됩니다.

<figure><img src="/files/C1vKsgTiZncreIEW04rb" alt=""><figcaption></figcaption></figure>

### 사업장 등록

신규 사업장을 등록하는 흐름입니다.

<figure><img src="/files/EVVIJcmvtXwZA2dBLXlb" alt=""><figcaption></figcaption></figure>

**등록 절차**

1. 사업자등록번호 입력 (파트너에서 제공한 번호가 있으면 자동 노출, 변경 가능)
2. 사업장 정보 입력 (간판상호, 지점명, 사업장 전화번호 등)
3. 서류 첨부 (사업자등록증, 대표자 본인인증/신분증 등)
4. 약관 동의 (VAN 서비스 이용약관, 카드가맹 관련 동의)
5. 심사 요청 완료

### 로그인

사업자등록번호로 조회된 기존 사업장이 있으나 멤버 ID가 연결되지 않은 경우, 로그인 화면이 제공됩니다.

<figure><img src="/files/zLQYHSlOGhARgjcq5aIL" alt=""><figcaption></figcaption></figure>

### 사업장 연결

로그인한 회원이 관리하는 사업장 목록이 표시되며, 파트너와 연결할 사업장을 선택합니다.

<figure><img src="/files/739oiFhhZ9NPK6paRaVi" alt=""><figcaption></figcaption></figure>

### 연결된 사업장 정보

머천트 ID가 연결된 사업장과 연결 정보를 확인 할 수 있습니다.

<figure><img src="/files/SAl8EFcqC6aGPCDX9Zqj" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/aInQZHeNUE1Mzq8lpBrc" alt=""><figcaption></figcaption></figure>

## 클라이언트 환경별 지원 방식

결제선생 화면은 파트너사의 클라이언트 환경에 따라 다른 방식으로 제공됩니다.

<table><thead><tr><th width="153.71484375">환경</th><th width="286.94921875">구분</th><th align="center">새창 (blank)</th><th align="center">페이지 이동 (self)</th></tr></thead><tbody><tr><td>PC - APP</td><td>인앱 브라우저</td><td align="center">X</td><td align="center">O</td></tr><tr><td>PC - APP</td><td>외부 브라우저</td><td align="center">X</td><td align="center">-</td></tr><tr><td>PC - WEB</td><td>-</td><td align="center">O</td><td align="center">O</td></tr><tr><td>Mobile - APP</td><td>인앱 브라우저</td><td align="center">X</td><td align="center">O</td></tr><tr><td>Mobile - APP</td><td>외부 브라우저</td><td align="center">X</td><td align="center">-</td></tr><tr><td>Mobile - WEB</td><td>-</td><td align="center">O</td><td align="center">O</td></tr></tbody></table>

{% hint style="warning" %}

#### 주의사항

* **iframe 제공 불가**: 보안 정책상 iframe 내에서 결제선생 화면을 제공할 수 없습니다.
* **리다이렉트 URL**: 파트너사의 환경에서 리다이렉트 URL이 정상 작동할 수 있는 구조여야 합니다.
  * 웹 환경: 리다이렉트 URL로 페이지 이동
  * 앱 환경: 창닫기 브릿지 통신
    {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://developers.payssam.kr/development/merchant.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.