안녕하세요. 토스플레이스 개발자센터입니다. POS 플러그인 SDK에서 고객용 채널 노출 on/off 설정값은 조회하실 수 없습니다.

안녕하세요. 토스플레이스 개발자센터입니다. 문의주신 내용 확인하여 안내드립니다. 쿠폰이 사용된 주문 조회 포함됩니다. 주문 조회의 할인 내역(Discount)에서 할인명, 할인 종류, 할인 코드, 할인 금액, 적용 우선순위를 확인하실 수 있습니다. 쿠폰 할인과 일반 할인은 할인 내역 안의 couponDetails 필드로 구분하실 수 있습니다. 이 필드에는 쿠폰 제공자, 쿠폰 번호, 쿠폰 잔액이 포함되며 일반 할인에는 포함되지 않습니다. 다만 couponDetails는 ALPHA 단계 필드로 사양이 변경될 수 있습니다. 증정 품목이 어떤 형태로 반영되는지는 문서에 명시되어 있지 않아 확답 드리기 어렵습니다. 1+1이나 상품 증정을 집계에서 구분해야 한다면, 실제 쿠폰을 운영하시기 전에 테스트 가맹점에서 해당 쿠폰을 적용한 주문을 조회해 응답 구조를 먼저 확인해 주시기 바랍니다. https://docs.tossplace.com/reference/open-api/order/order-model.html 외부 서버에서의 쿠폰 발급 제공하지 않습니다. 외부 서버에서 쿠폰을 발급하거나 특정 고객에게 지급하는 API는 현재 없으며, 제공 계획에 대해서도 예정된 내용이 없어 확답 드리기 어렵습니다. 할인 API와 적립 API의 성격 '주문 - 혜택 사용 추가(ALPHA)'와 '주문 - 적립 추가(ALPHA)'는 솔루션사가 자체 포인트·쿠폰 사용 내역이나 적립 내역을 주문에 기록하는 쓰기 API입니다. 토스 포스에서 적용된 쿠폰이 이 API로 전달되는 것이 아니라, 외부 시스템의 혜택 내역을 주문에 남기는 용도입니다. https://docs.tossplace.com/reference/open-api/discount.html https://docs.tossplace.com/reference/open-api/order/order-accrual-create.html 쿠폰 관련 웹훅 쿠폰 발급이나 사용 시점에 발송되는 웹훅 이벤트는 제공하지 않습니다. 현재 제공하는 이벤트는 주문, 결제, 상품, 가맹점, 앱 설치 범위입니다. 쿠폰이 적용된 주문은 주문 또는 결제 이벤트로 수신하신 뒤 주문 조회의 할인 내역에서 쿠폰 적용 여부를 확인하는 방식으로 구성하실 수 있습니다. https://docs.tossplace.com/reference/open-api/order/order-events.html 감사합니다.

안녕하세요. 토스플레이스 개발자센터입니다. startTimer를 호출할 때 반환되는 함수를 실행하면 타이머를 중지할 수 있습니다. 중지한 뒤 startTimer를 다시 호출하면 설정한 시간부터 새로 시작합니다. 문의하신 흐름은 다음과 같이 구현해 주세요. startTimer를 호출하고, 반환된 중지 함수를 보관합니다. 사용자의 터치·입력 이벤트가 발생하면 보관한 함수를 실행해 기존 타이머를 중지합니다. startTimer를 다시 호출하고, 새로 반환된 중지 함수로 교체합니다. 터치나 입력만으로 타이머가 자동 초기화되지는 않으므로, 해당 이벤트에 중지·재시작 처리를 연결해 주세요. 입력 템플릿에서는 input.onChange를 활용할 수 있습니다. 기존 타이머가 실행 중인 상태에서 startTimer를 다시 호출하면 오류가 발생하므로 반드시 먼저 중지해 주세요. 화면을 벗어날 때도 타이머를 중지해 주세요. 중지 함수 실행만으로는 onTimeout이 호출되지 않습니다. 타이머 가이드

안녕하세요. 토스플레이스 개발자센터입니다. 문의하신 플러그인에서 전달받은 결제 금액을 토스 터미널로 넘겨 결제를 진행하는 방식은 지원하지 않습니다. 프론트나 POS에 터미널을 연결하더라도, 해당 금액이 터미널의 결제 화면에 자동으로 입력되거나 결제 요청이 전달되지는 않습니다. 안내된 ‘보조 결제’는 터미널에서 금액을 직접 입력하고 자체 결제 기능으로 별도 결제를 진행할 수 있다는 의미입니다. 플러그인에서 진행 중인 주문이나 결제 요청을 터미널이 이어받아 처리한다는 의미는 아닙니다. 따라서 터미널을 백업 결제 단말기로 활용하는 것과, 외부 서비스의 결제 요청을 터미널에 연동하는 것은 구분해 주시면 됩니다.

