> 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/api/api-v2/sub-merchant.md).

# 하위 사업장 목록 조회

## 하위 사업장 조회

> 파트너의 하위 사업장 리스트를 조회합니다.

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"v0"},"tags":[{"name":"4.1 파트너 기능 이전","description":"manager-if의 기능을 이전한다."}],"servers":[{"url":null,"description":"Generated server url"}],"paths":{"/read/merchant":{"post":{"tags":["4.1 파트너 기능 이전"],"summary":"하위 사업장 조회","description":"파트너의 하위 사업장 리스트를 조회합니다.","operationId":"readMerchant","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerReadRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/BaseResponseListMerchantInfoResponse"}}}}}}}},"components":{"schemas":{"PartnerReadRequest":{"type":"object","description":"쌤포인트 조회(관리 사업장) 요청","properties":{"apiKey":{"type":"string","description":"파트너 연동을 위한 고유키","maxLength":32}},"required":["apiKey"]},"BaseResponseListMerchantInfoResponse":{"type":"object","description":"공통 API 응답 포맷 (api.spec: code/message/data)","properties":{"code":{"type":"string","description":"응답 코드"},"message":{"type":"string","description":"응답 메시지"},"data":{"type":"array","description":"응답 데이터","items":{"$ref":"#/components/schemas/MerchantInfoResponse"}}}},"MerchantInfoResponse":{"type":"object","description":"가맹점 정보 data","properties":{"memberId":{"type":"string","description":"파트너 매장 코드","maxLength":30},"merchantId":{"type":"string","description":"파트너 사용자 코드","maxLength":30},"companyName":{"type":"string","description":"사업장명"},"branchName":{"type":"string","description":"지점명"},"ceoName":{"type":"string","description":"대표자 이름"},"email":{"type":"string","description":"관리 회원의 이메일"},"businessNumber":{"type":"string","description":"사업자등록번호"}},"required":["memberId","merchantId"]}}}}
```

## 하위 사업장 매핑 목록 조회

> apiKey로 파트너의 하위 사업장 전체를 조회 합니다.

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"v0"},"tags":[{"name":"4.1 파트너 기능 이전","description":"manager-if의 기능을 이전한다."}],"servers":[{"url":null,"description":"Generated server url"}],"paths":{"/read/mapping":{"post":{"tags":["4.1 파트너 기능 이전"],"summary":"하위 사업장 매핑 목록 조회","description":"apiKey로 파트너의 하위 사업장 전체를 조회 합니다.","operationId":"readMapping","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerReadRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/BaseResponseListPartnerAuthMappingListOpenResponse"}}}}}}}},"components":{"schemas":{"PartnerReadRequest":{"type":"object","description":"쌤포인트 조회(관리 사업장) 요청","properties":{"apiKey":{"type":"string","description":"파트너 연동을 위한 고유키","maxLength":32}},"required":["apiKey"]},"BaseResponseListPartnerAuthMappingListOpenResponse":{"type":"object","description":"공통 API 응답 포맷 (api.spec: code/message/data)","properties":{"code":{"type":"string","description":"응답 코드"},"message":{"type":"string","description":"응답 메시지"},"data":{"type":"array","description":"응답 데이터","items":{"$ref":"#/components/schemas/PartnerAuthMappingListOpenResponse"}}}},"PartnerAuthMappingListOpenResponse":{"type":"object","description":"    V2 하위 사업장 매핑 단건 응답.\n    /auth/mapping 으로 등록된 partner_auth 행 1건이 응답 1건에 매핑됩니다.\n    매핑 단계에 따라 사업장 정보 필드가 null 일 수 있습니다.\n","properties":{"partnerMember":{"type":"string","description":"파트너사가 자사 시스템에서 식별하는 회원 코드."},"partnerMerchant":{"type":"string","description":"파트너사가 자사 시스템에서 식별하는 매장 코드."},"companyNm":{"type":"string","description":"사업장 회사명. 게시 사업장(merchant) 이 있으면 해당 값, 없으면 임시 사업장(temporary_merchant) 값, 둘 다 없으면 null."},"branchNm":{"type":"string","description":"지점명. 게시 사업장 우선, 없으면 임시 사업장 값."},"businessNumber":{"type":"string","description":"사업자등록번호 (숫자 10자리, 하이픈 없음)."},"ceoName":{"type":"string","description":"대표자명. 게시 사업장(merchant) 의 ceo 값. 게시 사업장 미연결 단계에서는 null."},"email":{"type":"string","description":"회원 이메일. 연결된 user_info 의 member_email 값. 회원 미연결 단계에서는 null."},"mappingStatus":{"type":"string","description":"매핑 단계.\n- `LEGACY`: V2 이전 레거시 매핑\n- `INITIALIZED`: 매핑 생성 (회원/사업장 미연결)\n- `MEMBER_MAPPED`: 회원만 연결됨\n- `MERCHANT_OPENING`: 게시 대기\n- `COMPLETED`: 게시 사업장까지 연결 완료\n","enum":["LEGACY","INITIALIZED","MEMBER_MAPPED","MERCHANT_OPENING","COMPLETED"]},"regDt":{"type":"string","format":"date-time","description":"등록 일시 (ISO-8601 LocalDateTime)."},"updDt":{"type":"string","format":"date-time","description":"수정 일시 (ISO-8601 LocalDateTime)."}}}}}}
```

