토스플레이스 개발자 포럼 (Beta)

안녕하세요. 토스플레이스 개발자센터입니다. 판매할 때마다 상품과 옵션을 선택하는 과정에서, 플러그인 화면 공간이 좁아 불편을 겪고 계신 점 확인했습니다. 왼쪽 메뉴 접기·숨기기, 플러그인 화면 확대 등 화면 공간과 접근성 개선은 내부 검토 중입니다. 다만 현재 적용 여부와 일정이 확정되지 않아 구체적인 지원 시점을 안내 드리기 어렵습니다. 현재 공개된 플러그인 기능에는 POS의 왼쪽 메뉴를 직접 숨기거나, 기본 상품 선택 영역을 자체 UI로 교체하는 기능이 포함되어 있지 않습니다. 상품 등록·수정·삭제 API 역시 일반 제공 범위에는 포함되어 있지 않습니다. 전달해 주신 상품 검색·옵션 선택·결제로 이어지는 사용 흐름과 화면 공간 확보 필요성을 확인했습니다. 당장 적용 가능한 화면 확대 설정이나 상품 동기화 방식으로 안내 드리지 못하는 점 양해 부탁 드립니다.

안녕하세요. 토스플레이스 개발자센터입니다. 추가로 문의 주신 세 가지 항목 안내 드립니다. 1. settlement로 카드 결제 여부를 판단할 수 있나요? settlementType이 ACQUIRER라는 이유만으로 카드 결제로 판단할 수는 없습니다. 정산 정보와 결제 재원 구분은 서로 다른 정보이므로, payType이 없는 건을 settlement 값으로 카드·선불로 확정하지 말아 주세요. 2. easyPayDetails.acquirer도 문자열 비교로 판단하면 안 되나요? 네. acquirer는 매입사명을 전달하는 문자열 필드이며, 가이드에도 ‘토스머니’와 같은 값이 예시로 포함되어 있습니다. 카드사명만 내려오는 고정 목록이 아니므로, 해당 이름을 비교해 카드·선불을 구분하지 않는 것이 맞습니다. 3. acquirerId는 어떤 코드인가요? acquirerId는 VAN사에서 전달한 값입니다. 토스플레이스의 공통 정규화 코드로 해석하지 말아 주세요. 별도의 코드표는 제공하지 않습니다. 따라서 기존에 안내 드린 것처럼, 구분 정보가 없는 건은 임의로 카드나 선불로 분류하지 않고 판별 보류로 처리해 주세요. 결제 데이터 가이드를 참고해 주세요.

안녕하세요. 토스플레이스 개발자센터입니다. 별도 사업자인 체인점에도 기존 개발자 계정의 프론트 플러그인과 Open API 앱을 적용할 수 있습니다. 다만 개발 배포 상태를 그대로 확대하는 것이 아니라, 라이브 검수·배포와 체인점별 앱 활성화가 필요합니다. 1. 라이브 검수 신청 개발자센터의 라이브 배포 트랙에 플러그인 파일을 업로드한 뒤 검수를 요청해 주세요. 테스트 결과와 관련 문서를 준비하고, 기능 동작·결제 흐름·Template API 사용·보안 기준을 확인해 주세요. 검수는 매주 월·목요일, 근무일 기준으로 진행합니다. 가이드의 평균 소요 기간은 1일이며, 보완 사항이 있으면 완료 시점은 달라질 수 있습니다. 검수 기준과 배포 절차를 참고해 주세요. 2. 체인점의 대리점 연결 단말기 구매만으로 플러그인이 활성화되지는 않습니다. 담당 VAN 대리점에 앱 조회·활성화 권한이 연결되어 있어야 하며, 대리점에서 체인점의 앱 사용 여부를 ON으로 설정해야 합니다. 같은 대리점에 해당 앱의 권한이 이미 연결되어 있다면 체인점 활성화를 요청해 주세요. 다른 대리점이거나 아직 권한이 없다면, 앱 이름·ID와 대리점명·대리점 사업자번호를 개발자센터 메일로 전달해 주세요. 3. 체인점의 Open API 앱 체인점이 별도 앱을 만들 필요 없이 기존 laundryplan-pay 앱을 함께 사용할 수 있습니다. 토스 POS 없이 프론트만 운영하는 매장은 서비스 코드를 직접 입력하는 방식이 아니라, VAN 대리점을 통해 Open API 앱을 적용합니다. 프론트 플러그인과 Open API 앱을 각각 활성화해 주세요. 연결 후에는 체인점의 merchantId로 결제 내역을 조회하고 매장별 데이터를 구분해 주세요. Open API 서비스 설치 가이드를 참고해 주세요. 4. 별도 사업자 매장 지원 체인점의 사업자가 달라도 기존 앱을 매장별로 연결해 사용할 수 있습니다. 이를 위해 체인점이 별도의 개발자 계정을 만들거나 동일한 앱을 다시 개발할 필요는 없습니다. 기존 계정에서 앱을 관리하고, 각 매장에는 해당 매장 정보로 설치·활성화해 주세요. 5. 프론트2·터미널2 환경 프론트2도 프론트 플러그인 SDK를 사용하는 대상입니다. 플러그인이 실행되는 장비는 프론트이며, 터미널에 플러그인을 설치하는 구조는 아닙니다. 다만 기존 단말기에서의 테스트가 프론트2 환경의 동작까지 검증한 것은 아닙니다. 체인점 적용 전 프론트2에서 화면 표시, 결제·취소, 사용 중인 주변기기 기능을 개발 배포로 확인해 주세요. 기기 변경만을 이유로 SDK를 별도 방식으로 교체하는 것은 아니며, 실제 기능 차이에 따른 수정 여부는 이 테스트를 기준으로 확인해 주세요.