안녕하세요. 토스플레이스 개발자센터입니다. 1. 터미널1의 백업 결제 사용 터미널1에서 금액을 직접 입력하고, 터미널1 자체 카드 리더기로 결제하는 것은 가능합니다. 앞서 안내한 미지원 사항은 프론트 플러그인의 영수증을 터미널1로 출력하는 기능이며, 터미널1 자체 카드 결제를 뜻한 것은 아닙니다. 다만 플러그인 모드의 프론트를 기존처럼 터미널1의 카드 리더기로 함께 사용하는 구성은 지원하지 않습니다. 백업 결제는 프론트와 결제 연동을 분리한 터미널1에서 진행하며, 터미널1의 정상적인 결제 설정과 인터넷 연결이 필요합니다. 2. 장비 교체 필요 여부 백업 카드 결제 목적만이라면 터미널2·프론트2로 교체할 필요는 없습니다. 기존 터미널1의 자체 결제를 이용하시면 됩니다. 프론트 플러그인의 영수증 출력까지 필요하다면 별도로 지원되는 프린터 구성을 검토해 주세요. 3. 테스트 설정 적용과 기존 화면 복구 사용 여부 ON과 테스트 단말 등록만으로 현재 화면이 즉시 플러그인 모드로 전환되지는 않습니다. 설정 후 프론트를 다시 온보딩하면 개발 배포된 플러그인이 적용됩니다. 반대로 일반 터미널 연결 모드로 돌아갈 때도 OFF 후 재시작만으로 복구하는 방식은 아닙니다. 플러그인 사용을 해제한 뒤 프론트에서 로그아웃 또는 초기화를 진행하고, 기존 터미널 연결 방식으로 다시 온보딩해야 합니다. 영업 중인 프론트를 테스트 단말기로 등록하면 해당 장비가 개발 코드 적용 대상이 됩니다. 운영에 영향을 주지 않도록 별도의 테스트 단말기 사용을 권장합니다. 테스트 단말기 등록 가이드 · 재온보딩 안내

안녕하세요. 토스플레이스 개발자센터입니다. 현재 플러그인 이용에 대한 과금은 2026년까지 면제됩니다. 따라서 올해는 POS 탭 화면 플러그인과 웹 워커 플러그인을 함께 사용하시더라도 별도 이용료가 발생하지 않습니다. 다만 2027년 과금 정책은 아직 확정된 내용이 없습니다. 문의하신 앱별 과금 여부와 서비스 이용을 중단한 매장의 과금 대상 제외 기준도 현재 확정해 안내 드리기 어려운 점 양해 부탁 드립니다.

안녕하세요. 토스플레이스 개발자센터입니다. 문의주신 내용 확인하여 안내드립니다. 직원이 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 감사합니다.

안녕하세요. 토스플레이스 개발자센터입니다. 문의하신 프론트 결제 주문의 상품명 변경에 대해 안내 드립니다. 1. update-line-items 사용 권한과 4030 오류 update-line-items는 공개된 주문 내역 변경 API이며, 주문 생성 API 사용 권한이 부여된 앱에서 사용할 수 있습니다. 조회 API 사용 권한과는 별도로 확인이 필요합니다. 전달해 주신 4030(해당 기능에 대한 접근 권한이 없습니다) 오류는 해당 앱의 주문 생성 API 권한 부여 여부를 먼저 확인해야 합니다. 다만 권한이 부여되더라도 Open API의 주문 생성 API로 만든 주문만 변경할 수 있습니다. 프론트 결제로 자동 생성된 PARTNER_APP 주문은 변경 대상이 아닙니다. 주문 내역 변경 가이드 2. 결제 완료 주문의 변경 여부 이번 주문은 COMPLETED 상태 여부에 앞서 프론트 결제로 생성된 PARTNER_APP 주문이라는 점이 제한 사항입니다. 결제 전에 변경 API를 호출하는 것만으로 이 제한이 해소되지는 않습니다. 3. 주문 사전 생성 후 프론트 결제 연결 프론트 Payment API에는 기존 주문 ID를 지정하는 항목이 없습니다. Open API의 orderKey와 프론트의 paymentKey를 동일하게 설정해도, 미리 생성한 주문에 결제가 연결되지 않습니다. 따라서 동일한 식별자로 주문과 결제를 연결하는 방식은 권장하지 않습니다. 4. 실제 상품명 기록 방법 현재 프론트 Payment API에는 상품명·품목 목록을 전달하는 항목이 없습니다. 따라서 현재 제공되는 API만으로 프론트 결제 주문의 상품명을 실제 상품명으로 지정하거나 변경하는 방식은 지원되지 않습니다. 프론트 결제 가이드 솔루션사 시스템에서 상품정보와 결제 결과를 연결해 관리할 수는 있으나, 이 방식이 토스 매출 내역이나 영수증의 상품명을 변경하는 것은 아닙니다.

