<![CDATA[매장에서 직원이 포스 단말에서 마지막으로 '완료' 버튼을 눌러 완료 처리된 주문들의 orderNumber 목록을 Open API로 조회할 수 있나요?]]>어떤 제품을 사용하나요?
  • 제품: Open API
  • 환경: 운영

무엇이 궁금한가요?

안녕하세요. 매장에서 자체 DID(주문 호출 디스플레이) 시스템을 구축 중입니다.

현재 Open API 확인 값:
orderState=COMPLETED 는 결제 완료 시점을 의미하는 것으로 확인됩니다. 키오스크에서 결제하면 거의 동시에 OPENED → COMPLETED 로 전환되고, 그 이후 매장 직원이 포스 단말에서 "완료" 버튼을 눌러도 Open API 응답에는 아무 변화가 없습니다.

문의:
매장에서 직원이 포스 단말에서 마지막으로 '완료' 버튼을 눌러 완료 처리된 주문들의 orderNumber 목록을 Open API로 조회할 수 있나요? (결제 완료가 아닌, 매장 직원의 수동 완료 처리)

목적:
직원이 음료 조리 마친 후 포스에서 완료 처리한 주문을 DID 화면에 자동으로 호출하려고 합니다.

안내 부탁드립니다. 감사합니다.

]]>https://forum.tossplace.com/topic/28/매장에서-직원이-포스-단말에서-마지막으로-완료-버튼을-눌러-완료-처리된-주문들의-ordernumber-목록을-open-api로-조회할-수-있나요RSS for NodeSat, 07 Nov 2026 16:36:01 GMTThu, 01 Oct 2026 10:08:37 GMT60<![CDATA[Reply to 매장에서 직원이 포스 단말에서 마지막으로 '완료' 버튼을 눌러 완료 처리된 주문들의 orderNumber 목록을 Open API로 조회할 수 있나요? on Thu, 01 Oct 2026 10:45:00 GMT]]>안녕하세요. 토스플레이스 개발자센터입니다.

문의주신 내용 확인하여 안내드립니다.

직원이 POS에서 완료 버튼을 눌렀을 때 orderState가 별도로 변경되거나 조회 가능한 상태값이 생기지는 않습니다. orderState는 REQUESTED, OPENED, COMPLETED, CANCELLED, UNDEFINED 다섯 가지이며, 결제와 무관한 직원 조작만으로 전환되는 별도 상태는 제공하지 않습니다. orderState의 COMPLETED는 결제까지 완료된 상태를 의미합니다.

두 시점을 구분하려면 웹훅 이벤트 타입으로 처리하시는 것이 유일한 방법입니다.

  • 직원이 호출 버튼을 누른 시점: order.call.created.v1 이벤트 수신 (orderState 변동 없음, orderId·orderKey·orderNumber·calledAt 포함)
  • 결제까지 완료된 시점: orderState가 COMPLETED로 변경, order.order.completed.v1 이벤트 발생

DID 자동 호출 목적이라면 order.call.created.v1 웹훅을 활용하시는 것을 권장드립니다.

자세한 내용은 아래 문서를 참고해 주세요.
https://docs.tossplace.com/reference/open-api/order/order-model.html
https://docs.tossplace.com/reference/open-api/order/order-events.html

감사합니다.

]]>https://forum.tossplace.com/post/46https://forum.tossplace.com/post/46Thu, 01 Oct 2026 10:45:00 GMT