Open API 변경 이력

2026-05-06

카탈로그 - 카테고리 (CatalogCategory) 조회 및 웹훅 이벤트가 추가되었습니다.

앱 설치 및 설치 해제 웹훅 이벤트가 추가되었습니다. 이벤트를 수신하여 매장에서 앱을 설치한 시점에 초기화를 수행하거나, 설치 해제 시 데이터를 파기하는 등 적절한 행동을 취할 수 있습니다.

웹훅
- [신규] 이벤트: 매장에 앱 설치됨 (app.installation.created.v1)
- [신규] 이벤트: 매장에서 앱 설치 해제됨 (app.installation.deleted.v1)

웹훅 설정이 개발자 센터에서 직접 가능하도록 변경되었습니다. 기존에 담당자 수기 설정으로 진행되던 웹훅 등록/변경을 셀프 서비스로 처리할 수 있습니다.

자동 적용되는 할인 정책을 묶음으로 조회할 수 있는 API가 추가됩니다.

웹훅(Webhook) 이벤트가 추가되었습니다. 매장 정보 변경 및 상품 생성·수정·삭제 시 이벤트를 수신할 수 있습니다.

웹훅
- [신규] 웹훅 공통 안내 추가
매장
- [신규] 이벤트: 매장 정보 변경됨 (merchant.merchant.updated.v1)
카탈로그
- [신규] 이벤트: 상품 생성됨 (catalog.item.created.v1)
- [신규] 이벤트: 상품 수정됨 (catalog.item.updated.v1)
- [신규] 이벤트: 상품 삭제됨 (catalog.item.deleted.v1)

카탈로그 - 상품 (CatalogItem) 모델에 labels 필드가 추가됩니다. "신규", "인기" 등 토스 POS에서 상품에 지정할 수 있는 라벨을 확인할 수 있습니다.

주문 목록 조회 시, 결제가 아직 하나도 이루어지지 않은 OPENED(시작됨) 및 REQUESTED(주문 수락 전) 상태의 주문을 조회할 수 있도록 허용합니다.

주문
- [변경] 주문 목록 조회
  - 기존 동작: 결제가 아직 하나도 이루어지지 않은 주문은 조회할 수 없습니다. (orderStates 파라미터를 사용해도 이러한 제한이 적용되었습니다.)
  - 변경 동작: 결제가 아직 하나도 이루어지지 않은 주문도 조회할 수 있습니다. orderStates 파라미터에 OPENED 또는 REQUESTED 상태를 지정하면 이러한 주문도 목록에서 반환됩니다.
  - 유의: orderStates 파라미터를 사용하지 않는 경우 결과는 기존과 동일합니다. orderStates 파라미터의 기본값이 ["COMPLETED", "CANCELLED"] 인 것처럼 동작한다고 볼 수 있습니다.

카탈로그와 할인 관련 API가 추가되었습니다.

Open API의 초기 버전입니다.