# 셀러

## 셀러 페널티 요약 조회

> 셀러의 페널티 현황을 요약하여 조회합니다.\
> \
> \## 응답 필드\
> \
> \- \`score\`: 현재 누적된 페널티 점수입니다.\
> \
> \- \`count\`: 페널티가 부과된 건수입니다.\
> \
> \- \`isPenalized\`: 현재 페널티가 적용 중인지 여부입니다.

```json
{"openapi":"3.0.1","info":{"title":"ShoppingFep API","version":"snapshot"},"servers":[{"url":"https://shopping-fep.toss.im"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MerchantPenaltySummaryFepResponse":{"required":["count","isPenalized","score"],"type":"object","properties":{"score":{"type":"integer","description":"페널티 점수","format":"int32"},"count":{"type":"integer","description":"페널티 건수","format":"int32"},"isPenalized":{"type":"boolean","description":"페널티 적용 여부"}},"description":"셀러 페널티 요약 응답"}}},"paths":{"/api/v3/shopping-fep/merchants/penalty/summary":{"get":{"tags":["셀러"],"summary":"셀러 페널티 요약 조회","description":"셀러의 페널티 현황을 요약하여 조회합니다.\n\n## 응답 필드\n\n- `score`: 현재 누적된 페널티 점수입니다.\n\n- `count`: 페널티가 부과된 건수입니다.\n\n- `isPenalized`: 현재 페널티가 적용 중인지 여부입니다.","operationId":"getMerchantPenaltySummary_1","parameters":[{"name":"partnerName","in":"query","description":"연동 프로그램명 또는 자사 서비스명","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"type":"object","properties":{"resultType":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"error":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["REQUEST_FAILED","COMMON_ERROR"]},"reason":{"type":"string","description":"에러 사유"}},"description":"에러 응답, resultType FAIL 시 제공"},"success":{"$ref":"#/components/schemas/MerchantPenaltySummaryFepResponse"}}}}}}}}}}}
```

## 셀러 페널티 부과 목록 조회

> 셀러에게 부과된 페널티 목록을 커서 기반으로 조회합니다.\
> \
> \## 페이징\
> \
> \- 커서 기반 페이징을 사용합니다.\
> \
> \- \`cursorId\`를 지정하지 않으면 최신 데이터부터 조회합니다.\
> \
> \- 응답의 \`nextCursorId\`를 다음 요청의 \`cursorId\`로 전달하면 다음 페이지를 조회할 수 있습니다.\
> \
> \- \`isLast\`가 \`true\`이면 더 이상 조회할 데이터가 없습니다.\
> \
> \- \`size\`는 최대 100까지 지정할 수 있습니다. (기본값: 20)\
> \
> \## 응답 필드\
> \
> \- \`content\`: 페널티 부과 상세 목록입니다.\
> \
> \- \`nextCursorId\`: 다음 페이지 조회를 위한 커서 ID입니다.\
> \
> \- \`isLast\`: 마지막 페이지 여부입니다.

```json
{"openapi":"3.0.1","info":{"title":"ShoppingFep API","version":"snapshot"},"servers":[{"url":"https://shopping-fep.toss.im"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ListPenaltyImpositionsFepResponse":{"required":["content","isLast"],"type":"object","properties":{"content":{"type":"array","description":"페널티 부과 목록","items":{"$ref":"#/components/schemas/PenaltyImpositionFepResponse"}},"nextCursorId":{"type":"integer","description":"다음 페이지 커서 ID","format":"int64"},"isLast":{"type":"boolean","description":"마지막 페이지 여부"}},"description":"셀러 페널티 부과 목록 응답"},"PenaltyImpositionFepResponse":{"required":["appeals","description","id","reason","regTs","score","status"],"type":"object","properties":{"id":{"type":"integer","description":"페널티 부과 ID","format":"int64"},"productItemId":{"type":"integer","description":"상품 아이템 ID","format":"int64"},"productItemName":{"type":"string","description":"상품 아이템명"},"productItemThumbnailUrl":{"type":"string","description":"상품 아이템 썸네일 URL"},"productId":{"type":"integer","description":"상품 ID","format":"int64"},"productName":{"type":"string","description":"상품명"},"orderProductId":{"type":"integer","description":"주문 상품 ID","format":"int64"},"reason":{"type":"string","description":"페널티 사유"},"description":{"type":"string","description":"페널티 상세 설명"},"score":{"type":"integer","description":"페널티 점수","format":"int32"},"status":{"type":"string","description":"페널티 상태 (PENALIZED: 적용 중, RELEASED: 해제, EXPIRED: 만료)"},"expiredTs":{"type":"string","description":"만료 일시","format":"date-time"},"releasedTs":{"type":"string","description":"해제 일시","format":"date-time"},"regTs":{"type":"string","description":"등록 일시","format":"date-time"},"appeals":{"type":"array","description":"소명 목록","items":{"$ref":"#/components/schemas/PenaltyAppealFepResponse"}}},"description":"페널티 부과 상세"},"PenaltyAppealFepResponse":{"required":["attachments","description","id","regTs","status"],"type":"object","properties":{"id":{"type":"integer","description":"소명 ID","format":"int64"},"description":{"type":"string","description":"소명 내용"},"status":{"type":"string","description":"소명 상태 (REQUESTED: 요청, REJECTED: 반려, APPROVED: 승인)"},"inspectedBy":{"type":"string","description":"검토자"},"inspectionTs":{"type":"string","description":"검토 일시","format":"date-time"},"rejectReason":{"type":"string","description":"반려 사유"},"regTs":{"type":"string","description":"등록 일시","format":"date-time"},"attachments":{"type":"array","description":"첨부파일 목록","items":{"$ref":"#/components/schemas/PenaltyAppealAttachmentFepResponse"}}},"description":"소명 상세"},"PenaltyAppealAttachmentFepResponse":{"required":["contentType","fileSize","id","originFileName"],"type":"object","properties":{"id":{"type":"integer","description":"첨부파일 ID","format":"int64"},"originFileName":{"type":"string","description":"원본 파일명"},"contentType":{"type":"string","description":"파일 타입"},"fileSize":{"type":"integer","description":"파일 크기 (bytes)","format":"int64"}},"description":"소명 첨부파일"}}},"paths":{"/api/v3/shopping-fep/merchants/penalty/impositions":{"get":{"tags":["셀러"],"summary":"셀러 페널티 부과 목록 조회","description":"셀러에게 부과된 페널티 목록을 커서 기반으로 조회합니다.\n\n## 페이징\n\n- 커서 기반 페이징을 사용합니다.\n\n- `cursorId`를 지정하지 않으면 최신 데이터부터 조회합니다.\n\n- 응답의 `nextCursorId`를 다음 요청의 `cursorId`로 전달하면 다음 페이지를 조회할 수 있습니다.\n\n- `isLast`가 `true`이면 더 이상 조회할 데이터가 없습니다.\n\n- `size`는 최대 100까지 지정할 수 있습니다. (기본값: 20)\n\n## 응답 필드\n\n- `content`: 페널티 부과 상세 목록입니다.\n\n- `nextCursorId`: 다음 페이지 조회를 위한 커서 ID입니다.\n\n- `isLast`: 마지막 페이지 여부입니다.","operationId":"getPenaltyImpositions","parameters":[{"name":"cursorId","in":"query","description":"커서 ID (지정하지 않으면 최신 데이터부터 조회)","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"size","in":"query","description":"조회 건수","required":false,"schema":{"type":"integer","format":"int32","default":20}},{"name":"partnerName","in":"query","description":"연동 프로그램명 또는 자사 서비스명","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"type":"object","properties":{"resultType":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"error":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["INVALID_REQUEST","REQUEST_FAILED","COMMON_ERROR"]},"reason":{"type":"string","description":"에러 사유"}},"description":"에러 응답, resultType FAIL 시 제공"},"success":{"$ref":"#/components/schemas/ListPenaltyImpositionsFepResponse"}}}}}}}}}}}
```

## 셀러 페널티 소명 자료 제출

> 페널티에 대한 소명 자료를 제출합니다.\
> \
> \## 요청 방식\
> \
> \- \`multipart/form-data\` 형식으로 요청합니다.\
> \
> \- \`penaltyImpositionId\`: 소명할 페널티 부과 ID입니다.\
> \
> \- \`description\`: 소명 내용입니다.\
> \
> \- \`attachments\`: 첨부파일 목록입니다. (선택)\
> \
> \## 첨부파일 제약 조건\
> \
> \- 최대 3개까지 첨부할 수 있습니다.\
> \
> \- 허용 확장자: \`png\`, \`jpg\`, \`jpeg\`, \`pdf\`, \`hwp\`\
> \
> \- 개별 파일 최대 크기: 10MB\
> \
> \- 요청 전체 최대 크기: 10MB\
> \
> \## 응답 필드\
> \
> \- \`appealId\`: 생성된 소명 ID입니다.\
> \
> \- \`status\`: 소명 상태입니다.

```json
{"openapi":"3.0.1","info":{"title":"ShoppingFep API","version":"snapshot"},"servers":[{"url":"https://shopping-fep.toss.im"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"CreatePenaltyAppealFepResponse":{"required":["appealId","status"],"type":"object","properties":{"appealId":{"type":"integer","description":"소명 ID","format":"int64"},"status":{"type":"string","description":"소명 상태 (REQUESTED: 요청, REJECTED: 반려, APPROVED: 승인)"}},"description":"페널티 소명 자료 제출 응답"}}},"paths":{"/api/v3/shopping-fep/merchants/penalty/appeals":{"post":{"tags":["셀러"],"summary":"셀러 페널티 소명 자료 제출","description":"페널티에 대한 소명 자료를 제출합니다.\n\n## 요청 방식\n\n- `multipart/form-data` 형식으로 요청합니다.\n\n- `penaltyImpositionId`: 소명할 페널티 부과 ID입니다.\n\n- `description`: 소명 내용입니다.\n\n- `attachments`: 첨부파일 목록입니다. (선택)\n\n## 첨부파일 제약 조건\n\n- 최대 3개까지 첨부할 수 있습니다.\n\n- 허용 확장자: `png`, `jpg`, `jpeg`, `pdf`, `hwp`\n\n- 개별 파일 최대 크기: 10MB\n\n- 요청 전체 최대 크기: 10MB\n\n## 응답 필드\n\n- `appealId`: 생성된 소명 ID입니다.\n\n- `status`: 소명 상태입니다.","operationId":"createPenaltyAppeal_1","parameters":[{"name":"penaltyImpositionId","in":"query","description":"페널티 부과 ID","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"description","in":"query","description":"소명 내용","required":true,"schema":{"type":"string"}},{"name":"partnerName","in":"query","description":"연동 프로그램명 또는 자사 서비스명","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"attachments":{"type":"array","items":{"type":"string","format":"binary"}}}}}}},"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"type":"object","properties":{"resultType":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"error":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["INVALID_REQUEST","REQUEST_FAILED","COMMON_ERROR"]},"reason":{"type":"string","description":"에러 사유"}},"description":"에러 응답, resultType FAIL 시 제공"},"success":{"$ref":"#/components/schemas/CreatePenaltyAppealFepResponse"}}}}}}}}}}}
```

## 셀러 휴무일 목록 조회

> 셀러의 휴무일 목록을 기간별로 조회합니다.\
> \
> \## 조회 조건\
> \
> \- \`startDate\`와 \`endDate\`를 기준으로 해당 기간에 포함된 휴무일을 반환합니다.\
> \
> \- 날짜 형식은 \`yyyy-MM-dd\`입니다.\
> \
> \## 활용 예시\
> \
> \- 배송 예정일 계산 시 셀러 휴무일을 제외하여 정확한 배송일을 안내할 수 있습니다.\
> \
> \- 셀러 운영 캘린더에 휴무일을 표시할 수 있습니다.

```json
{"openapi":"3.0.1","info":{"title":"ShoppingFep API","version":"snapshot"},"servers":[{"url":"https://shopping-fep.toss.im"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ListMerchantHolidaysFepResponse":{"required":["items"],"type":"object","properties":{"items":{"type":"array","description":"휴무일 목록","items":{"$ref":"#/components/schemas/MerchantHoliday"}}},"description":"셀러 휴무일 목록 조회 응답"},"MerchantHoliday":{"required":["holiday","id","name"],"type":"object","properties":{"id":{"type":"integer","description":"휴무일 ID","format":"int64"},"name":{"type":"string","description":"휴무명"},"holiday":{"type":"string","description":"휴무일","format":"date"},"regTs":{"type":"string","description":"등록일시","format":"date-time"},"updTs":{"type":"string","description":"수정일시","format":"date-time"}},"description":"셀러 휴무일 항목"}}},"paths":{"/api/v3/shopping-fep/merchants/holidays":{"get":{"tags":["셀러"],"summary":"셀러 휴무일 목록 조회","description":"셀러의 휴무일 목록을 기간별로 조회합니다.\n\n## 조회 조건\n\n- `startDate`와 `endDate`를 기준으로 해당 기간에 포함된 휴무일을 반환합니다.\n\n- 날짜 형식은 `yyyy-MM-dd`입니다.\n\n## 활용 예시\n\n- 배송 예정일 계산 시 셀러 휴무일을 제외하여 정확한 배송일을 안내할 수 있습니다.\n\n- 셀러 운영 캘린더에 휴무일을 표시할 수 있습니다.","operationId":"getMerchantHolidays","parameters":[{"name":"startDate","in":"query","description":"조회 시작일 (yyyy-MM-dd)","required":true,"schema":{"type":"string","format":"date"}},{"name":"endDate","in":"query","description":"조회 종료일 (yyyy-MM-dd)","required":true,"schema":{"type":"string","format":"date"}},{"name":"partnerName","in":"query","description":"연동 프로그램명 또는 자사 서비스명","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"type":"object","properties":{"resultType":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"error":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["REQUEST_FAILED","COMMON_ERROR"]},"reason":{"type":"string","description":"에러 사유"}},"description":"에러 응답, resultType FAIL 시 제공"},"success":{"$ref":"#/components/schemas/ListMerchantHolidaysFepResponse"}}}}}}}}}}}
```

## 셀러 휴무일 등록

> 셀러의 휴무일을 등록합니다. (upsert 방식)\
> \
> \## 등록 방식\
> \
> \- \`startDate\`부터 \`endDate\`까지의 기간에 해당하는 휴무일을 일괄 등록합니다.\
> \
> \- 동일한 날짜에 이미 휴무일이 등록되어 있는 경우 휴무명이 갱신됩니다. (upsert)\
> \
> \- 날짜 형식은 \`yyyy-MM-dd\`입니다.\
> \
> \## 활용 예시\
> \
> \- 설날, 추석 등 연휴 기간의 휴무일을 한 번에 등록할 수 있습니다.\
> \
> \- 특정 날짜의 임시 휴무를 등록할 수 있습니다.

```json
{"openapi":"3.0.1","info":{"title":"ShoppingFep API","version":"snapshot"},"servers":[{"url":"https://shopping-fep.toss.im"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"CreateMerchantHolidayFepRequest":{"required":["endDate","name","startDate"],"type":"object","properties":{"name":{"maxLength":100,"minLength":0,"type":"string","description":"휴무명"},"startDate":{"type":"string","description":"시작일 (yyyy-MM-dd)","format":"date"},"endDate":{"type":"string","description":"종료일 (yyyy-MM-dd)","format":"date"}},"description":"셀러 휴무일 등록 요청"},"ListMerchantHolidaysFepResponse":{"required":["items"],"type":"object","properties":{"items":{"type":"array","description":"휴무일 목록","items":{"$ref":"#/components/schemas/MerchantHoliday"}}},"description":"셀러 휴무일 목록 조회 응답"},"MerchantHoliday":{"required":["holiday","id","name"],"type":"object","properties":{"id":{"type":"integer","description":"휴무일 ID","format":"int64"},"name":{"type":"string","description":"휴무명"},"holiday":{"type":"string","description":"휴무일","format":"date"},"regTs":{"type":"string","description":"등록일시","format":"date-time"},"updTs":{"type":"string","description":"수정일시","format":"date-time"}},"description":"셀러 휴무일 항목"}}},"paths":{"/api/v3/shopping-fep/merchants/holidays":{"post":{"tags":["셀러"],"summary":"셀러 휴무일 등록","description":"셀러의 휴무일을 등록합니다. (upsert 방식)\n\n## 등록 방식\n\n- `startDate`부터 `endDate`까지의 기간에 해당하는 휴무일을 일괄 등록합니다.\n\n- 동일한 날짜에 이미 휴무일이 등록되어 있는 경우 휴무명이 갱신됩니다. (upsert)\n\n- 날짜 형식은 `yyyy-MM-dd`입니다.\n\n## 활용 예시\n\n- 설날, 추석 등 연휴 기간의 휴무일을 한 번에 등록할 수 있습니다.\n\n- 특정 날짜의 임시 휴무를 등록할 수 있습니다.","operationId":"registerMerchantHolidays","parameters":[{"name":"partnerName","in":"query","description":"연동 프로그램명 또는 자사 서비스명","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateMerchantHolidayFepRequest"}}},"required":true},"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"type":"object","properties":{"resultType":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"error":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["INVALID_REQUEST","REQUEST_FAILED","COMMON_ERROR"]},"reason":{"type":"string","description":"에러 사유"}},"description":"에러 응답, resultType FAIL 시 제공"},"success":{"$ref":"#/components/schemas/ListMerchantHolidaysFepResponse"}}}}}}}}}}}
```

## 셀러 휴무일 수정

> 등록된 셀러 휴무일의 휴무명을 수정합니다.\
> \
> \## 수정 대상\
> \
> \- 휴무일 ID(\`holidayId\`)에 해당하는 휴무일의 휴무명을 변경합니다.\
> \
> \- 휴무명은 최대 100자까지 입력할 수 있습니다.

```json
{"openapi":"3.0.1","info":{"title":"ShoppingFep API","version":"snapshot"},"servers":[{"url":"https://shopping-fep.toss.im"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"UpdateMerchantHolidayFepRequest":{"required":["name"],"type":"object","properties":{"name":{"maxLength":100,"minLength":0,"type":"string","description":"휴무명"}},"description":"셀러 휴무일 수정 요청"},"MerchantHoliday":{"required":["holiday","id","name"],"type":"object","properties":{"id":{"type":"integer","description":"휴무일 ID","format":"int64"},"name":{"type":"string","description":"휴무명"},"holiday":{"type":"string","description":"휴무일","format":"date"},"regTs":{"type":"string","description":"등록일시","format":"date-time"},"updTs":{"type":"string","description":"수정일시","format":"date-time"}},"description":"셀러 휴무일 항목"}}},"paths":{"/api/v3/shopping-fep/merchants/holidays/{holidayId}":{"put":{"tags":["셀러"],"summary":"셀러 휴무일 수정","description":"등록된 셀러 휴무일의 휴무명을 수정합니다.\n\n## 수정 대상\n\n- 휴무일 ID(`holidayId`)에 해당하는 휴무일의 휴무명을 변경합니다.\n\n- 휴무명은 최대 100자까지 입력할 수 있습니다.","operationId":"updateMerchantHoliday","parameters":[{"name":"holidayId","in":"path","description":"휴무일 ID","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"partnerName","in":"query","description":"연동 프로그램명 또는 자사 서비스명","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateMerchantHolidayFepRequest"}}},"required":true},"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"type":"object","properties":{"resultType":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"error":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["REQUEST_FAILED","COMMON_ERROR"]},"reason":{"type":"string","description":"에러 사유"}},"description":"에러 응답, resultType FAIL 시 제공"},"success":{"$ref":"#/components/schemas/MerchantHoliday"}}}}}}}}}}}
```

## 셀러 휴무일 삭제

> 등록된 셀러 휴무일을 삭제합니다.\
> \
> \## 삭제 대상\
> \
> \- 휴무일 ID(\`holidayId\`)에 해당하는 휴무일을 삭제합니다.\
> \
> \- 삭제된 휴무일은 복구할 수 없습니다.

```json
{"openapi":"3.0.1","info":{"title":"ShoppingFep API","version":"snapshot"},"servers":[{"url":"https://shopping-fep.toss.im"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/api/v3/shopping-fep/merchants/holidays/{holidayId}":{"delete":{"tags":["셀러"],"summary":"셀러 휴무일 삭제","description":"등록된 셀러 휴무일을 삭제합니다.\n\n## 삭제 대상\n\n- 휴무일 ID(`holidayId`)에 해당하는 휴무일을 삭제합니다.\n\n- 삭제된 휴무일은 복구할 수 없습니다.","operationId":"deleteMerchantHoliday","parameters":[{"name":"holidayId","in":"path","description":"휴무일 ID","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"partnerName","in":"query","description":"연동 프로그램명 또는 자사 서비스명","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"type":"object","properties":{"resultType":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"error":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["REQUEST_FAILED","COMMON_ERROR"]},"reason":{"type":"string","description":"에러 사유"}},"description":"에러 응답, resultType FAIL 시 제공"},"success":{"type":"object","description":"성공시 제공, 별도 내용이 없습니다. {}으로 반환"}}}}}}}}}}}
```


---

# Agent Instructions: 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://shopping-docs.toss.im/dev/api-2/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.