[Open API] 주문 생성 API 권한 신청 메일 접수 확인 요청 (앱 ID 1547, 4030)

[neoworks]

제품: Open API (서버 앱, pluginType SERVER)
앱: 네오웍스 QR 테이블오더 / 앱 ID 1547 (packageName neoworks-qr-table-order)
배포 상태 / 환경: 운영 (라이브 매장 1곳 서비스 코드로 설치 완료, 2026-10-22)
발생 시각: 2026-10-22 19:59 KST (최초 2026-10-19부터 동일)

무엇이 궁금한가요?

주문 생성 API(POST /merchants/{merchantId}/order/orders) 권한 신청을 개발자센터 지원 메일로 두 차례 보냈는데, 접수 여부를 아직 확인하지 못해 포럼에도 남깁니다. 가이드에 안내된 신청 항목(계정 이메일, 앱 이름/ID, 이용 매장 merchantId, 사용 목적, 매장 인지 여부)은 모두 메일에 적었습니다.

• 1차: 2026-10-19 11:59 KST, 제목 [주문 생성 API 권한 요청] 네오웍스 QR 테이블오더 (neoworks-qr-table-order)
• 2차: 2026-10-22 16:48 KST, 제목 Re: [주문 생성 API 권한 요청] 네오웍스 QR 테이블오더 (neoworks-qr-table-order) - 매장 ID 708*** 전달
• 오늘 위 포럼 안내(56번 글) 항목 순서대로 정리한 3차 메일도 보냈습니다.

사용 목적 (요약)

식당 테이블 QR 주문입니다. 손님이 테이블 QR로 메뉴(토스 POS 카탈로그 조회)를 보고 주문하면, 서버가 주문 생성 API로 토스 POS [현황]에 주문을 만들고 printOrderSheet=true로 주방 주문서를 출력합니다. 테이블 번호는 orderNumber와 memo에 넣습니다. 결제는 식사 후 카운터의 토스 단말기에서 매장이 직접 받기 때문에, 주문 생성 시 payments는 비워서 보냅니다. 매장 사장님이 직접 의뢰한 작업이고 기능을 알고 동의했습니다.

오류

• 조회 API(merchant, catalog, order 목록)는 모두 200 정상, 웹훅 수신도 정상입니다.
• 주문 생성만 HTTP 403 {"errorCode":"4030","reason":"해당 기능에 대한 접근 권한이 없습니다"}
• x-toss-event-id: 6ad9eca104e5e7ca7366b5ea (2026-10-22 19:59 KST, 운영 매장), 6ad586dd196bee317fa02196 (2026-10-19, 테스트 가맹점)
• 개발자센터 앱 상세(allowedOperations)에 아직 openapi.order.create 가 없습니다.

매장 오픈 일정이 있어 혹시 메일이 접수되지 않았거나 추가로 필요한 정보가 있으면 알려주세요. 매장 식별정보와 계정 정보는 메일에만 적었습니다. 회신은 contact@neoworks.us 로 부탁드립니다.

[neoworks]

추가로 말씀드립니다.

이 앱(앱 ID 1547)을 쓰는 매장이 내일 2026-10-23(금) 오픈합니다. 오픈 전에 주문 생성 권한(openapi.order.create) 검토가 가능할지 여쭙고 싶습니다.

개발자센터 지원 메일로 보낸 신청(10-19, 10-22, 오늘 추가 회신)이 담당 팀에 잘 접수되었는지만이라도 확인해 주시면 감사하겠습니다. 오늘 21:17 KST에 다시 호출해 봐도 같은 403 / 4030입니다 (x-toss-event-id: 6ad9fec604e5e7ca736a3f83).

감사합니다.

[토스플레이스-개발자센터]

안녕하세요. 토스플레이스 개발자센터입니다.

메일 확인과 회신이 늦어진 점 양해 부탁 드립니다. 요청하신 주문 생성 API 권한 처리 결과를 안내 드립니다.

네오웍스 QR 테이블오더 앱(App ID: 1547)의 주문 생성 API 권한 부여를 완료했습니다.
권한 반영을 확인했으니, 해당 앱으로 주문 생성 API 연동을 다시 확인 부탁 드립니다.

테스트 하실 땐 다음 사항 체크 부탁 드립니다.

토스 POS 실행여부 및 업종 확인

• 현황 탭이 제공되는 카페, 음식점 대상으로 주문생성 가능 (도·소매업, 서비스업은 현황 탭 미노출)
• 업종유형 확인 : 좌측 상단 메뉴(☰) 버튼 > 매장 페이지 > [업종유형 변경]

토스 POS > 현황 탭 > 주문표시 > OpenAPI 앱 선택여부 확인

• 현황 탭에 표기되는 주문은 당일 생성 주문 건만 노출

감사합니다.

[neoworks]

권한 부여 감사합니다. 덕분에 주문 생성은 정상 동작하고 주문서도 출력되고 있습니다.

후속으로 하나 여쭙습니다. 설치 매장이 음식점 · 후불형 매장이라 POS 상단 탭이 테이블 / 주문 / 매출뿐이고 [현황] 탭이 없어서 [현황] > [주문표시]에서 앱을 선택할 수 없습니다. (탭 추가 화면에도 예약, 매출, 고객만 보입니다.)

1. 후불형 매장은 메뉴(☰) > 설정 > 현황 설정 > **'현황 기능 사용'**을 켜야 [현황] 탭이 생기고, 그다음 [주문표시]에서 Open API 앱을 선택하는 순서가 맞을까요?
2. 후불형 매장에서 Open API로 생성한 OPENED 주문(payments 없음)은 POS 어디에서 결제를 진행하나요?
3. 현황 기능을 켜기 전에 생성된 당일 주문도 켠 뒤에 표시되나요?

매장 ID와 주문 ID는 개발자센터 지원 메일로 함께 보냈습니다(제목: [Open API 주문 표시 문의] 후불형 매장에 현황 탭이 없을 때 / 앱 ID 1547).

[토스플레이스-개발자센터]

안녕하세요. 토스플레이스 개발자센터입니다.

후불형 매장의 현황 탭 설정과 Open API 주문의 결제 처리 범위를 안내 드립니다.

1. 현황 탭 활성화
말씀하신 순서가 맞습니다. 메뉴(☰) > 설정 > 현황 설정에서 ‘현황 기능 사용’을 켠 뒤, 현황 > 주문표시에서 해당 Open API 앱을 선택해 주세요.

2. 미결제 주문의 결제 처리
후불형 매장에서는 Open API로 생성한 OPENED 주문을 현황 화면에서 결제하는 경로를 제공하지 않습니다.
현황 기능을 켜더라도 해당 주문이 후불 테이블 주문에 자동으로 연결되거나 결제 버튼이 제공되는 것은 아닙니다. 테이블 기반 후불 주문과 POS 결제를 연계하려면 POS 플러그인 방식을 검토해 주세요.
앞서 안내한 현황 탭 설정은 주문을 표시하기 위한 설정이며, 후불 주문의 결제 연동과는 별개입니다.

3. 설정 전에 생성한 주문
현황 기능을 켜기 전에 생성한 당일 주문도 현재 주문 표시 조건에 맞으면 조회 대상입니다. 주문을 다시 생성할 필요는 없습니다. 해당 앱의 주문 표시 선택 여부와 당일 주문인지 먼저 확인해 주세요.

주문 생성·표시 가이드와 앞서 안내한 앱 선택·업종 확인 내용을 함께 참고해 주세요.