---
title: "하위 사업장 등록 URL 발급"
method: POST
path: "/auth/mapping"
tags: ["3.1 파트너 하위 사업장 연동, v2"]
---

# 하위 사업장 등록 URL 발급

`POST /auth/mapping`

## Request

- The document declares no server URL.
- Auth: none declared

파트너사의 하위 사업장 등록을 위한 접근 URL을 발급합니다.
    발급된 URL을 파트너 내부 화면에 연결하여 하위 사업장 등록을 진행할 수 있습니다.

## Request body

- PartnerAuthMappingRequest
  - `apiKey` string, required: 파트너 연동을 위한 고유키
  - `memberId` string, required: 파트너 사용자 코드
  - `merchantId` string, required: 파트너 매장 코드
  - `businessNumber` string: 사업자번호
  - `callbackUrl` string, required: 결제 승인 후 결제 상태를 통보받을 파트너사의 URL
  - `redirectUrl` string: 하위사업장 가입 완료 이후 페이지 이동을 위한 redirectUrl

## Response `200`

성공

- BaseResponsePartnerAuthOpenResponse: 공통 API 응답 포맷 (api.spec: code/message/data)
  - `code` string: 응답 코드
  - `message` string: 응답 메시지
  - `data` PartnerAuthOpenResponse: 파트너 인증 URL 응답
    - `url` string: 접근 URL

---

[API](https://skmtc.dev/payssam/apis/payssam-api.md) - [All operations](https://skmtc.dev/payssam/apis/payssam-api/llms.txt) - [OpenAPI document](https://skmtc.dev/payssam/apis/payssam-api/revisions/73517f9ba4e2?raw)