Open API 변경 이력

2026-03-19

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

• 카탈로그
  • [신규] 상품 CatalogItem
    • 상품 라벨 목록 (labels) 필드가 추가됩니다.

2026-02-20

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

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

2025-11-28

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

• 카탈로그
  • [신규] 상품 단건 조회
  • [신규] 상품 복수건 조회
  • [신규] 상품 목록 조회
• 할인
  • [신규] 할인 정책 자동 적용
• 주문
  • Discount 모델이 할인 하위 모델로 이동했습니다.

2025-09-01

Open API의 초기 버전입니다.

• 일반
  • [신규] Open API 버전 정보 조회
• 매장
  • [신규] 매장 정보 조회
• 주문
  • [신규] 주문 단건 조회
  • [신규] 주문 복수건 조회
  • [신규] 주문 목록 조회
• 결제
  • [신규] 결제 단건 조회
  • [신규] 주문의 결제건 모두 조회