안녕하세요. 토스플레이스 개발자센터입니다. [테스트 매장 만들기]로 직접 생성한 매장의 사업자번호와 휴대폰번호는 테스트용 공용 정보입니다. 본인 사업자번호와 다른 번호가 표시될 수 있으며, 이 방식으로 만든 매장에서는 결제가 불가능합니다. 본인 사업자번호로 등록된 매장을 연결하려면 [테스트 가맹점 관리]의 [불러오기]를 이용해 주세요. 토스플레이스 파트너스에 등록된 가맹점이 목록에 표시됩니다. 연결할 가맹점이 없다면 이용 중인 VAN 대리점을 통해 테스트 매장 생성을 요청해 주세요. 개발자센터 계정과 연결할 가맹점의 사업자번호가 달라 조회되지 않는 경우에는 계정 이메일과 연결할 가맹점 사업자번호를 개발자센터 메일로 전달 부탁 드립니다. 해당 정보는 공개 게시글에 남기지 말아 주세요. 자세한 절차는 테스트 가맹점 연결하기를 참고해 주세요.

프론트 플러그인과 OpenAPI 병행 사용 가능합니다. 각각 플러그인 앱으로 생성하여 매장에 연결해주시면 됩니다. 매장 설치과정 역시 동일하며, 연동가이드의 프론트 플러그인 설치 가이드 확인 부탁 드리겠습니다.

안녕하세요. 토스플레이스 개발자센터입니다. 프론트 플러그인 SDK의 결제 응답에는 Open API의 orderId가 포함되지 않습니다. 응답에 orderId를 추가하거나 paymentKey로 orderId를 조회하는 기능도 제공하지 않습니다. paymentKey는 솔루션사에서 결제를 요청하실 때 직접 생성하시는 식별자로, Open API의 결제 ID나 주문 ID와는 별개의 값입니다. 프론트 SDK는 결제 승인 결과를 돌려주고 Open API는 주문·결제 데이터를 제공하기 때문에, 두 응답의 규격이 서로 다릅니다. 프론트 SDK 쪽에서는 요청하신 paymentKey와 결제 금액, 응답으로 받으신 승인번호와 승인시각을 함께 보관해 주세요. Open API의 orderId는 결제 조회 응답이나 결제 승인 웹훅의 data.payment.orderId에서 확인하실 수 있습니다. 다만 두 거래를 공통 식별자로 자동 연결해 드리는 기능은 제공하지 않습니다. 연결이 필요하시면 같은 매장의 승인번호와 승인시각, 금액을 대조하는 기준을 세우신 뒤 별도로 검증해 주셔야 합니다. 승인번호 하나만으로 동일 거래로 판단하지 않도록 유의해 주세요. 감사합니다.

안녕하세요. 토스플레이스 개발자센터입니다. 두 API는 결제 정보를 가져오는 경로가 서로 다릅니다. printReceipt 는 전달하신 paymentKey 로 토스플레이스 서버에서 결제 정보를 조회한 뒤 영수증을 출력합니다. getPayment 는 결제한 단말기의 로컬 캐시를 조회합니다. TTL 14일, 최대 1,000건이라는 정책은 이쪽에만 적용됩니다. 각 API의 파라미터는 아래 문서에서 확인하실 수 있습니다. https://docs.tossplace.com/reference/plugin-sdk/front/printer.html https://docs.tossplace.com/reference/plugin-sdk/front/payment.html 감사합니다.

안녕하세요. 토스플레이스 개발자센터입니다. 플러그인 마켓플레이스는 현재 안내드릴 수 있는 계획이 없습니다. 일정도 확답드리기 어려운 점 양해 부탁드립니다. 공개할 수 있는 내용이 정해지면 연동 가이드를 통해 안내드리겠습니다. 감사합니다.