## 하위 사업장 게시 상태 조회

> apiKey, memberId, merchantId 로 식별된 하위 사업장 매핑의 현재 단계와 사업장 심사 상태를 반환합니다.

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"v0"},"tags":[],"servers":[{"url":null,"description":"Generated server url"}],"paths":{"/auth/mapping/status":{"post":{"tags":["3.1 파트너 하위 사업장 연동, v2"],"summary":"하위 사업장 게시 상태 조회","description":"apiKey, memberId, merchantId 로 식별된 하위 사업장 매핑의 현재 단계와 사업장 심사 상태를 반환합니다.","operationId":"mappingStatus","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerAuthMappingStatusRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseResponsePartnerAuthMappingStatusOpenResponse"}}}}}}}},"components":{"schemas":{"PartnerAuthMappingStatusRequest":{"type":"object","description":"하위 사업장 게시 상태 확인을 위한 요청 request","properties":{"apiKey":{"type":"string","description":"파트너 연동을 위한 고유키","maxLength":32,"minLength":1},"member":{"type":"string","description":"파트너 사용자 코드","maxLength":60,"minLength":1},"merchant":{"type":"string","description":"파트너 매장 코드","maxLength":60,"minLength":1}},"required":["apiKey","member","merchant"]},"BaseResponsePartnerAuthMappingStatusOpenResponse":{"type":"object","description":"공통 API 응답 포맷 (api.spec: code/message/data)","properties":{"code":{"type":"string","description":"응답 코드"},"message":{"type":"string","description":"응답 메시지"},"data":{"$ref":"#/components/schemas/PartnerAuthMappingStatusOpenResponse","description":"응답 데이터"}}},"PartnerAuthMappingStatusOpenResponse":{"type":"object","description":"하위 사업장 등록 상태 응답. apiKey + member + merchant 로 식별된 매핑의 사업장 정보와 심사 상태를 반환합니다. 임시사업장이 아직 등록되지 않은 단계(INITIALIZED/MEMBER_MAPPED)에서는 사업장 관련 필드가 모두 null 입니다.","properties":{"apiKey":{"type":"string","description":"파트너 연동을 위한 고유키 (요청 시 전달한 apiKey 와 동일)"},"member":{"type":"string","description":"파트너사가 자사 시스템에서 식별하는 회원 코드. 요청 시 전달한 memberId 와 동일."},"merchant":{"type":"string","description":"파트너사가 자사 시스템에서 식별하는 매장 코드. 요청 시 전달한 merchantId 와 동일."},"companyNm":{"type":"string","description":"사업장 회사명 (사업자등록증상의 상호)."},"branchNm":{"type":"string","description":"지점명."},"businessNumber":{"type":"string","description":"사업자등록번호 (숫자 10자리, 하이픈 없음)."},"reviewStatus":{"type":"string","description":"심사 상태 코드입니다. 임시사업장 등록 이후의 심사 진행 상황을 나타냅니다.\n- `W`: 심사를 위한 매장 정보 작성 중\n- `P`: 심사 요청 완료, 페이민트 내부 심사 진행 중\n- `R`: 심사 반려\n- `S`: 심사 중 서류 보완이 필요한 상태 (추가 자료 제출 필요)\n- `O`: 심사 완료 및 정식 개시됨\n","enum":["W","P","R","S","O"]}}}}}}
```


---

# 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, and the optional `goal` query parameter:

```
GET https://developers.payssam.kr/api/api-v2/sub-merchant.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.