매장에서 직원이 포스 단말에서 마지막으로 '완료' 버튼을 눌러 완료 처리된 주문들의 orderNumber 목록을 Open API로 조회할 수 있나요?
-
어떤 제품을 사용하나요?
- 제품: Open API
- 환경: 운영
무엇이 궁금한가요?
안녕하세요. 매장에서 자체 DID(주문 호출 디스플레이) 시스템을 구축 중입니다.
현재 Open API 확인 값:
orderState=COMPLETED 는 결제 완료 시점을 의미하는 것으로 확인됩니다. 키오스크에서 결제하면 거의 동시에 OPENED → COMPLETED 로 전환되고, 그 이후 매장 직원이 포스 단말에서 "완료" 버튼을 눌러도 Open API 응답에는 아무 변화가 없습니다.문의:
매장에서 직원이 포스 단말에서 마지막으로 '완료' 버튼을 눌러 완료 처리된 주문들의 orderNumber 목록을 Open API로 조회할 수 있나요? (결제 완료가 아닌, 매장 직원의 수동 완료 처리)목적:
직원이 음료 조리 마친 후 포스에서 완료 처리한 주문을 DID 화면에 자동으로 호출하려고 합니다.안내 부탁드립니다. 감사합니다.
-
안녕하세요. 토스플레이스 개발자센터입니다.
문의주신 내용 확인하여 안내드립니다.
직원이 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감사합니다.
Hello! It looks like you're interested in this conversation, but you don't have an account yet.
Getting fed up of having to scroll through the same posts each visit? When you register for an account, you'll always come back to exactly where you were before, and choose to be notified of new replies (either via email, or push notification). You'll also be able to save bookmarks and upvote posts to show your appreciation to other community members.
With your input, this post could be even better 💗
등록 로그인