안녕하세요. 토스플레이스 개발자센터입니다. 현재 프론트 플러그인에서 페이스페이만 실행하는 전용 API·템플릿과 카드 결제만 실행하는 전용 화면은 별도로 제공하지 않습니다. 자체 POS에서 결제를 시작하더라도, 프론트 플러그인에서는 requestPayment로 통합 결제 화면을 호출하는 방식을 사용해 주세요. 문의 주신 페이스페이와 카드 결제도 이 화면에서 진행합니다. 결제 수단 제외 옵션인 excludePaymentTypes는 현재 현금(CASH)만 지원하므로, 이 옵션으로 페이스페이 또는 카드만 남기는 구성은 지원하지 않습니다. 자세한 호출 방법은 Payment API 가이드를 참고해 주세요.

안녕하세요, order.addMenu()의 dto.lineItems에는 새로 추가하는 항목만 넣어 주세요. 이미 저장된 항목까지 포함하면 그 항목이 한 번 더 반영됩니다. 기존 항목과 같으면 수량이 합산되고, 다르면 lineItem이 추가로 생성됩니다. 요청하신 예시 상황에서는 A를 다시 넣지 않고 B만 전달합니다. await sdk.order.addMenu(orderId, { discounts: [], lineItems: [ { ... item: { id: 2, title: 'B', ... }, ... }, ], }); 이미 저장된 주문 항목의 수량을 변경하거나 삭제하는 API는 현재 제공하지 않습니다. 감사합니다.

안녕하세요, 질문에 답변드립니다. 아닙니다. 간단한 유효성 검사만 진행하며, 화면에서 다음 단계로 넘어가셨다면 가입까지 정상적으로 진행하실 수 있습니다. 네, 가능합니다. 이와 별개로, 실패한 요청을 확인해 보니 이메일 인증 유효기간(30분)이 만료되어 실패한 것으로 확인됩니다. 이메일 인증부터 다시 진행해 주시기 바라며, 해당 오류 메시지는 개선하도록 하겠습니다. 감사합니다.

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

오늘(10/7) 일부 가맹점에서 플러그인 화면이 정상적으로 표시되지 않는 현상(백화 현상)이 발생하여 안내드립니다. 발생 시간: 10월 7일(수) 16:40경 ~ 17:13 영향: 발생 시간 동안 재부팅된 일부 단말기에서 플러그인 실행 시 화면이 흰색으로 표시되며 정상적으로 이용할 수 없는 현상 현재 상태: 조치 완료 및 정상화 영향을 받은 일부 단말기를 대상으로 원격 앱 재시작 조치를 진행했으며, 이후 플러그인이 정상적으로 동작하는 것을 확인했습니다. 플러그인 화면이 정상적으로 표시되지 않는 경우, 토스 프론트를 재시작한 뒤 다시 확인해 주세요. 서비스 이용에 불편을 드려 죄송합니다. 동일한 문제가 재발하지 않도록 관련 작업 및 모니터링 프로세스를 보완하겠습니다. 감사합니다.

Open API의 업데이트 내역을 안내드려요. 2026-10-01 할인 정책 자동 적용(묶음 요청)의 최대 건수가 늘었어요 할인 할인 정책 자동 적용(묶음 요청)이 최대 100건까지 가능해요. 2026-09-30 할인 정책을 조회할 수 있어요. 할인 [신규] 할인 정책 단건 조회 API [신규] 할인 정책 복수건 조회 API [신규] 할인 정책 목록 조회 API

안녕하세요. 토스플레이스 개발자센터입니다. 문의주신 내용 확인하여 안내드립니다. 쿠폰이 사용된 주문 조회 포함됩니다. 주문 조회의 할인 내역(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 감사합니다.