{"openapi":"3.1.0","info":{"title":"토스플레이스 Open API","description":"토스플레이스 Open API는 서버 간 안정적인 데이터 연동을 위한 API예요. POS 시스템의 주문, 결제, 상품 정보에 안전하게 접근할 수 있어요.\n\n자세한 정보는 [Open API 연동 가이드](https://docs.tossplace.com/reference/open-api/intro.html)를 참고해주세요.\n\n기술 문의: [developer-support@tossplace.com](mailto:developer-support@tossplace.com)","version":"2026-11-01"},"servers":[{"url":"https://open-api.tossplace.com"}],"security":[{"x-access-key":[]},{"x-secret-key":[]}],"paths":{"/api-public/openapi/v1/merchants/{merchantId}/order/orders/{orderId}/update-line-items":{"put":{"tags":["주문"],"summary":"주문 내역 변경","description":"주문 내역을 변경합니다. 주문 내역이 변경됨에 따라 다시 계산한 청구 금액, 할인 내역을 같이 반영해야 합니다.","operationId":"updateOrderLineItems","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"orderId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/UpdateLineItemsRequest"}}},"required":true},"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseOrder"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/payment/payments":{"post":{"tags":["결제"],"summary":"승인된 결제 기록","description":"주문에 승인된 결제 기록을 추가합니다. 주문 생성 API를 통해 생성한 주문에 대해서만 결제를 기록할 수 있습니다.","operationId":"createPayment","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/PaymentCreateRequest"}}},"required":true},"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponsePayment"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/payment/payments/{paymentId}/cancel":{"post":{"tags":["결제"],"summary":"취소된 결제 기록","description":"취소된 결제를 기록합니다. 주문 생성 API를 통해 생성한 주문의 결제 내역에 대해서만 취소 처리할 수 있습니다.","operationId":"cancelPayment","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"paymentId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/PaymentCancel"}}},"required":true},"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponsePayment"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/order/orders":{"get":{"tags":["주문"],"summary":"주문 목록 조회","description":"매장의 주문 목록을 주문의 결제 내역 변동 시각 순으로 조회합니다.","operationId":"listOrders","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"orderStates","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","description":"주문 상태","enum":["REQUESTED","OPENED","COMPLETED","CANCELLED","UNDEFINED"]}}},{"name":"sources","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1,"minimum":1}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":100,"maximum":500,"minimum":1}},{"name":"sortOrder","in":"query","required":false,"schema":{"type":"string","default":"DESC","description":"정렬 순서","enum":["ASC","DESC"]}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseListOrder"}}}}}},"post":{"tags":["주문"],"summary":"주문 생성","description":"주문을 생성합니다.","operationId":"createOrder","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"printOrderSheet","in":"query","description":"주문서 출력 여부. 토스 POS와 연결된 프린터에서 주문서를 출력합니다.","required":false,"schema":{"type":"boolean","default":false}}],"requestBody":{"content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/OrderCreateRequest"}}},"required":true},"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseOrder"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/order/orders/{orderId}/redemptions":{"post":{"tags":["주문"],"summary":"혜택 사용 추가","description":"주문에 혜택 사용 내역을 추가합니다.","operationId":"appendRedemptions","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"orderId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/OrderRedemptionsCreateRequest"}}},"required":true},"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseOrder"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/order/orders/{orderId}/decline":{"post":{"tags":["주문"],"summary":"주문 거절","description":"주문을 거절합니다.","operationId":"declineOrder","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"orderId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/OrderDeclineRequest"}}}},"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseOrder"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/order/orders/{orderId}/cancel":{"post":{"tags":["주문"],"summary":"주문 취소","description":"주문을 취소하고 주문 상태를 CANCELLED로 변경합니다. 주문에 포함된 결제 내역은 이 API로 취소되지 않습니다.","operationId":"cancelOrder","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"orderId","in":"path","required":true,"schema":{"type":"string"}},{"name":"printOrderSheet","in":"query","description":"주문서 출력 여부. 주문 취소와 함께 토스 POS와 연결된 프린터에서 취소 주문서를 출력합니다.","required":false,"schema":{"type":"boolean","default":false}}],"requestBody":{"content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/OrderCancelRequest"}}}},"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseOrder"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/order/orders/{orderId}/accruals":{"post":{"tags":["주문"],"summary":"적립 추가","description":"주문에 적립 내역을 추가합니다.","operationId":"appendAccruals","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"orderId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/OrderAccrualsCreateRequest"}}},"required":true},"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseOrder"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/order/orders/{orderId}/accept":{"post":{"tags":["주문"],"summary":"주문 수락","description":"주문을 수락합니다.","operationId":"acceptOrder","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"orderId","in":"path","required":true,"schema":{"type":"string"}},{"name":"printOrderSheet","in":"query","description":"주문서 출력 여부. 주문 수락과 함께 토스 POS와 연결된 프린터에서 주문서를 출력합니다.","required":false,"schema":{"type":"boolean","default":false}}],"requestBody":{"content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/OrderAcceptRequest"}}}},"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseOrder"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/discount/discount-policies/batch-auto-apply":{"post":{"tags":["할인"],"summary":"할인 정책 자동 적용 (묶음 요청)","description":"주어진 요청에 자동 적용될 수 있는 할인 정책을 확인합니다. 묶음 요청은 최대 100건까지 가능하며, 응답은 묶음 요청의 순서 그대로 반환됩니다.","operationId":"batchAutoApply","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/DiscountPolicyBatchAutoApplyRequest"}}},"required":true},"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseListListDiscountPolicy"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/discount/discount-policies/auto-apply":{"post":{"tags":["할인"],"summary":"할인 정책 자동 적용","description":"주어진 요청에 자동 적용될 수 있는 할인 정책을 확인합니다.","operationId":"autoApply","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/DiscountPolicyAutoApplyRequest"}}},"required":true},"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseListDiscountPolicy"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/delivery/deliveries":{"post":{"tags":["배달"],"summary":"배달 정보 등록","description":"주문에 배달 정보를 등록합니다.","operationId":"createDelivery","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/DeliveryCreateRequest"}}},"required":true},"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseDelivery"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/delivery/deliveries/{deliveryId}/complete":{"post":{"tags":["배달"],"summary":"배달 완료 처리","description":"배달을 완료 처리합니다.","operationId":"completeDelivery","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"deliveryId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseDelivery"}}}}}}},"/api-public/openapi/v1/data-export/exports":{"get":{"tags":["데이터 내보내기"],"summary":"데이터 추출 목록 조회","description":"데이터 추출 요청 내역을 조회합니다.","operationId":"list","parameters":[{"name":"page","in":"query","description":"조회할 페이지","required":false,"schema":{"type":"integer","format":"int32","default":1,"minimum":1}},{"name":"size","in":"query","description":"페이지 크기","required":false,"schema":{"type":"integer","format":"int32","default":25,"maximum":500,"minimum":1}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseListDataExport"}}}}}},"post":{"tags":["데이터 내보내기"],"summary":"데이터 추출 요청","description":"데이터 추출을 요청합니다.","operationId":"create","requestBody":{"content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/DataExportCreateRequest"}}},"required":true},"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseDataExport"}}}}}}},"/api-public/openapi/v1/data-export/exports/{requestId}/files/{fileKey}/download":{"post":{"tags":["데이터 내보내기"],"summary":"데이터 추출 결과 파일 다운로드 링크 발급","description":"데이터 추출 결과 파일 다운로드 링크를 발급합니다. 발급된 링크는 15분간 유효합니다. 만료된 요청의 파일은 다운로드할 수 없습니다.","operationId":"issueDownloadUrl","parameters":[{"name":"requestId","in":"path","description":"요청 ID","required":true,"schema":{"type":"string"}},{"name":"fileKey","in":"path","description":"파일 식별자","required":true,"schema":{"type":"string"}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseDataExportFileDownload"}}}}}}},"/api-public/openapi/v1/data-export/exports/{requestId}/cancel":{"post":{"tags":["데이터 내보내기"],"summary":"데이터 추출 취소","description":"데이터 추출을 취소합니다.","operationId":"cancel","parameters":[{"name":"requestId","in":"path","description":"요청 ID","required":true,"schema":{"type":"string"}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseDataExport"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/delivery/deliveries/{deliveryId}":{"get":{"tags":["배달"],"summary":"배달 정보 단건 조회","description":"배달 정보 하나를 조회합니다.","operationId":"getDelivery","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"deliveryId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseDelivery"}}}}}},"patch":{"tags":["배달"],"summary":"배달 정보 수정","description":"주문의 배달 정보를 수정합니다.","operationId":"patchDelivery","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"deliveryId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/DeliveryPatchRequest"}}},"required":true},"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseDelivery"}}}}}}},"/api-public/openapi/v1/version":{"get":{"tags":["일반"],"summary":"Open API 버전 정보 조회","description":"Open API 버전 정보를 조회합니다.","operationId":"version","responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseVersion"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}":{"get":{"tags":["매장"],"summary":"매장 정보 조회","description":"ID에 해당하는 매장 정보를 조회합니다.","operationId":"getMerchant","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseMerchant"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/payment/payments/{paymentId}":{"get":{"tags":["결제"],"summary":"결제 단건 조회","description":"매장의 결제 하나를 조회합니다.","operationId":"getPayment","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"paymentId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponsePayment"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/payment/payments/by-order-id":{"get":{"tags":["결제"],"summary":"주문의 결제건 모두 조회","description":"주문 하나의 결제 건을 모두 조회합니다.","operationId":"getPaymentsByOrderId","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"orderId","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseListPayment"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/order/orders/{orderId}":{"get":{"tags":["주문"],"summary":"주문 단건 조회","description":"매장의 주문 하나를 조회합니다.","operationId":"getOrder","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"orderId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseOrder"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/order/orders/by-order-keys":{"get":{"tags":["주문"],"summary":"주문 키로 주문 복수건 조회","description":"주어진 주문 키 값들을 가지는 주문 여러 건을 조회합니다. 최대 25건까지 조회 가능합니다.","operationId":"getOrdersByOrderKeys","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"orderKeys","in":"query","required":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":25,"minItems":1}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseListOrder"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/order/orders/by-order-key/{orderKey}":{"get":{"tags":["주문"],"summary":"주문 키로 주문 단건 조회","description":"주어진 주문 키 값을 가지는 주문 하나를 조회합니다.","operationId":"getOrderByOrderKey","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"orderKey","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseOrder"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/order/orders/by-ids":{"get":{"tags":["주문"],"summary":"주문 복수건 조회","description":"ID를 통해 매장의 주문 여러 건을 조회합니다. 최대 25건까지 조회 가능합니다.","operationId":"getOrdersByIds","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"ids","in":"query","required":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":25,"minItems":1}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseListOrder"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/discount/discount-policies":{"get":{"tags":["할인"],"summary":"할인 정책 목록 조회","description":"매장에 등록된 할인 정책 목록을 조회합니다. 정책 정의를 확인하는 용도로 사용해 주세요. 실제 할인 적용 여부와 금액은 주문 결과를 통해 확인하는 것을 권장합니다.","operationId":"list_1","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1,"minimum":1}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":100,"maximum":500,"minimum":1}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseListDiscountPolicy"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/discount/discount-policies/{discountPolicyId}":{"get":{"tags":["할인"],"summary":"할인 정책 단건 조회","description":"매장의 할인 정책 하나를 조회합니다.","operationId":"get","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"discountPolicyId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseDiscountPolicy"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/discount/discount-policies/by-ids":{"get":{"tags":["할인"],"summary":"할인 정책 복수건 조회","description":"ID를 통해 매장의 할인 정책 여러 건을 조회합니다. 최대 25건까지 조회 가능합니다.","operationId":"getByIds","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"ids","in":"query","required":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":25,"minItems":1}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseListDiscountPolicy"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/delivery/deliveries/by-order-ids":{"get":{"tags":["배달"],"summary":"주문의 배달 정보 복수건 조회","description":"주어진 주문 ID 목록에 해당하는 배달 정보를 조회합니다. 최대 25건까지 조회 가능합니다.","operationId":"getDeliveriesByOrderIds","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"orderIds","in":"query","required":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":25,"minItems":1}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseListDelivery"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/delivery/deliveries/by-order-id/{orderId}":{"get":{"tags":["배달"],"summary":"주문의 배달 정보 단건 조회","description":"주어진 주문 ID에 해당하는 배달 정보를 조회합니다.","operationId":"getDeliveryByOrderId","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"orderId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseDelivery"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/delivery/deliveries/by-ids":{"get":{"tags":["배달"],"summary":"배달 정보 복수건 조회","description":"배달 정보 여러 건을 조회합니다. 최대 25건까지 조회 가능합니다.","operationId":"getDeliveriesByIds","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"ids","in":"query","required":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":25,"minItems":1}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseListDelivery"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/catalog/rules":{"get":{"tags":["카탈로그"],"summary":"전시 규칙 목록 조회","description":"매장의 전시 규칙 목록을 조회합니다.","operationId":"listCatalogRules","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1,"minimum":1}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":100,"maximum":500,"minimum":1}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseListCatalogRule"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/catalog/rules/{ruleId}":{"get":{"tags":["카탈로그"],"summary":"전시 규칙 단건 조회","description":"매장의 전시 규칙 하나를 조회합니다.","operationId":"getCatalogRule","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"ruleId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseCatalogRule"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/catalog/rules/by-ids":{"get":{"tags":["카탈로그"],"summary":"전시 규칙 복수건 조회","description":"ID를 통해 매장의 전시 규칙 여러 건을 조회합니다. 최대 25건까지 조회 가능합니다.","operationId":"getCatalogRulesByIds","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"ids","in":"query","required":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":25,"minItems":1}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseListCatalogRule"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/catalog/options":{"get":{"tags":["카탈로그"],"summary":"옵션 목록 조회","description":"매장의 옵션 목록을 조회합니다.","operationId":"listCatalogOptions","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1,"minimum":1}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":100,"maximum":500,"minimum":1}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseListCatalogOption"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/catalog/options/{optionId}":{"get":{"tags":["카탈로그"],"summary":"옵션 단건 조회","description":"매장의 옵션 하나를 조회합니다.","operationId":"getCatalogOption","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"optionId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseCatalogOption"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/catalog/options/by-ids":{"get":{"tags":["카탈로그"],"summary":"옵션 복수건 조회","description":"ID를 통해 매장의 옵션 여러 건을 조회합니다. 최대 25건까지 조회 가능합니다.","operationId":"getCatalogOptionsByIds","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"ids","in":"query","required":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":25,"minItems":1}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseListCatalogOption"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/catalog/items":{"get":{"tags":["카탈로그"],"summary":"상품 목록 조회","description":"매장의 상품 목록을 상품 ID 순으로 조회합니다.","operationId":"listCatalogItems","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1,"minimum":1}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":100,"maximum":500,"minimum":1}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseListCatalogItem"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/catalog/items/{itemId}":{"get":{"tags":["카탈로그"],"summary":"상품 단건 조회","description":"매장의 상품 하나를 조회합니다.","operationId":"getCatalogItem","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"itemId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseCatalogItem"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/catalog/items/search":{"get":{"tags":["카탈로그"],"summary":"상품 검색","description":"조건에 맞는 상품을 검색합니다.","operationId":"searchCatalogItems","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"categoryIds","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"maxItems":25,"minItems":0}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1,"minimum":1}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":100,"maximum":500,"minimum":1}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseListCatalogItem"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/catalog/items/by-ids":{"get":{"tags":["카탈로그"],"summary":"상품 복수건 조회","description":"ID를 통해 매장의 상품 여러 건을 조회합니다. 최대 25건까지 조회 가능합니다.","operationId":"getCatalogItemsByIds","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"ids","in":"query","required":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":25,"minItems":1}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseListCatalogItem"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/catalog/combos":{"get":{"tags":["카탈로그"],"summary":"콤보 목록 조회","description":"매장의 콤보 목록을 조회합니다.","operationId":"listCatalogCombos","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1,"minimum":1}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":100,"maximum":500,"minimum":1}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseListCatalogCombo"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/catalog/combos/{comboId}":{"get":{"tags":["카탈로그"],"summary":"콤보 단건 조회","description":"매장의 콤보 하나를 조회합니다.","operationId":"getCatalogCombo","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"comboId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseCatalogCombo"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/catalog/combos/by-ids":{"get":{"tags":["카탈로그"],"summary":"콤보 복수건 조회","description":"ID를 통해 매장의 콤보 여러 건을 조회합니다. 최대 25건까지 조회 가능합니다.","operationId":"getCatalogCombosByIds","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"ids","in":"query","required":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":25,"minItems":1}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseListCatalogCombo"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/catalog/categories":{"get":{"tags":["카탈로그"],"summary":"카테고리 목록 조회","description":"매장의 카테고리 목록을 조회합니다.","operationId":"listCatalogCategories","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1,"minimum":1}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":100,"maximum":500,"minimum":1}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseListCatalogCategory"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/catalog/categories/{categoryId}":{"get":{"tags":["카탈로그"],"summary":"카테고리 단건 조회","description":"매장의 카테고리 하나를 조회합니다.","operationId":"getCatalogCategory","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"categoryId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseCatalogCategory"}}}}}}},"/api-public/openapi/v1/merchants/{merchantId}/catalog/categories/by-ids":{"get":{"tags":["카탈로그"],"summary":"카테고리 복수건 조회","description":"ID를 통해 매장의 카테고리 여러 건을 조회합니다. 최대 25건까지 조회 가능합니다.","operationId":"getCatalogCategoriesByIds","parameters":[{"name":"merchantId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"ids","in":"query","required":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":25,"minItems":1}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseListCatalogCategory"}}}}}}},"/api-public/openapi/v1/data-export/exports/{requestId}":{"get":{"tags":["데이터 내보내기"],"summary":"데이터 추출 단건 조회","description":"데이터 추출 요청 하나를 조회합니다.","operationId":"get_1","parameters":[{"name":"requestId","in":"path","description":"요청 ID","required":true,"schema":{"type":"string"}}],"responses":{"403":{"description":"Forbidden","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"500":{"description":"Internal Server Error","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"400":{"description":"Bad Request","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseObject"}}}},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/ApiResponseDataExport"}}}}}}}},"components":{"schemas":{"ApiResponseObject":{"type":"object","properties":{"resultType":{"type":"string","enum":["SUCCESS","FAIL","HTTP_TIMEOUT","NETWORK_ERROR","EXECUTION_FAIL","INTERRUPTED","INTERNAL_ERROR"]},"metadata":{},"error":{"$ref":"#/components/schemas/ErrorMessage"},"success":{}}},"ErrorMessage":{"type":"object","properties":{"errorCode":{"type":"string"},"reason":{"type":"string"},"data":{"type":"object","additionalProperties":{}}}},"Discount":{"type":"object","description":"주문에 적용된 할인","properties":{"title":{"type":"string","description":"할인명","example":"PROMOTION","maxLength":1000,"minLength":0},"type":{"type":["string","null"],"description":"할인 종류 (예: \"FIXED_AMOUNT\", \"FIXED_PERCENTAGE\")","example":"FIXED_AMOUNT","maxLength":128,"minLength":1},"code":{"type":["string","null"],"description":"할인 코드","example":"PROMOTION_00","maxLength":1000,"minLength":1},"amount":{"type":"integer","format":"int64","description":"할인 금액","example":1000},"percentage":{"type":"number","format":"double","description":"정률할인 비율 (정률할인이 아닌 경우 0.0)","example":0.0,"maximum":100,"minimum":0},"fixedAmount":{"type":"integer","format":"int64","description":"정액할인 금액 (정액할인이 아닌 경우 0)","example":1000,"minimum":0},"precedence":{"type":["integer","null"],"format":"int32","description":"할인 적용 우선순위 (값이 작을수록 높은 우선순위)","example":1},"couponDetails":{"description":"할인 쿠폰 상세 정보","oneOf":[{"$ref":"#/components/schemas/DiscountCouponDetails"},{"type":"null"}]}},"required":["amount","fixedAmount","percentage","title"]},"DiscountCouponDetails":{"type":"object","description":"할인 쿠폰 상세 정보","properties":{"provider":{"type":"string","description":"쿠폰 제공자","example":"토스플레이스","maxLength":128,"minLength":1},"couponNumber":{"type":["string","null"],"description":"쿠폰 번호","example":"123456","maxLength":128,"minLength":1},"balance":{"type":["integer","null"],"format":"int64","description":"쿠폰 잔액","example":1000,"minimum":0}},"required":["provider"]},"OrderChargePrice":{"type":"object","description":"주문 청구 금액","properties":{"listPrice":{"type":"integer","format":"int64","description":"원금액","example":3500},"discountAmount":{"type":"integer","format":"int64","description":"할인금액","example":-300},"tipAmount":{"type":"integer","format":"int64","description":"팁","example":0},"serviceChargeAmount":{"type":"integer","format":"int64","description":"봉사료","example":0},"taxAmount":{"type":"integer","format":"int64","description":"세액","example":291},"supplyAmount":{"type":"integer","format":"int64","description":"공급가액","example":2909},"taxExemptAmount":{"type":"integer","format":"int64","description":"면세금액","example":0},"totalAmount":{"type":"integer","format":"int64","description":"최종금액","example":3200}},"required":["discountAmount","listPrice","serviceChargeAmount","supplyAmount","taxAmount","taxExemptAmount","tipAmount","totalAmount"]},"OrderItem.Create":{"type":"object","description":"주문 생성 - 주문 상품 정보","properties":{"title":{"type":"string","description":"상품명","example":"아메리카노","minLength":1},"code":{"type":["string","null"],"description":"상품 코드"},"category":{"$ref":"#/components/schemas/OrderItemCategory.Create","description":"상품이 속한 카테고리"}},"required":["category","title"]},"OrderItemCategory.Create":{"type":"object","description":"주문 생성 - 주문 카테고리 정보","properties":{"title":{"type":"string","description":"카테고리명","example":"커피","minLength":1},"code":{"type":["string","null"],"description":"카테고리 코드"}},"required":["title"]},"OrderItemComponent.Create":{"type":"object","description":"ALPHA 주문 생성 - 콤보(세트상품) 구성","properties":{"comboTargetId":{"type":"string","description":"콤보 구성 ID","example":"42","minLength":1,"pattern":"\\d{1,19}"},"addOnPriceAmount":{"type":"integer","format":"int64","description":"구성 상품 선택 추가금","example":0},"quantity":{"type":"integer","format":"int64","description":"구성 상품 수량","example":1,"maximum":999,"minimum":1},"optionChoices":{"type":["array","null"],"description":"구성 상품에 선택한 옵션","items":{"$ref":"#/components/schemas/OrderItemOptionChoice.Create"},"maxItems":25,"minItems":0}},"required":["addOnPriceAmount","comboTargetId","quantity"]},"OrderItemOption.Create":{"type":"object","description":"주문 생성 - 주문 내역 옵션 정보","properties":{"title":{"type":"string","description":"옵션명","example":"온도","minLength":1}},"required":["title"]},"OrderItemOptionChoice.Create":{"type":"object","description":"주문 생성 - 주문 내역 옵션 선택지","properties":{"optionId":{"type":["string","null"],"description":"옵션 ID","example":"42","pattern":"\\d{1,19}"},"optionChoiceId":{"type":["string","null"],"description":"선택지 ID","example":"42","pattern":"\\d{1,19}"},"option":{"description":"옵션 정보","oneOf":[{"$ref":"#/components/schemas/OrderItemOption.Create"},{"type":"null"}]},"title":{"type":["string","null"],"description":"선택지명","example":"HOT"},"code":{"type":["string","null"],"description":"선택지 코드"},"price":{"type":"integer","format":"int64","description":"선택지 가격","example":0},"quantity":{"type":"integer","format":"int64","description":"선택지 수량","example":1,"maximum":999,"minimum":1}},"required":["price","quantity"]},"OrderItemPrice":{"type":"object","description":"카탈로그 - 상품 가격과 동일합니다. 주문 당시 시점의 정보를 제공합니다.","properties":{"title":{"type":"string","description":"가격명","example":"기본","maxLength":1000,"minLength":0},"priceType":{"type":"string","description":"가격 종류","enum":["FIXED","VARIABLE","UNIT","UNDEFINED"],"example":"FIXED"},"priceUnit":{"type":"integer","format":"int64","description":"가격 단위","example":1,"minimum":1},"priceValue":{"type":"integer","format":"int64","description":"가격","example":3000,"minimum":0},"isTaxFree":{"type":"boolean","description":"면세 여부","example":false},"taxPercentage":{"type":["integer","null"],"format":"int32","description":"세율","example":10,"maximum":100,"minimum":0},"taxInclusive":{"type":"boolean","description":"부가세 포함 여부","example":true}},"required":["isTaxFree","priceType","priceUnit","priceValue","taxInclusive","title"]},"OrderLineItem.Create":{"type":"object","description":"주문 생성 - 주문 내역","properties":{"diningOption":{"type":"string","description":"식사 옵션","enum":["HERE","TOGO","DELIVERY","PICKUP","UNDEFINED"],"example":"HERE"},"targetType":{"type":["string","null"],"description":"주문 대상 (상품, 콤보, 임의 상품) 타입","enum":["ITEM","COMBO","AD_HOC","UNDEFINED"],"example":"ITEM"},"targetId":{"type":["string","null"],"description":"상품/콤보 ID","example":"42","pattern":"\\d{1,19}"},"item":{"description":"상품 정보","oneOf":[{"$ref":"#/components/schemas/OrderItem.Create"},{"type":"null"}]},"itemComponents":{"type":["array","null"],"description":"콤보(세트상품) 구성","items":{"$ref":"#/components/schemas/OrderItemComponent.Create"},"maxItems":25,"minItems":0},"itemPrice":{"$ref":"#/components/schemas/OrderItemPrice","description":"상품 가격"},"quantity":{"type":"integer","format":"int64","description":"수량","example":1,"maximum":999,"minimum":1},"optionChoices":{"type":["array","null"],"description":"선택한 옵션","items":{"$ref":"#/components/schemas/OrderItemOptionChoice.Create"},"maxItems":25,"minItems":0},"appliedDiscounts":{"type":["array","null"],"description":"항목별 적용 할인 내역","items":{"$ref":"#/components/schemas/Discount"},"maxItems":25,"minItems":0},"memo":{"type":["string","null"],"description":"주문 내역 메모","example":"얼음 적게","maxLength":1000,"minLength":1}},"required":["diningOption","itemPrice","quantity"]},"UpdateLineItemsRequest":{"type":"object","description":"주문 내역 변경 요청","properties":{"lineItems":{"type":"array","description":"변경할 주문 내역","items":{"$ref":"#/components/schemas/OrderLineItem.Create"},"maxItems":100,"minItems":0},"discounts":{"type":["array","null"],"description":"변경할 할인 내역","items":{"$ref":"#/components/schemas/Discount"},"maxItems":25,"minItems":0},"chargePrice":{"description":"변경할 청구 금액","oneOf":[{"$ref":"#/components/schemas/OrderChargePrice"},{"type":"null"}]}},"required":["lineItems"]},"ApiResponseOrder":{"type":"object","properties":{"resultType":{"type":"string","enum":["SUCCESS","FAIL","HTTP_TIMEOUT","NETWORK_ERROR","EXECUTION_FAIL","INTERRUPTED","INTERNAL_ERROR"]},"metadata":{},"error":{"$ref":"#/components/schemas/ErrorMessage"},"success":{"$ref":"#/components/schemas/Order"}}},"Order":{"type":"object","description":"\n        주문은 매장에서 소비자가 상품을 구매하고 결제하는 것을 표현하는 개념입니다. 주문은 구매한 상품 목록, 결제 내역, 결제 금액 등 이 과정에서 기록되는 정보를 모두 포함하고 있습니다.\n        주문의 상태(orderState)와 결제 상태(paymentState)는 이 과정에서 주문에 일어날 수 있는 여러 사건을 함축하는 상태 정보입니다. 매장 현장에서 이루어지는 후불 주문은 다음과 같은 과정을 거칩니다: 손님이 테이블에 앉아 메뉴를 주문하면, 주문이 시작되어 (OPENED) 상품이 추가됩니다. 식사를 끝내고 결제를 마치면 결제 완료 상태(COMPLETED)가 됩니다.  결제가 취소되거나, 분할 결제가 일어나거나, 주문 자체가 취소되는 등 이 과정에서 다른 상태에 도달할 수 있습니다.\n    ","properties":{"id":{"type":"string","description":"주문 ID","example":"620000000000000000"},"merchantId":{"type":"integer","format":"int64","description":"매장 ID","example":42},"source":{"type":"string","description":"주문채널 (주문이 인입된 경로)","example":"POS"},"orderState":{"type":"string","description":"주문 상태","enum":["REQUESTED","OPENED","COMPLETED","CANCELLED","UNDEFINED"],"example":"OPENED"},"orderKey":{"type":"string","description":"주문 키","example":"EXT-20260512-0001"},"orderNumber":{"type":["string","null"],"description":"주문 번호","example":"A-001"},"createdAt":{"type":"string","format":"date-time","description":"생성 시각","example":"2025-09-01T00:00:00Z"},"updatedAt":{"type":"string","format":"date-time","description":"변경 시각","example":"2025-09-01T00:00:00Z"},"openedAt":{"type":["string","null"],"format":"date-time","description":"주문 수락 시각","example":"2025-09-01T00:00:00Z"},"completedAt":{"type":["string","null"],"format":"date-time","description":"주문 완료 시각","example":"2025-09-01T00:00:00Z"},"cancelledAt":{"type":["string","null"],"format":"date-time","description":"주문 취소 시각","example":"2025-09-01T00:00:00Z"},"lineItems":{"type":"array","description":"주문 항목","items":{"$ref":"#/components/schemas/OrderLineItem"}},"requestedInfo":{"description":"주문 요청 정보","oneOf":[{"$ref":"#/components/schemas/OrderRequestedInfo"},{"type":"null"}]},"memo":{"type":["string","null"],"description":"주문 메모","example":"얼음 적게"},"cancelledReason":{"type":["string","null"],"description":"주문 취소 사유","example":"고객 요청으로 인한 취소"},"payments":{"type":"array","description":"결제 내역","items":{"$ref":"#/components/schemas/Payment"}},"discounts":{"type":"array","description":"할인 내역","items":{"$ref":"#/components/schemas/Discount"}},"accruals":{"type":"array","description":"적립 내역","items":{"$ref":"#/components/schemas/OrderAccrual"}},"redemptions":{"type":"array","description":"혜택 사용 내역","items":{"$ref":"#/components/schemas/OrderRedemption"}},"chargePrice":{"$ref":"#/components/schemas/OrderChargePrice","description":"청구 금액"},"orderer":{"description":"주문자 정보","oneOf":[{"$ref":"#/components/schemas/OrderOrderer"},{"type":"null"}]}},"required":["accruals","chargePrice","createdAt","discounts","id","lineItems","merchantId","orderKey","orderState","payments","redemptions","source","updatedAt"]},"OrderAccrual":{"type":"object","description":"적립 내역","properties":{"name":{"type":"string","description":"적립명","example":"토스플레이스 적립","maxLength":128,"minLength":1},"referenceType":{"type":"string","description":"적립의 원천 구분. 멱등성 보장에 사용됩니다.","example":"TOSSPOINT","maxLength":128,"minLength":1},"referenceId":{"type":"string","description":"원천 구분 안에서 특정 적립건을 식별하는 ID. 멱등성 보장에 사용됩니다.","example":"TP-001","maxLength":128,"minLength":1},"occurredAt":{"type":"string","format":"date-time","description":"적립 발생 시각","example":"2026-01-01T00:00:00+09:00"},"pointDetails":{"description":"포인트 적립 세부 내역","oneOf":[{"$ref":"#/components/schemas/OrderAccrualPointDetails"},{"type":"null"}]},"stampDetails":{"description":"스탬프 적립 세부 내역","oneOf":[{"$ref":"#/components/schemas/OrderAccrualStampDetails"},{"type":"null"}]}},"required":["name","occurredAt","referenceId","referenceType"]},"OrderAccrualPointDetails":{"type":"object","description":"포인트 적립 상세","properties":{"provider":{"type":"string","description":"적립 제공처","example":"TOSSPLACE","maxLength":128,"minLength":1},"amount":{"type":"integer","format":"int32","description":"적립 포인트. 적립이면 양수, 회수면 음수.","example":100},"balance":{"type":["integer","null"],"format":"int32","description":"적립 후 누적 잔액","example":1000}},"required":["amount","provider"]},"OrderAccrualStampDetails":{"type":"object","description":"스탬프 적립 상세","properties":{"provider":{"type":"string","description":"적립 제공처","example":"TOSSPLACE","maxLength":128,"minLength":1},"count":{"type":"integer","format":"int32","description":"적립 스탬프 수. 적립이면 양수, 회수면 음수.","example":1},"balance":{"type":["integer","null"],"format":"int32","description":"적립 후 누적 스탬프 수","example":5}},"required":["count","provider"]},"OrderItem":{"type":"object","description":"상품","properties":{"title":{"type":"string","description":"상품명","example":"아메리카노"},"code":{"type":["string","null"],"description":"상품 코드"},"category":{"$ref":"#/components/schemas/OrderItemCategory","description":"상품이 속한 카테고리"}},"required":["category","title"]},"OrderItemCategory":{"type":"object","description":"상품 카테고리","properties":{"title":{"type":"string","description":"카테고리명","example":"커피"},"code":{"type":["string","null"],"description":"카테고리 코드"}},"required":["title"]},"OrderItemOption":{"type":"object","description":"상품 옵션","properties":{"title":{"type":"string","description":"옵션명","example":"온도"}},"required":["title"]},"OrderItemOptionChoice":{"type":"object","description":"옵션 선택지","properties":{"title":{"type":"string","description":"선택지명","example":"ICE"},"code":{"type":["string","null"],"description":"선택지 코드","example":"ICE"},"priceValue":{"type":"integer","format":"int64","description":"가격","example":500},"quantity":{"type":"integer","format":"int32","description":"수량","example":1},"option":{"description":"선택지가 속한 옵션","oneOf":[{"$ref":"#/components/schemas/OrderItemOption"},{"type":"null"}]}},"required":["priceValue","quantity","title"]},"OrderLineItem":{"type":"object","description":"주문에 포함된 개별 상품 주문 건","properties":{"diningOption":{"type":"string","description":"식사 옵션","enum":["HERE","TOGO","DELIVERY","PICKUP","UNDEFINED"],"example":"HERE"},"item":{"$ref":"#/components/schemas/OrderItem","description":"상품"},"itemPrice":{"$ref":"#/components/schemas/OrderItemPrice","description":"상품 가격"},"optionChoices":{"type":"array","description":"선택한 옵션","items":{"$ref":"#/components/schemas/OrderItemOptionChoice"}},"appliedDiscounts":{"type":"array","description":"항목별 적용 할인 내역","items":{"$ref":"#/components/schemas/Discount"}},"quantity":{"type":"integer","format":"int64","description":"수량","example":1},"memo":{"type":["string","null"],"description":"주문 내역 메모","example":"얼음 적게"}},"required":["appliedDiscounts","diningOption","item","itemPrice","optionChoices","quantity"]},"OrderOrderer":{"type":"object","description":"주문자 정보","properties":{"memberId":{"type":["string","null"],"description":"`ALPHA` 주문자 회원 식별자","example":"0123"}}},"OrderRedemption":{"type":"object","description":"혜택 사용 내역","properties":{"name":{"type":"string","description":"혜택 사용명","example":"포인트 사용","maxLength":128,"minLength":1},"referenceType":{"type":"string","description":"혜택 사용의 원천 구분. 멱등성 보장에 사용됩니다.","example":"TOSSPOINT_REDEMPTION","maxLength":128,"minLength":1},"referenceId":{"type":"string","description":"원천 구분 안에서 특정 사용건을 식별하는 ID. 멱등성 보장에 사용됩니다.","example":"TP-001","maxLength":128,"minLength":1},"occurredAt":{"type":"string","format":"date-time","description":"혜택 사용 발생 시각","example":"2026-01-01T00:00:00+09:00"},"pointDetails":{"description":"포인트 사용 세부 내역","oneOf":[{"$ref":"#/components/schemas/OrderRedemptionPointDetails"},{"type":"null"}]},"couponDetails":{"description":"쿠폰 사용 세부 내역","oneOf":[{"$ref":"#/components/schemas/OrderRedemptionCouponDetails"},{"type":"null"}]}},"required":["name","occurredAt","referenceId","referenceType"]},"OrderRedemptionCouponDetails":{"type":"object","description":"쿠폰 사용 상세","properties":{"provider":{"type":"string","description":"혜택 제공처","example":"TOSSPLACE","maxLength":128,"minLength":1},"couponNumber":{"type":["string","null"],"description":"쿠폰 번호","example":"CPN-123456"},"count":{"type":"integer","format":"int32","description":"사용 쿠폰 수. 사용이면 양수, 취소면 음수.","example":1}},"required":["count","provider"]},"OrderRedemptionPointDetails":{"type":"object","description":"포인트 사용 상세","properties":{"provider":{"type":"string","description":"혜택 제공처","example":"TOSSPLACE","maxLength":128,"minLength":1},"amount":{"type":"integer","format":"int32","description":"사용 포인트. 사용이면 양수, 취소면 음수.","example":500},"balance":{"type":["integer","null"],"format":"int32","description":"사용 후 잔액","example":500}},"required":["amount","provider"]},"OrderRequestedInfo":{"type":"object","description":"배달 또는 픽업 주문과 같이, 매장에서 수락 또는 거절할 수 있는 주문의 요청 정보","properties":{"requestedAt":{"type":["string","null"],"format":"date-time","description":"주문 요청 시각","example":"2025-09-01T00:00:00Z"},"expiredAt":{"type":["string","null"],"format":"date-time","description":"주문 요청 만료 시각","example":"2025-09-01T00:00:00Z"},"expectedReadyAt":{"type":["string","null"],"format":"date-time","description":"주문의 예상 완료 시각. 손님 기준에서의 예상 완료 시각을 의미합니다. (예: 손님이 15분 뒤 픽업 예정)","example":"2025-09-01T00:00:00Z"},"estimatedReadyAt":{"type":["string","null"],"format":"date-time","description":"주문의 예상 준비 완료 시각. 매장 기준에서의 예상 완료 시각을 의미합니다. (예: 20분 뒤 픽업 가능)","example":"2025-09-01T00:00:00Z"},"acceptedAt":{"type":["string","null"],"format":"date-time","description":"주문 수락 시각","example":"2025-09-01T00:00:00Z"},"declinedAt":{"type":["string","null"],"format":"date-time","description":"주문 거절 시각","example":"2025-09-01T00:00:00Z"},"declinedReason":{"type":["string","null"],"description":"주문 거절 사유","example":"메뉴 품절"},"declinedCode":{"type":["string","null"],"description":"주문 거절 사유 코드"},"allowedEstimatedReadyDurations":{"type":["array","null"],"description":"주문 수락 시 선택 가능한 예상 준비 완료 시간 목록 (예: 토스 POS에서 예상 준비 시간을 10분, 20분 중 하나로 선택 가능)","example":["PT10M","PT20M"],"items":{"type":"string"}}}},"Payment":{"type":"object","description":"결제","properties":{"id":{"type":"string","description":"결제 ID","example":"640000000000000000"},"merchantId":{"type":"integer","format":"int64","description":"매장 ID","example":42},"orderId":{"type":"string","description":"주문 ID","example":"620000000000000000"},"state":{"type":"string","description":"결제 상태","enum":["APPROVED","CANCELLED","UNDEFINED"],"example":"APPROVED"},"sourceType":{"type":"string","description":"결제수단 대분류","enum":["CASH","CARD","PREPAID_VALUE","ACCOUNT_TRANSFER","BARCODE","EXTERNAL","UNDEFINED"],"example":"CARD"},"paymentMethod":{"type":"string","description":"결제수단 세부 분류","example":"CARD_NFC"},"van":{"type":["string","null"],"description":"VAN","example":"NICE"},"amount":{"type":"integer","format":"int64","description":"결제금액","example":3200},"taxAmount":{"type":"integer","format":"int64","description":"세액","example":291},"supplyAmount":{"type":"integer","format":"int64","description":"공급가액","example":2909},"taxExemptAmount":{"type":"integer","format":"int64","description":"면세금액","example":0},"tipAmount":{"type":"integer","format":"int64","description":"봉사료","example":0},"approvedNo":{"type":"string","description":"승인번호","example":"00000000"},"approvedAt":{"type":["string","null"],"format":"date-time","description":"승인 시각","example":"2025-09-01T00:00:00Z"},"cancelledAt":{"type":["string","null"],"format":"date-time","description":"취소 시각","example":"2025-09-01T00:00:00Z"},"cashDetails":{"description":"현금결제 세부 내역","oneOf":[{"$ref":"#/components/schemas/PaymentCashDetails"},{"type":"null"}]},"cardDetails":{"description":"카드결제 세부 내역","oneOf":[{"$ref":"#/components/schemas/PaymentCardDetails"},{"type":"null"}]},"prepaidValueDetails":{"description":"선불지급수단 결제 세부 내역","oneOf":[{"$ref":"#/components/schemas/PaymentPrepaidValueDetails"},{"type":"null"}]},"accountTransferDetails":{"description":"계좌이체 세부 내역","oneOf":[{"$ref":"#/components/schemas/PaymentAccountTransferDetails"},{"type":"null"}]},"easyPayDetails":{"description":"간편결제 세부 내역","oneOf":[{"$ref":"#/components/schemas/PaymentEasyPayDetails"},{"type":"null"}]},"externalDetails":{"description":"외부 결제수단 상세","oneOf":[{"$ref":"#/components/schemas/PaymentExternalDetails"},{"type":"null"}]},"pgDetails":{"description":"PG사 결제 세부 내역","oneOf":[{"$ref":"#/components/schemas/PaymentPgDetails"},{"type":"null"}]},"cashReceipt":{"description":"현금영수증 세부 내역","oneOf":[{"$ref":"#/components/schemas/PaymentCashReceipt"},{"type":"null"}]},"settlement":{"description":"정산 관련 정보","oneOf":[{"$ref":"#/components/schemas/PaymentSettlement"},{"type":"null"}]},"bundle":{"description":"결제 번들 정보","oneOf":[{"$ref":"#/components/schemas/PaymentBundle"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","description":"생성 시각","example":"2025-09-01T00:00:00Z"},"updatedAt":{"type":"string","format":"date-time","description":"변경 시각","example":"2025-09-01T00:00:00Z"}},"required":["amount","approvedNo","createdAt","id","merchantId","orderId","paymentMethod","sourceType","state","supplyAmount","taxAmount","taxExemptAmount","tipAmount","updatedAt"]},"PaymentAccountTransferDetails":{"type":"object","description":"계좌이체 상세","properties":{"bankCode":{"type":["integer","null"],"format":"int32","description":"은행 코드","example":20},"accountNumber":{"type":["string","null"],"description":"계좌번호 (마스킹 적용)","example":"110-***-******","maxLength":128,"minLength":1}}},"PaymentBundle":{"type":"object","description":"결제 번들","properties":{"key":{"type":"string","description":"번들 식별자. 같은 값을 갖는 결제들이 하나의 번들로 묶입니다.","example":"BDL-001","maxLength":128,"minLength":1}},"required":["key"]},"PaymentCardDetails":{"type":"object","description":"카드결제 상세","properties":{"cardType":{"type":["string","null"],"description":"카드 종류","enum":["CREDIT","DEBIT","PREPAID","FOREIGN","UNDEFINED"],"example":"CREDIT"},"cardBrand":{"type":["string","null"],"description":"발급사명","maxLength":128,"minLength":1},"cardNo":{"type":["string","null"],"description":"카드번호 (마스킹 적용)","example":"00000000********","maxLength":128,"minLength":1},"cardBrandId":{"type":["string","null"],"description":"발급사 코드","maxLength":128,"minLength":1},"acquirer":{"type":["string","null"],"description":"매입사명","maxLength":128,"minLength":1},"acquirerId":{"type":["string","null"],"description":"매입사 코드","maxLength":128,"minLength":1},"balance":{"type":["integer","null"],"format":"int64","description":"잔액","minimum":0},"van":{"type":["string","null"],"description":"VAN","example":"NICE","maxLength":128,"minLength":1},"approvalNo":{"type":["string","null"],"description":"승인번호","example":"12345678","maxLength":128,"minLength":1},"amount":{"type":["integer","null"],"format":"int64","description":"결제 금액","example":3200,"minimum":0},"installmentMonth":{"type":["string","null"],"description":"할부개월 수","example":"00","maxLength":128,"minLength":1}}},"PaymentCashDetails":{"type":"object","description":"현금결제 상세","properties":{"buyerSuppliedAmount":{"type":["integer","null"],"format":"int64","description":"고객이 지불한 금액","example":5000,"minimum":0},"changeBackAmount":{"type":["integer","null"],"format":"int64","description":"거스름돈","example":1000,"minimum":0}}},"PaymentCashReceipt":{"type":"object","description":"현금영수증 상세","properties":{"issuerType":{"type":"string","description":"발급 종류","enum":["CONSUMER","BUSINESSES","UNDEFINED"],"example":"CONSUMER"},"issuanceType":{"type":"string","description":"발급 방법","enum":["PHONE","BUSINESS_NUMBER","CARD","UNDEFINED"],"example":"PHONE"},"identityNumber":{"type":"string","description":"발급 방법에 해당하는 식별번호 (휴대전화 번호 / 사업자번호 / 카드 번호)","example":"**********","maxLength":128,"minLength":0},"selfIssuance":{"type":"boolean","description":"자진 발급 여부","example":true},"issueNumber":{"type":"string","description":"발급 번호","example":"0000000000","maxLength":128,"minLength":0},"issuedAt":{"type":["string","null"],"format":"date-time","description":"발급 시각","example":"2025-09-01T00:00:00Z"},"amount":{"type":["integer","null"],"format":"int64","description":"발급 금액","example":3200,"minimum":0}},"required":["identityNumber","issuanceType","issueNumber","issuerType","selfIssuance"]},"PaymentEasyPayDetails":{"type":"object","description":"간편결제 상세","properties":{"provider":{"type":["string","null"],"description":"간편결제 제공사","example":"토스페이","maxLength":128,"minLength":1},"acquirer":{"type":["string","null"],"description":"매입사","example":"토스머니","maxLength":128,"minLength":1},"acquirerId":{"type":["string","null"],"description":"매입사 코드","example":"TS","maxLength":128,"minLength":1},"payType":{"type":["string","null"],"description":"간편결제에 연결된 결제 수단 종류","enum":["ACCOUNT","CARD","UNDEFINED"],"example":"ACCOUNT"},"amount":{"type":["integer","null"],"format":"int64","description":"결제 금액","example":3200,"minimum":0}}},"PaymentExternalDetails":{"type":"object","description":"외부 결제수단 상세","properties":{"source":{"type":["string","null"],"description":"결제수단명","example":"모바일 상품권"}}},"PaymentPgDetails":{"type":"object","description":"PG사 결제 상세","properties":{"provider":{"type":["string","null"],"description":"PG 벤더명","example":"토스페이먼츠","maxLength":128,"minLength":1},"transactionId":{"type":["string","null"],"description":"PG 거래 ID","example":"12345","maxLength":128,"minLength":1}}},"PaymentPrepaidValueDetails":{"type":"object","description":"선불지급수단 결제 상세","properties":{"provider":{"type":["string","null"],"description":"선불지급수단 제공사","maxLength":128,"minLength":1},"code":{"type":["string","null"],"description":"선불지급수단 코드 (상품권번호 등)","maxLength":128,"minLength":1},"amount":{"type":["integer","null"],"format":"int64","description":"사용 금액","example":3200,"minimum":0}}},"PaymentSettlement":{"type":"object","description":"결제 정산 정보","properties":{"settlementType":{"type":"string","description":"정산 주체 종류","enum":["ACQUIRER","PG","UNDEFINED"],"example":"ACQUIRER"},"settlementSubject":{"type":"string","description":"정산 주체","maxLength":128,"minLength":1}},"required":["settlementSubject","settlementType"]},"Payment.Create":{"type":"object","description":"결제 내역 생성","properties":{"approvedNo":{"type":["string","null"],"description":"승인 번호","example":"00000000","maxLength":128,"minLength":0},"approvedAt":{"type":"string","format":"date-time","description":"승인 시각","example":"2025-09-01T00:00:00Z"},"amount":{"type":"integer","format":"int64","description":"결제 금액","example":5000,"minimum":0},"taxAmount":{"type":"integer","format":"int64","description":"세액","example":454,"minimum":0},"supplyAmount":{"type":"integer","format":"int64","description":"공급가액","example":4546,"minimum":0},"taxExemptAmount":{"type":"integer","format":"int64","description":"면세금액","example":0,"minimum":0},"tipAmount":{"type":"integer","format":"int64","description":"봉사료","example":0,"minimum":0},"cashDetails":{"description":"현금결제 세부 내역","oneOf":[{"$ref":"#/components/schemas/PaymentCashDetails"},{"type":"null"}]},"cardDetails":{"description":"카드결제 세부 내역","oneOf":[{"$ref":"#/components/schemas/PaymentCardDetails"},{"type":"null"}]},"prepaidValueDetails":{"description":"선불지급수단 결제 세부 내역","oneOf":[{"$ref":"#/components/schemas/PaymentPrepaidValueDetails"},{"type":"null"}]},"accountTransferDetails":{"description":"계좌이체 세부 내역","oneOf":[{"$ref":"#/components/schemas/PaymentAccountTransferDetails"},{"type":"null"}]},"easyPayDetails":{"description":"간편결제 세부 내역","oneOf":[{"$ref":"#/components/schemas/PaymentEasyPayDetails"},{"type":"null"}]},"pgDetails":{"description":"PG사 결제 세부 내역","oneOf":[{"$ref":"#/components/schemas/PaymentPgDetails"},{"type":"null"}]},"cashReceipt":{"description":"현금영수증 세부 내역","oneOf":[{"$ref":"#/components/schemas/PaymentCashReceipt"},{"type":"null"}]},"settlement":{"description":"정산 관련 정보","oneOf":[{"$ref":"#/components/schemas/PaymentSettlement"},{"type":"null"}]},"bundle":{"description":"결제 번들","oneOf":[{"$ref":"#/components/schemas/PaymentBundle"},{"type":"null"}]}},"required":["amount","approvedAt","supplyAmount","taxAmount","taxExemptAmount","tipAmount"]},"PaymentCreateRequest":{"type":"object","description":"승인된 결제 기록 요청","properties":{"orderId":{"type":"string","description":"주문 ID","example":"620000000000000000","minLength":1},"payment":{"$ref":"#/components/schemas/Payment.Create","description":"결제 내역"}},"required":["orderId","payment"]},"ApiResponsePayment":{"type":"object","properties":{"resultType":{"type":"string","enum":["SUCCESS","FAIL","HTTP_TIMEOUT","NETWORK_ERROR","EXECUTION_FAIL","INTERRUPTED","INTERNAL_ERROR"]},"metadata":{},"error":{"$ref":"#/components/schemas/ErrorMessage"},"success":{"$ref":"#/components/schemas/Payment"}}},"PaymentCancel":{"type":"object","description":"취소된 결제 기록","properties":{"cancelledAt":{"type":"string","format":"date-time","description":"취소 시각","example":"2025-09-01T00:00:00Z"}},"required":["cancelledAt"]},"Delivery.Create":{"type":"object","description":"배달 정보 생성 요청","properties":{"type":{"type":["string","null"],"description":"배달 주문 유형","example":"DELIVERY"},"serviceName":{"type":["string","null"],"description":"배달 서비스명","example":"토스배달"},"deliveryType":{"type":["string","null"],"description":"배달 유형","example":"DELIVERY_COMPANY"},"deliveryName":{"type":["string","null"],"description":"배달 유형명","example":"토스배달"},"status":{"type":"string","description":"배달 상태","enum":["NEW","ACCEPTED","REJECTED","PARTIALLY_CANCELLED","CANCELLED","RIDER_ASSIGNED","RIDER_ARRIVE_SOON","RIDER_PICKUP_COMPLETED","DONE","UNDEFINED"],"example":"NEW"},"store":{"description":"배달사에서 제공한 매장 정보","oneOf":[{"$ref":"#/components/schemas/DeliveryStore"},{"type":"null"}]},"recipient":{"description":"배달사에서 제공한 주문자 정보","oneOf":[{"$ref":"#/components/schemas/DeliveryRecipient"},{"type":"null"}]},"paymentMethod":{"type":["string","null"],"description":"결제 방법","example":"만나서 카드결제"},"customerChargedPrice":{"type":"integer","format":"int64","description":"고객 부담 금액","example":10000,"minimum":0},"customerAppliedDiscounts":{"type":["array","null"],"description":"플랫폼 할인 정보","items":{"$ref":"#/components/schemas/DeliveryCustomerAppliedDiscount"}},"origin":{"type":["string","null"],"description":"원산지 표기 정보","example":"커피원두: 브라질산"},"preparationTimeMinutes":{"type":["integer","null"],"format":"int32","description":"준비 시간 (분)","example":10},"reservedAt":{"type":["string","null"],"format":"date-time","description":"예약 시각","example":"2025-09-01T00:00:00Z"},"memo":{"type":["string","null"],"description":"요청사항","example":"문 앞에 두고 벨 눌러주세요."}},"required":["customerChargedPrice","status"]},"DeliveryCustomerAppliedDiscount":{"type":"object","description":"플랫폼 할인 정보","properties":{"type":{"type":["string","null"],"description":"할인 종류","example":"DELIVERY_FEE"},"title":{"type":["string","null"],"description":"할인명","example":"배달료"},"amount":{"type":["integer","null"],"format":"int64","description":"할인 금액","example":1000}}},"DeliveryRecipient":{"type":"object","description":"배달 주문자 정보","properties":{"contact":{"type":["string","null"],"description":"연락처","example":"05000000000"},"lotNumberAddress":{"type":["string","null"],"description":"지번 주소","example":"서울특별시 서초구 서초동 1303-34"},"roadNameAddress":{"type":["string","null"],"description":"도로명 주소","example":"서울특별시 서초구 강남대로 459 (서초동)"}}},"DeliveryStore":{"type":"object","description":"배달 매장 정보","properties":{"key":{"type":["string","null"],"description":"매장 식별자","example":"store-1234567890"},"name":{"type":["string","null"],"description":"매장명","example":"플레이스 베이커리"}}},"Order.Create":{"type":"object","description":"주문 생성 요청","properties":{"orderKey":{"type":"string","description":"주문 키","example":"EXT-20260512-0001","maxLength":128,"minLength":0},"orderNumber":{"type":"string","description":"주문 번호","example":"A-001","maxLength":64,"minLength":0},"lineItems":{"type":"array","description":"주문 내역","items":{"$ref":"#/components/schemas/OrderLineItem.Create"},"maxItems":100,"minItems":0},"discounts":{"type":["array","null"],"description":"할인 내역","items":{"$ref":"#/components/schemas/Discount"},"maxItems":25,"minItems":0},"accruals":{"type":["array","null"],"description":"적립 내역","items":{"$ref":"#/components/schemas/OrderAccrual"},"maxItems":100,"minItems":0},"redemptions":{"type":["array","null"],"description":"혜택 사용 내역","items":{"$ref":"#/components/schemas/OrderRedemption"},"maxItems":100,"minItems":0},"chargePrice":{"$ref":"#/components/schemas/OrderChargePrice","description":"청구 금액"},"requestedInfo":{"description":"주문 요청 정보","oneOf":[{"$ref":"#/components/schemas/OrderRequestedInfo.Create"},{"type":"null"}]},"orderer":{"description":"주문자 정보","oneOf":[{"$ref":"#/components/schemas/OrderOrderer.Create"},{"type":"null"}]},"scheduled":{"description":"주문 자동 처리 정보","oneOf":[{"$ref":"#/components/schemas/OrderScheduled"},{"type":"null"}]},"memo":{"type":["string","null"],"description":"주문 메모","example":"얼음 적게","maxLength":1000,"minLength":1},"openedAt":{"type":["string","null"],"format":"date-time","description":"주문 시작 시각","example":"2025-09-01T00:00:00Z"}},"required":["chargePrice","lineItems","orderKey","orderNumber"]},"OrderCreateRequest":{"type":"object","description":"주문 생성 API 요청","properties":{"order":{"$ref":"#/components/schemas/Order.Create","description":"주문 생성 요청"},"payments":{"type":"array","description":"결제 내역 생성 요청","items":{"$ref":"#/components/schemas/Payment.Create"},"maxItems":25,"minItems":0},"delivery":{"description":"배달 정보 생성 요청","oneOf":[{"$ref":"#/components/schemas/Delivery.Create"},{"type":"null"}]}},"required":["order","payments"]},"OrderOrderer.Create":{"type":"object","description":"주문자 정보","properties":{"name":{"type":["string","null"],"description":"주문자명","example":"김토스","maxLength":128,"minLength":1},"phoneNumber":{"type":["string","null"],"description":"주문자 전화번호","example":"01000000000","maxLength":128,"minLength":1},"nickname":{"type":["string","null"],"description":"주문자 별명","example":"김토스","maxLength":128,"minLength":1},"memberId":{"type":["string","null"],"description":"주문자 회원 식별자","example":"0123","maxLength":128,"minLength":1}}},"OrderRequestedInfo.Create":{"type":"object","description":"주문 생성 - 주문 요청 정보","properties":{"requestedAt":{"type":["string","null"],"format":"date-time","description":"주문 요청 시각","example":"2025-09-01T00:00:00Z"},"expiredAt":{"type":["string","null"],"format":"date-time","description":"주문 요청 만료 시각","example":"2025-09-01T00:00:00Z"},"expectedReadyAt":{"type":["string","null"],"format":"date-time","description":"주문의 예상 완료 시각. 손님 기준에서의 예상 완료 시각을 의미합니다. (예: 손님이 15분 뒤 픽업 예정)","example":"2025-09-01T00:00:00Z"},"estimatedReadyAt":{"type":["string","null"],"format":"date-time","description":"주문의 예상 준비 완료 시각. 매장 기준에서의 예상 완료 시각을 의미합니다. (예: 20분 뒤 픽업 가능)","example":"2025-09-01T00:00:00Z"},"allowedEstimatedReadyDurations":{"type":["array","null"],"description":"주문 수락 시 선택 가능한 예상 준비 완료 시간 목록 (예: 토스 POS에서 예상 준비 시간을 10분, 20분 중 하나로 선택 가능)","example":["PT10M","PT20M"],"items":{"type":"string"}}},"required":["expiredAt","requestedAt"]},"OrderScheduled":{"type":"object","description":"주문 자동 처리 정보","properties":{"completion":{"description":"주문 자동 완료 처리 정책","oneOf":[{"$ref":"#/components/schemas/OrderScheduledCompletion"},{"type":"null"}]}}},"OrderScheduledCompletion":{"type":"object","description":"주문 자동 완료 처리 정책","properties":{"triggerAt":{"type":"string","format":"date-time","description":"주문 자동 완료 처리 설정 시각. 주문은 해당 시각에 자동 완료 처리됩니다.","example":"2025-09-01T00:00:00Z"}},"required":["triggerAt"]},"OrderRedemptionsCreateRequest":{"type":"object","description":"혜택 사용 추가 요청","properties":{"redemptions":{"type":"array","description":"추가할 혜택 사용 내역 목록","items":{"$ref":"#/components/schemas/OrderRedemption"},"maxItems":100,"minItems":1}},"required":["redemptions"]},"OrderDeclineRequest":{"type":"object","description":"주문 거절 요청","properties":{"declinedAt":{"type":["string","null"],"format":"date-time","description":"주문 거절 시각","example":"2025-09-01T00:00:00Z"},"declinedReason":{"type":["string","null"],"description":"주문 거절 사유","example":"메뉴 품절","maxLength":1000,"minLength":0},"declinedCode":{"type":["string","null"],"description":"주문 거절 사유 코드. 예: CUSTOMER_REQUEST, MENU_SOLD_OUT, COOKING_DELAY, REQUEST_UNAVAILABLE","example":"MENU_SOLD_OUT","maxLength":1000,"minLength":0}}},"OrderCancelRequest":{"type":"object","description":"주문 취소 요청","properties":{"cancelledReason":{"type":["string","null"],"description":"주문 취소 사유","example":"고객 요청으로 인한 취소","maxLength":1000,"minLength":0}}},"OrderAccrualsCreateRequest":{"type":"object","description":"적립 추가 요청","properties":{"accruals":{"type":"array","description":"추가할 적립 내역 목록","items":{"$ref":"#/components/schemas/OrderAccrual"},"maxItems":100,"minItems":1}},"required":["accruals"]},"OrderAcceptRequest":{"type":"object","description":"주문 수락 요청","properties":{"acceptedAt":{"type":["string","null"],"format":"date-time","description":"주문 수락 시각","example":"2025-09-01T00:00:00Z"},"estimatedReadyAt":{"type":["string","null"],"format":"date-time","description":"예상 준비 완료 시각. 매장 기준에서의 준비 완료 시각을 의미합니다. (예: 20분 뒤 픽업 가능)","example":"2025-09-01T00:20:00Z"}}},"DiscountPolicyAutoApplyRequest":{"type":"object","description":"할인 정책 자동 적용 요청","properties":{"itemId":{"type":["string","null"],"description":"상품 ID\n\n상품은 할인 정책의 자동 적용 대상 (DiscountAutoApplyTarget) 에 따라 할인이 적용됩니다. 상품 또는 상품이 속한 카테고리를 대상으로 하는 할인 정책이 자동 적용됩니다.","example":"42"}}},"DiscountPolicyBatchAutoApplyRequest":{"type":"object","description":"할인 정책 자동 적용 묶음 요청","properties":{"batch":{"type":"array","description":"묶음 요청 (최대 100건)","items":{"$ref":"#/components/schemas/DiscountPolicyAutoApplyRequest"}}},"required":["batch"]},"ApiResponseListListDiscountPolicy":{"type":"object","properties":{"resultType":{"type":"string","enum":["SUCCESS","FAIL","HTTP_TIMEOUT","NETWORK_ERROR","EXECUTION_FAIL","INTERRUPTED","INTERNAL_ERROR"]},"metadata":{},"error":{"$ref":"#/components/schemas/ErrorMessage"},"success":{"type":"array","items":{"type":"array","items":{"$ref":"#/components/schemas/DiscountPolicy"}}}}},"DiscountAutoApply":{"type":"object","description":"할인 자동 적용 규칙","properties":{"condition":{"$ref":"#/components/schemas/DiscountAutoApplyCondition","description":"할인 자동 적용 조건"},"targets":{"type":["array","null"],"description":"할인 자동 적용 대상","items":{"$ref":"#/components/schemas/DiscountAutoApplyTarget"}}},"required":["condition"]},"DiscountAutoApplyCondition":{"type":"object","description":"할인 자동 적용 조건","properties":{"appliedToAll":{"type":"boolean","description":"모든 주문에 할인 적용 여부","example":true},"diningOptions":{"type":["array","null"],"description":"할인을 적용할 식사 옵션 (매장 식사, 포장 등)","example":["HERE","TOGO"],"items":{"type":"string","description":"주문 식사 옵션","enum":["HERE","TOGO","DELIVERY","PICKUP","UNDEFINED"]}},"schedule":{"description":"할인 자동 적용 스케줄","oneOf":[{"$ref":"#/components/schemas/DiscountAutoApplySchedule"},{"type":"null"}]}},"required":["appliedToAll"]},"DiscountAutoApplyDateRange":{"type":"object","description":"할인 자동 적용 기간 (inclusive)","properties":{"start":{"type":"string","format":"date","description":"시작일","example":"2025-09-01"},"end":{"type":"string","format":"date","description":"종료일","example":"2025-09-30"}},"required":["end","start"]},"DiscountAutoApplySchedule":{"type":"object","description":"할인 자동 적용 스케줄","properties":{"dayOfWeeks":{"type":["array","null"],"description":"할인 자동 적용 요일","example":["SATURDAY","SUNDAY"],"items":{"type":"string"}},"dateRange":{"description":"할인 자동 적용 기간 (inclusive)","oneOf":[{"$ref":"#/components/schemas/DiscountAutoApplyDateRange"},{"type":"null"}]},"timeRange":{"description":"할인 자동 적용 시간대 (inclusive)","oneOf":[{"$ref":"#/components/schemas/DiscountAutoApplyTimeRange"},{"type":"null"}]}}},"DiscountAutoApplyTarget":{"type":"object","description":"할인 적용 대상","properties":{"targetType":{"type":"string","description":"할인 적용 대상 종류 (카테고리, 상품)","enum":["ITEM","CATEGORY","UNDEFINED"],"example":"ITEM"},"targetId":{"type":"string","description":"할인 적용 대상 ID","example":"42"}},"required":["targetId","targetType"]},"DiscountAutoApplyTimeRange":{"type":"object","description":"할인 자동 적용 시간대 (inclusive)","properties":{"start":{"type":"string","format":"time-local","description":"시작 시간","example":"10:00:00"},"end":{"type":"string","format":"time-local","description":"종료 시간","example":"17:59:59"}},"required":["end","start"]},"DiscountPolicy":{"type":"object","description":"할인 정책","properties":{"id":{"type":"string","description":"할인 정책 ID","example":"42"},"title":{"type":"string","description":"할인명","example":"PROMOTION"},"type":{"type":"string","description":"할인 종류 (예: \"FIXED_AMOUNT\", \"FIXED_PERCENTAGE\")","example":"FIXED_AMOUNT"},"code":{"type":["string","null"],"description":"할인 코드","example":"PROMOTION_00"},"amount":{"type":"integer","format":"int64","description":"정액할인 금액 (정액할인이 아닌 경우 0)","example":1000},"percentage":{"type":"number","format":"double","description":"정률할인 비율 (정률할인이 아닌 경우 0.0)","example":0.0},"maxAmount":{"type":["integer","null"],"format":"int64","description":"최대 할인 금액","example":3000},"autoApply":{"description":"할인 자동 적용 규칙","oneOf":[{"$ref":"#/components/schemas/DiscountAutoApply"},{"type":"null"}]}},"required":["amount","id","percentage","title","type"]},"ApiResponseListDiscountPolicy":{"type":"object","properties":{"resultType":{"type":"string","enum":["SUCCESS","FAIL","HTTP_TIMEOUT","NETWORK_ERROR","EXECUTION_FAIL","INTERRUPTED","INTERNAL_ERROR"]},"metadata":{},"error":{"$ref":"#/components/schemas/ErrorMessage"},"success":{"type":"array","items":{"$ref":"#/components/schemas/DiscountPolicy"}}}},"DeliveryCreateRequest":{"type":"object","description":"배달 정보 등록 요청","properties":{"orderId":{"type":"string","description":"주문 ID","example":"620000000000000000","minLength":1},"delivery":{"$ref":"#/components/schemas/Delivery.Create","description":"배달 정보 생성 요청"}},"required":["delivery","orderId"]},"ApiResponseDelivery":{"type":"object","properties":{"resultType":{"type":"string","enum":["SUCCESS","FAIL","HTTP_TIMEOUT","NETWORK_ERROR","EXECUTION_FAIL","INTERRUPTED","INTERNAL_ERROR"]},"metadata":{},"error":{"$ref":"#/components/schemas/ErrorMessage"},"success":{"$ref":"#/components/schemas/Delivery"}}},"Delivery":{"type":"object","description":"배달 정보","properties":{"id":{"type":"string","description":"배달 정보 ID","example":"42"},"merchantId":{"type":"integer","format":"int64","description":"매장 ID","example":42},"orderId":{"type":"string","description":"주문 ID","example":"620000000000000000"},"type":{"type":["string","null"],"description":"배달 주문 유형","example":"DELIVERY"},"serviceName":{"type":["string","null"],"description":"배달 서비스명","example":"토스배달"},"deliveryType":{"type":["string","null"],"description":"배달 유형","example":"DELIVERY_COMPANY"},"deliveryName":{"type":["string","null"],"description":"배달 유형명","example":"토스배달"},"status":{"type":"string","description":"배달 상태","enum":["NEW","ACCEPTED","REJECTED","PARTIALLY_CANCELLED","CANCELLED","RIDER_ASSIGNED","RIDER_ARRIVE_SOON","RIDER_PICKUP_COMPLETED","DONE","UNDEFINED"],"example":"ACCEPTED"},"store":{"description":"배달사에서 제공한 매장 정보","oneOf":[{"$ref":"#/components/schemas/DeliveryStore"},{"type":"null"}]},"recipient":{"description":"배달사에서 제공한 주문자 정보","oneOf":[{"$ref":"#/components/schemas/DeliveryRecipient"},{"type":"null"}]},"paymentMethod":{"type":["string","null"],"description":"결제 방법","example":"만나서 카드결제"},"customerChargedPrice":{"type":"integer","format":"int64","description":"고객 부담 금액","example":10000},"customerAppliedDiscounts":{"type":["array","null"],"description":"플랫폼 할인 정보","items":{"$ref":"#/components/schemas/DeliveryCustomerAppliedDiscount"}},"origin":{"type":["string","null"],"description":"원산지 표기 정보","example":"커피원두: 브라질산"},"preparationTimeMinutes":{"type":["integer","null"],"format":"int32","description":"준비 시간 (분)","example":10},"reservedAt":{"type":["string","null"],"format":"date-time","description":"예약 시각","example":"2025-09-01T00:00:00Z"},"memo":{"type":["string","null"],"description":"요청사항","example":"문 앞에 두고 벨 눌러주세요."}},"required":["customerChargedPrice","id","merchantId","orderId","status"]},"DataExport.Create":{"type":"object","description":"데이터 추출 요청","properties":{"datasets":{"type":"array","description":"추출 데이터셋 목록","example":["MERCHANTS"],"items":{"type":"string","description":"데이터셋","enum":["MERCHANTS","CATALOG_CATEGORIES","CATALOG_ITEMS","CATALOG_OPTIONS","CATALOG_OPTION_CHOICES","CATALOG_ITEM_OPTIONS","ORDERS","ORDER_LINE_ITEMS","ORDER_LINE_ITEM_OPTION_CHOICES","ORDER_DISCOUNTS","PAYMENTS","UNDEFINED"]}},"idempotencyKey":{"type":["string","null"],"description":"요청 중복 방지 식별자","example":"export-20261001-0001"},"merchantIds":{"description":"추출 대상 매장 ID","example":{"include":[42]},"oneOf":[{"$ref":"#/components/schemas/com.tossplace.openapi.dto.v1.dto.dataexport.DataExportCreate.MerchantIds"},{"type":"null"}]},"schemaVersion":{"type":["string","null"],"description":"추출 결과 스키마 버전","example":"2026-10-01"},"from":{"type":["string","null"],"format":"date-time","description":"조회 범위 시작점","example":"2026-10-01T00:00:00Z"},"to":{"type":["string","null"],"format":"date-time","description":"조회 범위 종료점","example":"2026-10-01T00:00:00Z"},"format":{"type":["string","null"],"description":"추출 결과 형식","enum":["CSV","UNDEFINED"],"example":"CSV"}},"required":["datasets"]},"DataExportCreateRequest":{"type":"object","description":"데이터 추출 요청","properties":{"export":{"$ref":"#/components/schemas/DataExport.Create","description":"데이터 추출 요청"}},"required":["export"]},"com.tossplace.openapi.dto.v1.dto.dataexport.DataExportCreate.MerchantIds":{"type":"object","description":"추출 대상 매장 ID","properties":{"include":{"type":["array","null"],"description":"추출할 매장 ID 목록","example":[42],"items":{"type":"integer","format":"int64"},"maxItems":1000,"minItems":0},"exclude":{"type":["array","null"],"description":"제외할 매장 ID 목록","example":[42],"items":{"type":"integer","format":"int64"},"maxItems":1000,"minItems":0}}},"ApiResponseDataExport":{"type":"object","properties":{"resultType":{"type":"string","enum":["SUCCESS","FAIL","HTTP_TIMEOUT","NETWORK_ERROR","EXECUTION_FAIL","INTERRUPTED","INTERNAL_ERROR"]},"metadata":{},"error":{"$ref":"#/components/schemas/ErrorMessage"},"success":{"$ref":"#/components/schemas/DataExport"}}},"DataExport":{"type":"object","description":"데이터 추출","properties":{"requestId":{"type":"string","description":"요청 ID","example":"d290f1ee-6c54-4b01-90e6-d701748f0851"},"datasets":{"type":"array","description":"추출 데이터셋 목록","example":["MERCHANTS"],"items":{"type":"string","description":"데이터셋","enum":["MERCHANTS","CATALOG_CATEGORIES","CATALOG_ITEMS","CATALOG_OPTIONS","CATALOG_OPTION_CHOICES","CATALOG_ITEM_OPTIONS","ORDERS","ORDER_LINE_ITEMS","ORDER_LINE_ITEM_OPTION_CHOICES","ORDER_DISCOUNTS","PAYMENTS","UNDEFINED"]}},"idempotencyKey":{"type":["string","null"],"description":"요청 중복 방지 식별자","example":"export-20261001-0001"},"from":{"type":["string","null"],"format":"date-time","description":"조회 범위 시작점","example":"2026-10-01T00:00:00Z"},"to":{"type":["string","null"],"format":"date-time","description":"조회 범위 종료점","example":"2026-10-01T00:00:00Z"},"format":{"type":"string","description":"추출 결과 형식","enum":["CSV","UNDEFINED"],"example":"CSV"},"schemaVersion":{"type":"string","description":"추출 결과 스키마 버전","example":"2026-10-01"},"state":{"type":"string","description":"요청 처리 상태","enum":["REQUESTED","RUNNING","COMPLETED","FAILED","CANCELLED","EXPIRED","UNDEFINED"],"example":"RUNNING"},"files":{"type":["array","null"],"description":"추출 결과 파일 목록","items":{"$ref":"#/components/schemas/DataExportFile"}},"requestedAt":{"type":"string","format":"date-time","description":"요청 시각","example":"2026-10-01T00:00:00Z"},"expiresAt":{"type":"string","format":"date-time","description":"요청 만료 시각","example":"2026-10-01T00:00:00Z"},"completedAt":{"type":["string","null"],"format":"date-time","description":"요청 완료 시각","example":"2026-10-01T00:00:00Z"},"failedAt":{"type":["string","null"],"format":"date-time","description":"요청 실패 시각","example":"2026-10-01T00:00:00Z"},"cancelledAt":{"type":["string","null"],"format":"date-time","description":"요청 취소 시각","example":"2026-10-01T00:00:00Z"}},"required":["datasets","expiresAt","format","requestId","requestedAt","schemaVersion","state"]},"DataExportFile":{"type":"object","description":"데이터 추출 결과 파일","properties":{"fileKey":{"type":"string","description":"파일 식별자"},"dataset":{"type":"string","description":"결과가 속한 데이터셋","enum":["MERCHANTS","CATALOG_CATEGORIES","CATALOG_ITEMS","CATALOG_OPTIONS","CATALOG_OPTION_CHOICES","CATALOG_ITEM_OPTIONS","ORDERS","ORDER_LINE_ITEMS","ORDER_LINE_ITEM_OPTION_CHOICES","ORDER_DISCOUNTS","PAYMENTS","UNDEFINED"],"example":"MERCHANTS"},"filename":{"type":"string","description":"파일명"},"format":{"type":"string","description":"파일 형식","enum":["CSV","UNDEFINED"],"example":"CSV"},"size":{"type":["integer","null"],"format":"int64","description":"파일 크기 (bytes)","example":1000000},"rowCount":{"type":["integer","null"],"format":"int64","description":"파일에 속한 레코드 수","example":100}},"required":["dataset","fileKey","filename","format"]},"ApiResponseDataExportFileDownload":{"type":"object","properties":{"resultType":{"type":"string","enum":["SUCCESS","FAIL","HTTP_TIMEOUT","NETWORK_ERROR","EXECUTION_FAIL","INTERRUPTED","INTERNAL_ERROR"]},"metadata":{},"error":{"$ref":"#/components/schemas/ErrorMessage"},"success":{"$ref":"#/components/schemas/DataExportFileDownload"}}},"DataExportFileDownload":{"type":"object","description":"데이터 추출 결과 파일 다운로드 링크","properties":{"url":{"type":"string","description":"파일 다운로드 링크"},"expiresAt":{"type":"string","format":"date-time","description":"링크 만료 시각","example":"2026-10-01T00:00:00Z"}},"required":["expiresAt","url"]},"Delivery.Patch":{"type":"object","description":"배달 정보 수정 요청","properties":{"type":{"type":["string","null"],"description":"배달 주문 유형","example":"DELIVERY"},"serviceName":{"type":["string","null"],"description":"배달 서비스명","example":"토스배달"},"deliveryType":{"type":["string","null"],"description":"배달 유형","example":"DELIVERY_COMPANY"},"deliveryName":{"type":["string","null"],"description":"배달 유형명","example":"토스배달"},"status":{"type":["string","null"],"description":"배달 상태","enum":["NEW","ACCEPTED","REJECTED","PARTIALLY_CANCELLED","CANCELLED","RIDER_ASSIGNED","RIDER_ARRIVE_SOON","RIDER_PICKUP_COMPLETED","DONE","UNDEFINED"],"example":"ACCEPTED"},"store":{"description":"배달사에서 제공한 매장 정보","oneOf":[{"$ref":"#/components/schemas/DeliveryStore"},{"type":"null"}]},"recipient":{"description":"배달사에서 제공한 주문자 정보","oneOf":[{"$ref":"#/components/schemas/DeliveryRecipient"},{"type":"null"}]},"paymentMethod":{"type":["string","null"],"description":"결제 방법","example":"만나서 카드결제"},"customerChargedPrice":{"type":["integer","null"],"format":"int64","description":"고객 부담 금액","example":10000,"minimum":0},"customerAppliedDiscounts":{"type":["array","null"],"description":"플랫폼 할인 정보","items":{"$ref":"#/components/schemas/DeliveryCustomerAppliedDiscount"}},"origin":{"type":["string","null"],"description":"원산지 표기 정보","example":"커피원두: 브라질산"},"preparationTimeMinutes":{"type":["integer","null"],"format":"int32","description":"준비 시간 (분)","example":10},"reservedAt":{"type":["string","null"],"format":"date-time","description":"예약 시각","example":"2025-09-01T00:00:00Z"},"memo":{"type":["string","null"],"description":"요청사항","example":"벨 누르지 말아주세요."}}},"DeliveryPatchRequest":{"type":"object","description":"배달 정보 수정 요청","properties":{"delivery":{"$ref":"#/components/schemas/Delivery.Patch","description":"배달 정보 수정 요청"}},"required":["delivery"]},"ApiResponseVersion":{"type":"object","properties":{"resultType":{"type":"string","enum":["SUCCESS","FAIL","HTTP_TIMEOUT","NETWORK_ERROR","EXECUTION_FAIL","INTERRUPTED","INTERNAL_ERROR"]},"metadata":{},"error":{"$ref":"#/components/schemas/ErrorMessage"},"success":{"$ref":"#/components/schemas/Version"}}},"Version":{"type":"object","description":"버전 정보","properties":{"version":{"type":"string","description":"Open API 버전"}},"required":["version"]},"ApiResponseMerchant":{"type":"object","properties":{"resultType":{"type":"string","enum":["SUCCESS","FAIL","HTTP_TIMEOUT","NETWORK_ERROR","EXECUTION_FAIL","INTERRUPTED","INTERNAL_ERROR"]},"metadata":{},"error":{"$ref":"#/components/schemas/ErrorMessage"},"success":{"$ref":"#/components/schemas/Merchant"}}},"Merchant":{"type":"object","description":"\n        매장은 주문, 결제, 상품, 고객 관리 등 토스플레이스가 제공하는 서비스가 이루어지는 환경입니다. 매장은 보통 오프라인에서 하나의 사업장을 나타내며, 토스플레이스 Open API를 활용하여 매장이 보유한 데이터에 접근할 수 있습니다.\n        매장에서 앱을 설치하면, 앱에 등록된 key pair (access key와 secret key) 를 이용하여 매장의 데이터에 접근하는 Open API를 호출할 수 있습니다. 앱을 설치하지 않은 매장에 대해서는 API를 호출할 수 없습니다.\n    ","properties":{"id":{"type":"integer","format":"int64","description":"매장 ID","example":42},"name":{"type":"string","description":"매장명","example":"플레이스 베이커리"},"businessNumber":{"type":"string","description":"사업자등록번호","example":"0000000000"},"ownerName":{"type":["string","null"],"description":"사업주명","example":"김토스"},"displayName":{"type":"string","description":"매장 표시명","example":"플레이스 베이커리"},"phoneNumber":{"type":["string","null"],"description":"매장 전화번호","example":"01012345678"},"address":{"type":["string","null"],"description":"주소","example":"서울특별시 서초구 강남대로 459 (서초동)"},"latitude":{"type":["number","null"],"format":"double","description":"위도","example":37.5031925},"longitude":{"type":["number","null"],"format":"double","description":"경도","example":127.0247527},"operatingHours":{"type":["array","null"],"description":"영업 시간","items":{"$ref":"#/components/schemas/OperatingHour"}},"attributes":{"type":["object","null"],"additionalProperties":{},"description":"기타 속성","example":{"key":"value"}}},"required":["businessNumber","displayName","id","name"]},"OperatingHour":{"type":"object","description":"매장 영업 시간","properties":{"dayOfWeek":{"type":"string","description":"요일","example":"MONDAY"},"openAt":{"type":"string","format":"time-local","description":"영업 시작 시간","example":"10:00:00"},"closeAt":{"type":"string","format":"time-local","description":"영업 종료 시간","example":"22:00:00"}},"required":["closeAt","dayOfWeek","openAt"]},"ApiResponseListPayment":{"type":"object","properties":{"resultType":{"type":"string","enum":["SUCCESS","FAIL","HTTP_TIMEOUT","NETWORK_ERROR","EXECUTION_FAIL","INTERRUPTED","INTERNAL_ERROR"]},"metadata":{},"error":{"$ref":"#/components/schemas/ErrorMessage"},"success":{"type":"array","items":{"$ref":"#/components/schemas/Payment"}}}},"ApiResponseListOrder":{"type":"object","properties":{"resultType":{"type":"string","enum":["SUCCESS","FAIL","HTTP_TIMEOUT","NETWORK_ERROR","EXECUTION_FAIL","INTERRUPTED","INTERNAL_ERROR"]},"metadata":{},"error":{"$ref":"#/components/schemas/ErrorMessage"},"success":{"type":"array","items":{"$ref":"#/components/schemas/Order"}}}},"ApiResponseDiscountPolicy":{"type":"object","properties":{"resultType":{"type":"string","enum":["SUCCESS","FAIL","HTTP_TIMEOUT","NETWORK_ERROR","EXECUTION_FAIL","INTERRUPTED","INTERNAL_ERROR"]},"metadata":{},"error":{"$ref":"#/components/schemas/ErrorMessage"},"success":{"$ref":"#/components/schemas/DiscountPolicy"}}},"ApiResponseListDelivery":{"type":"object","properties":{"resultType":{"type":"string","enum":["SUCCESS","FAIL","HTTP_TIMEOUT","NETWORK_ERROR","EXECUTION_FAIL","INTERRUPTED","INTERNAL_ERROR"]},"metadata":{},"error":{"$ref":"#/components/schemas/ErrorMessage"},"success":{"type":"array","items":{"$ref":"#/components/schemas/Delivery"}}}},"ApiResponseListCatalogRule":{"type":"object","properties":{"resultType":{"type":"string","enum":["SUCCESS","FAIL","HTTP_TIMEOUT","NETWORK_ERROR","EXECUTION_FAIL","INTERRUPTED","INTERNAL_ERROR"]},"metadata":{},"error":{"$ref":"#/components/schemas/ErrorMessage"},"success":{"type":"array","items":{"$ref":"#/components/schemas/CatalogRule"}}}},"CatalogRule":{"type":"object","description":"전시 규칙","properties":{"id":{"type":"string","description":"전시 규칙 ID","example":"42"},"conditions":{"type":"array","description":"전시 규칙 조건 목록","items":{"$ref":"#/components/schemas/CatalogRuleCondition"}},"conditionsOperator":{"type":"string","description":"전시 규칙 조건 목록 간 연산자","enum":["AND","OR","UNDEFINED"],"example":"AND"},"targets":{"type":"array","description":"전시 규칙 적용 대상 목록","items":{"$ref":"#/components/schemas/CatalogRuleResourceTarget"}},"effect":{"type":"string","description":"전시 규칙 효과 종류","enum":["DISPLAY","DISPLAY_EXCLUSIVE","UNDEFINED"],"example":"DISPLAY"},"createdAt":{"type":"string","format":"date-time","description":"생성 시각","example":"2025-09-01T00:00:00Z"},"updatedAt":{"type":"string","format":"date-time","description":"수정 시각","example":"2025-09-01T00:00:00Z"}},"required":["conditions","conditionsOperator","createdAt","effect","id","targets","updatedAt"]},"CatalogRuleCondition":{"type":"object","description":"전시 규칙 조건","properties":{"type":{"type":"string","description":"조건 종류","example":"RESOURCE_SELECTED"},"operator":{"type":"string","description":"조건 대상 간 연산자","example":"ANY"},"targets":{"type":"array","description":"조건 대상 목록","items":{"$ref":"#/components/schemas/CatalogRuleResourceTarget"}}},"required":["operator","targets","type"]},"CatalogRuleResourceTarget":{"type":"object","description":"전시 규칙 대상","properties":{"type":{"type":"string","description":"대상 종류","enum":["ITEM","OPTION_SET","OPTION_CHOICE","UNDEFINED"],"example":"OPTION_SET"},"id":{"type":"string","description":"대상 ID","example":"42"}},"required":["id","type"]},"ApiResponseCatalogRule":{"type":"object","properties":{"resultType":{"type":"string","enum":["SUCCESS","FAIL","HTTP_TIMEOUT","NETWORK_ERROR","EXECUTION_FAIL","INTERRUPTED","INTERNAL_ERROR"]},"metadata":{},"error":{"$ref":"#/components/schemas/ErrorMessage"},"success":{"$ref":"#/components/schemas/CatalogRule"}}},"ApiResponseListCatalogOption":{"type":"object","properties":{"resultType":{"type":"string","enum":["SUCCESS","FAIL","HTTP_TIMEOUT","NETWORK_ERROR","EXECUTION_FAIL","INTERRUPTED","INTERNAL_ERROR"]},"metadata":{},"error":{"$ref":"#/components/schemas/ErrorMessage"},"success":{"type":"array","items":{"$ref":"#/components/schemas/CatalogOption"}}}},"CatalogOption":{"type":"object","description":"매장에 등록된 옵션","properties":{"id":{"type":"string","description":"옵션 ID","example":"42"},"merchantId":{"type":"integer","format":"int64","description":"매장 ID","example":42},"title":{"type":"string","description":"옵션명","example":"온도"},"code":{"type":["string","null"],"description":"옵션 코드"},"enabled":{"type":"boolean","description":"옵션 활성화 및 노출 여부","example":true},"order":{"type":"integer","format":"int32","description":"매장 내 정렬 순서","example":1},"choices":{"type":"array","description":"선택지 목록","items":{"$ref":"#/components/schemas/CatalogOptionChoice"}},"defaultChoiceIds":{"type":"array","description":"선택지 기본값 ID 목록","example":["42"],"items":{"type":"string"}},"required":{"type":"boolean","description":"필수 선택 여부","example":true},"minChoices":{"type":"integer","format":"int32","description":"고를 수 있는 최소 선택지 개수","example":1},"maxChoices":{"type":"integer","format":"int32","description":"고를 수 있는 최대 선택지 개수","example":3},"createdAt":{"type":"string","format":"date-time","description":"생성 시각","example":"2025-09-01T00:00:00Z"},"updatedAt":{"type":"string","format":"date-time","description":"수정 시각","example":"2025-09-01T00:00:00Z"}},"required":["choices","createdAt","defaultChoiceIds","enabled","id","maxChoices","merchantId","minChoices","order","required","title","updatedAt"]},"CatalogOptionChoice":{"type":"object","description":"옵션의 선택지","properties":{"id":{"type":"string","description":"선택지 ID","example":"42"},"merchantId":{"type":"integer","format":"int64","description":"매장 ID","example":42},"optionId":{"type":"string","description":"선택지가 속한 옵션 ID","example":"7"},"title":{"type":"string","description":"선택지명","example":"ICE"},"code":{"type":["string","null"],"description":"선택지 코드"},"state":{"type":"string","description":"선택지 판매 상태","enum":["ON_SALE","SOLD_OUT","UNDEFINED"],"example":"ON_SALE"},"enabled":{"type":"boolean","description":"선택지 활성화 및 노출 여부","example":true},"order":{"type":"integer","format":"int32","description":"옵션 내 정렬 순서","example":1},"priceValue":{"type":"integer","format":"int64","description":"추가 가격","example":500},"imageUrl":{"type":["string","null"],"description":"선택지 이미지 URL"},"quantityEnabled":{"type":"boolean","description":"수량 선택 가능 여부","example":true},"minQuantity":{"type":"integer","format":"int32","description":"선택 가능 최소 수량","example":1},"maxQuantity":{"type":"integer","format":"int32","description":"선택 가능 최대 수량","example":999},"createdAt":{"type":"string","format":"date-time","description":"생성 시각","example":"2025-09-01T00:00:00Z"},"updatedAt":{"type":"string","format":"date-time","description":"수정 시각","example":"2025-09-01T00:00:00Z"}},"required":["createdAt","enabled","id","maxQuantity","merchantId","minQuantity","optionId","order","priceValue","quantityEnabled","state","title","updatedAt"]},"ApiResponseCatalogOption":{"type":"object","properties":{"resultType":{"type":"string","enum":["SUCCESS","FAIL","HTTP_TIMEOUT","NETWORK_ERROR","EXECUTION_FAIL","INTERRUPTED","INTERNAL_ERROR"]},"metadata":{},"error":{"$ref":"#/components/schemas/ErrorMessage"},"success":{"$ref":"#/components/schemas/CatalogOption"}}},"ApiResponseListCatalogItem":{"type":"object","properties":{"resultType":{"type":"string","enum":["SUCCESS","FAIL","HTTP_TIMEOUT","NETWORK_ERROR","EXECUTION_FAIL","INTERRUPTED","INTERNAL_ERROR"]},"metadata":{},"error":{"$ref":"#/components/schemas/ErrorMessage"},"success":{"type":"array","items":{"$ref":"#/components/schemas/CatalogItem"}}}},"CatalogCategory":{"type":"object","description":"매장에 등록된 카테고리","properties":{"id":{"type":"string","description":"카테고리 ID","example":"42"},"merchantId":{"type":"integer","format":"int64","description":"매장 ID","example":42},"title":{"type":"string","description":"카테고리명","example":"커피"},"code":{"type":["string","null"],"description":"카테고리 코드"},"enabled":{"type":"boolean","description":"카테고리 활성화 및 노출 여부","example":true},"order":{"type":"integer","format":"int32","description":"매장 내 정렬 순서","example":1},"createdAt":{"type":"string","format":"date-time","description":"생성 시각","example":"2025-09-01T00:00:00Z"},"updatedAt":{"type":"string","format":"date-time","description":"수정 시각","example":"2025-09-01T00:00:00Z"}},"required":["createdAt","enabled","id","merchantId","order","title","updatedAt"]},"CatalogItem":{"type":"object","description":"매장에 등록된 상품","properties":{"id":{"type":"string","description":"상품 ID","example":"42"},"merchantId":{"type":"integer","format":"int64","description":"매장 ID","example":42},"category":{"$ref":"#/components/schemas/CatalogCategory","description":"카테고리"},"title":{"type":"string","description":"상품명","example":"아메리카노"},"code":{"type":["string","null"],"description":"상품코드"},"state":{"type":"string","description":"상품 판매 상태","enum":["ON_SALE","SOLD_OUT","UNDEFINED"],"example":"ON_SALE"},"enabled":{"type":"boolean","description":"상품 활성화 및 노출 여부","example":true},"order":{"type":"integer","format":"int32","description":"카테고리 내 정렬 순서","example":1},"description":{"type":"string","description":"상품 설명"},"imageUrl":{"type":["string","null"],"description":"상품 이미지 URL"},"labels":{"type":"array","description":"상품 라벨 목록","example":["신규"],"items":{"type":"string"}},"price":{"$ref":"#/components/schemas/CatalogItemPrice","description":"가격"},"priceVariations":{"type":["array","null"],"description":"동적으로 변경되는 가격 정보","items":{"$ref":"#/components/schemas/CatalogItemPriceVariation"}},"enableSchedule":{"description":"상품 활성화 및 노출 시간·일자 설정","oneOf":[{"$ref":"#/components/schemas/CatalogSchedule"},{"type":"null"}]},"diningOptions":{"type":"array","description":"상품을 제공하는 식사 옵션 목록","example":["HERE","TOGO"],"items":{"type":"string","description":"제공 식사 옵션","enum":["HERE","TOGO","UNDEFINED"]}},"options":{"type":"array","description":"옵션 목록","items":{"$ref":"#/components/schemas/CatalogOption"}},"attributes":{"type":["object","null"],"additionalProperties":{},"description":"기타 속성","example":{"key":"value"}},"createdAt":{"type":"string","format":"date-time","description":"생성 시각","example":"2025-09-01T00:00:00Z"},"updatedAt":{"type":"string","format":"date-time","description":"수정 시각","example":"2025-09-01T00:00:00Z"}},"required":["category","createdAt","description","diningOptions","enabled","id","labels","merchantId","options","order","price","state","title","updatedAt"]},"CatalogItemPrice":{"type":"object","description":"상품 가격","properties":{"title":{"type":"string","description":"가격명","example":"기본"},"priceType":{"type":"string","description":"가격 종류","enum":["FIXED","VARIABLE","UNIT","UNDEFINED"],"example":"FIXED"},"priceUnit":{"type":"integer","format":"int64","description":"가격 단위","example":1},"priceValue":{"type":"integer","format":"int64","description":"가격","example":3000},"barcode":{"type":["string","null"],"description":"바코드"}},"required":["priceType","priceUnit","priceValue","title"]},"CatalogItemPriceVariation":{"type":"object","description":"주문 맥락에 따라 동적으로 변경되는 가격 정보","properties":{"type":{"type":"string","description":"가격 변동 유형","example":"DINING_OPTION"},"value":{"type":"string","description":"가격 변동 적용 조건 값","example":"HERE"},"priceValue":{"type":"integer","format":"int64","description":"변동 가격","example":3000}},"required":["priceValue","type","value"]},"CatalogSchedule":{"type":"object","description":"활성화 및 노출 시간·일자 설정","properties":{"daysOfWeek":{"type":["array","null"],"description":"노출 요일","example":["FRIDAY","SATURDAY"],"items":{"type":"string"}},"dateRange":{"description":"노출 기간 (inclusive)","oneOf":[{"$ref":"#/components/schemas/CatalogScheduleDateRange"},{"type":"null"}]},"timeRange":{"description":"노출 시간 (inclusive)","oneOf":[{"$ref":"#/components/schemas/CatalogScheduleTimeRange"},{"type":"null"}]}}},"CatalogScheduleDateRange":{"type":"object","description":"노출 기간 (inclusive)","properties":{"start":{"type":"string","format":"date","description":"시작일","example":"2025-09-01"},"end":{"type":["string","null"],"format":"date","description":"종료일","example":"2025-09-30"}},"required":["start"]},"CatalogScheduleTimeRange":{"type":"object","description":"노출 시간 (inclusive)","properties":{"start":{"type":"string","format":"time-local","description":"시작 시각","example":"10:00:00"},"end":{"type":"string","format":"time-local","description":"종료 시각","example":"17:59:59"}},"required":["end","start"]},"ApiResponseCatalogItem":{"type":"object","properties":{"resultType":{"type":"string","enum":["SUCCESS","FAIL","HTTP_TIMEOUT","NETWORK_ERROR","EXECUTION_FAIL","INTERRUPTED","INTERNAL_ERROR"]},"metadata":{},"error":{"$ref":"#/components/schemas/ErrorMessage"},"success":{"$ref":"#/components/schemas/CatalogItem"}}},"ApiResponseListCatalogCombo":{"type":"object","properties":{"resultType":{"type":"string","enum":["SUCCESS","FAIL","HTTP_TIMEOUT","NETWORK_ERROR","EXECUTION_FAIL","INTERRUPTED","INTERNAL_ERROR"]},"metadata":{},"error":{"$ref":"#/components/schemas/ErrorMessage"},"success":{"type":"array","items":{"$ref":"#/components/schemas/CatalogCombo"}}}},"CatalogCombo":{"type":"object","description":"매장에 등록된 콤보(세트상품)","properties":{"id":{"type":"string","description":"콤보 ID","example":"42"},"merchantId":{"type":"integer","format":"int64","description":"매장 ID","example":42},"title":{"type":"string","description":"콤보명","example":"음료+디저트 세트"},"code":{"type":["string","null"],"description":"콤보 코드"},"enabled":{"type":"boolean","description":"콤보 활성화 및 노출 여부","example":true},"order":{"type":"integer","format":"int32","description":"정렬 순서","example":1},"description":{"type":"string","description":"콤보 설명"},"imageUrl":{"type":["string","null"],"description":"콤보 이미지 URL"},"labels":{"type":"array","description":"콤보 라벨 목록","example":["신규"],"items":{"type":"string"}},"basePriceValue":{"type":"integer","format":"int64","description":"콤보 판매 가격","example":9000},"originalPriceValue":{"type":["integer","null"],"format":"int64","description":"콤보 원래 가격\n콤보를 구성하는 상품의 원래 가격 합계 (할인 전 가격)","example":10000},"targetGroups":{"type":"array","description":"콤보 구성 상품군 목록","items":{"$ref":"#/components/schemas/CatalogComboTargetGroup"}},"attributes":{"type":["object","null"],"additionalProperties":{},"description":"기타 속성","example":{"key":"value"}},"createdAt":{"type":"string","format":"date-time","description":"생성 시각","example":"2025-09-01T00:00:00Z"},"updatedAt":{"type":"string","format":"date-time","description":"수정 시각","example":"2025-09-01T00:00:00Z"}},"required":["basePriceValue","createdAt","description","enabled","id","labels","merchantId","order","targetGroups","title","updatedAt"]},"CatalogComboTarget":{"type":"object","description":"콤보 구성","properties":{"id":{"type":"string","description":"구성 ID","example":"42"},"merchantId":{"type":"integer","format":"int64","description":"매장 ID","example":42},"groupId":{"type":"string","description":"구성 상품군 ID","example":"42"},"item":{"$ref":"#/components/schemas/CatalogItem","description":"구성 상품"},"order":{"type":"integer","format":"int32","description":"구성 배치 순서","example":1},"default":{"type":"boolean","description":"기본 선택 여부","example":false},"additionalPriceValue":{"type":"integer","format":"int64","description":"선택 시 발생하는 추가 가격","example":500}},"required":["additionalPriceValue","default","groupId","id","item","merchantId","order"]},"CatalogComboTargetGroup":{"type":"object","description":"콤보 구성 상품군","properties":{"id":{"type":"string","description":"상품군 ID","example":"42"},"merchantId":{"type":"integer","format":"int64","description":"매장 ID","example":42},"title":{"type":"string","description":"상품군명","example":"음료"},"description":{"type":"string","description":"상품군 설명"},"order":{"type":"integer","format":"int32","description":"상품군 배치 순서","example":1},"minQuantity":{"type":"integer","format":"int32","description":"선택 가능한 최소 상품 개수","example":1},"maxQuantity":{"type":"integer","format":"int32","description":"선택 가능한 최대 상품 개수","example":3},"targets":{"type":"array","description":"상품군에 포함된 상품 목록","items":{"$ref":"#/components/schemas/CatalogComboTarget"}}},"required":["description","id","maxQuantity","merchantId","minQuantity","order","targets","title"]},"ApiResponseCatalogCombo":{"type":"object","properties":{"resultType":{"type":"string","enum":["SUCCESS","FAIL","HTTP_TIMEOUT","NETWORK_ERROR","EXECUTION_FAIL","INTERRUPTED","INTERNAL_ERROR"]},"metadata":{},"error":{"$ref":"#/components/schemas/ErrorMessage"},"success":{"$ref":"#/components/schemas/CatalogCombo"}}},"ApiResponseListCatalogCategory":{"type":"object","properties":{"resultType":{"type":"string","enum":["SUCCESS","FAIL","HTTP_TIMEOUT","NETWORK_ERROR","EXECUTION_FAIL","INTERRUPTED","INTERNAL_ERROR"]},"metadata":{},"error":{"$ref":"#/components/schemas/ErrorMessage"},"success":{"type":"array","items":{"$ref":"#/components/schemas/CatalogCategory"}}}},"ApiResponseCatalogCategory":{"type":"object","properties":{"resultType":{"type":"string","enum":["SUCCESS","FAIL","HTTP_TIMEOUT","NETWORK_ERROR","EXECUTION_FAIL","INTERRUPTED","INTERNAL_ERROR"]},"metadata":{},"error":{"$ref":"#/components/schemas/ErrorMessage"},"success":{"$ref":"#/components/schemas/CatalogCategory"}}},"ApiResponseListDataExport":{"type":"object","properties":{"resultType":{"type":"string","enum":["SUCCESS","FAIL","HTTP_TIMEOUT","NETWORK_ERROR","EXECUTION_FAIL","INTERRUPTED","INTERNAL_ERROR"]},"metadata":{},"error":{"$ref":"#/components/schemas/ErrorMessage"},"success":{"type":"array","items":{"$ref":"#/components/schemas/DataExport"}}}}},"securitySchemes":{"x-access-key":{"type":"apiKey","name":"x-access-key","in":"header"},"x-secret-key":{"type":"apiKey","name":"x-secret-key","in":"header"}}}}