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

현재 토스플레이스 개발자 센터에서 포스/프론트 플러그인을 올려서 테스트해보는 중입니다. 그런데 여러 사업자에 포스, 프론트 등등이 있다보니 파일을 잘못올리는 경우가 있는데 이때 기존 이력이 남아 있어서 오히려 더 헷갈리는 경향이 있는 것 같습니다. 숨기거나 삭제할 수 있는 기능이 있으면 좋을 것 같습니다.

안녕하세요. 토스플레이스 개발자센터입니다. 프론트 플러그인은 VAN을 통한 오프라인 결제 승인·취소만 지원합니다. 토스페이먼츠 PG로 단말 결제를 직접 승인·취소하는 방식은 지원하지 않습니다. 복합기 앞 프론트 단말의 카드·QR 결제는 앞서 안내 드린 대로 현재 구현하신 프론트 결제 API를 사용해 주세요.

답변 감사합니다.

안녕하세요. 토스플레이스 개발자센터입니다. 문의하신 것처럼 무인매장에서 고객의 성인 여부를 먼저 확인한 뒤 결제를 진행하는 기능은 현재 토스 프론트의 공개 API나 플러그인으로 제공하지 않습니다. 프론트에서 카드나 간편결제가 승인되더라도, 고객의 성인 여부까지 확인되는 것은 아닙니다. 따라서 성인인증이 필요한 서비스라면 성인 여부는 별도 인증 수단으로 확인하고, 인증에 성공한 경우에만 프론트에 결제를 요청하는 방식을 검토해 주세요. 이때 프론트의 결제 API는 인증 이후의 결제 단계를 담당합니다. 문의 주신 성인인증 기능은 아직 안내 드릴 수 있는 도입 일정이 없습니다.

@토스플레이스-개발자센터 답변 감사합니다!

안녕하세요. 토스플레이스 개발자센터입니다. ‘방문 감사해요!’ 화면은 프론트에 내장된 결제 완료 화면으로, 플러그인에서 문구를 변경하거나 화면을 숨기고 건너뛸 수 없습니다. 매장 설정에서 문구나 표시 여부를 변경하는 기능도 제공하지 않습니다. 결제 성공 결과를 서버에 저장한 뒤 renderResultPage로 자체 결과 화면을 표시하는 것은 가능합니다. 다만 자체 화면은 프론트의 결제 완료 화면을 대체하는 것이 아니라 그다음에 표시됩니다. 다른 매장에서 보신 화면은 POS 연동 방식이나 결제수단에 따라 다를 수 있습니다. 예를 들어 IC카드 결제에서는 ‘방문 감사해요!’ 대신 카드를 빼 달라는 안내가 표시될 수 있어, 화면 차이만으로 앱 버전 때문이라고 판단하기는 어렵습니다. 하단 토스 로고도 공개 SDK나 매장 설정에서 가맹점 로고로 직접 교체하는 옵션은 없습니다. 프론트 결제 API 가이드 · 프론트 결제창과 플러그인 화면 제어에 대한 기존 답변

안녕하세요. 토스플레이스 개발자센터입니다. 14일은 승인·취소 결과를 단말기에서 다시 조회할 수 있는 기간이지, 환불 기한이 아닙니다. 단말기에는 성공 결과만 최대 1,000건까지 저장됩니다. 캐시가 만료된 뒤에도 원승인번호·승인 시각·결제수단·금액 등 취소에 필요한 값을 보관하고 있다면 전액 취소를 요청할 수 있습니다. 다만 취소 요청이 가능하다는 것과 실제로 승인된다는 것은 별개입니다. 공개 SDK 가이드에는 승인 시각부터 계산하는 공통 취소 기한이나 환불 목록의 권장 노출 기간이 없습니다. 환불 목록은 단말 캐시와 별도로 관리해 주세요. 실제 취소 가능 기간은 결제수단마다 다를 수 있으며, 해당 거래의 VAN사·카드사 정책에 따릅니다. 특정 거래의 취소 기한을 확인하려면 이용 중인 VAN사 또는 VAN 대리점에 문의해 주세요. 결제·취소 API 가이드 · 단말 조회 결과와 실제 거래 상태의 차이를 안내한 기존 답변

@토스플레이스-개발자센터 답변해주셔서 감사합니다

안녕하세요. 토스플레이스 개발자센터입니다. 문의 주신 기존 POS 연동과 결제 결과 수신 방법을 안내 드립니다. 1. 타사 POS 연결 방법 말씀하신 ‘가맹점 등록’이 프론트 온보딩 과정의 ‘타사 POS’ 연결 조합 선택을 의미하신다면, 플러그인 연동 시 해당 선택지가 표시되지 않는 것이 맞습니다. 이 경우 온보딩에서 ‘타사 POS’를 선택하는 대신, 플러그인에 시리얼 통신 코드를 추가하여 POS/VAN의 요청을 처리하도록 구성해 주세요. 공개 멀티패드 예제처럼 시리얼 포트를 열고, 수신한 데이터를 van.write로 전달하는 방식입니다. POS/VAN의 통신 속도와 사용 중인 SDK 버전에 맞춰 적용한 뒤 연결 동작을 확인 부탁 드립니다. Serial API 안내 · 멀티패드 연동 예제 기존 POS 연결과 플러그인 사용에 대한 이전 답변도 참고해 주세요. 2. 외부 POS 결제 결과 수신 외부 POS가 진행한 모든 결제를 자동으로 조회·구독하는 공식 Front SDK API는 제공되지 않습니다. Payment API의 getPayment는 플러그인 결제의 paymentKey로 결과를 조회하는 기능입니다. 포인트 적립에 필요한 금액·승인번호·거래일시·승인/취소 구분·결제수단은 승인 결과를 보유한 POS 또는 VAN 연동 시스템에서 자사 서버로 전달하고, 플러그인이 해당 서버와 연동하는 구성을 우선 검토해 주세요. Payment API 안내 3. Serial API 사용 intercept: false는 기존 결제 전문을 복제해 읽기만 하는 전용 모니터링 옵션이 아닙니다. 이 설정만으로 기존 결제에 영향을 주지 않으면서 전문 전체를 관찰할 수 있다고 보기는 어렵습니다. 공개 멀티패드 예제는 intercept: true로 열고, serial.listen으로 받은 데이터를 van.write에 전달합니다. 해당 구성에서는 van.write를 사용하시고, serial.handle을 동일한 처리 경로로 간주해 대체하지 말아 주세요. van.write 완료는 전문 전달 완료이며, 결제 승인 완료를 의미하지 않습니다. 통신 속도나 수신·전달 구성에 따라 기존 연동에 영향을 줄 수 있으므로, 1번의 예제와 설정을 기준으로 확인해 주세요. 4. 결제 이후 적립 화면 결제 화면 종료 후 플러그인 화면에서 적립 결과를 표시하는 구성을 검토할 수 있습니다. 다만 화면 복귀와 결제 성공은 별개이므로, POS 또는 자사 서버에서 확인한 승인 결과를 기준으로 적립해 주세요. 결제 화면 표시 중 JavaScript·타이머가 항상 중단 없이 실행된다고 전제하지 말고, 화면 복귀 후 거래 상태를 다시 확인할 수 있도록 구성해 주세요.

답변 감사합니다~

안녕하세요. 토스플레이스 개발자센터입니다. 문의하신 POS 워커 플러그인의 로그 보관 방식에 대해 안내 드립니다. 1. IndexedDB 사용 및 보관 범위 IndexedDB는 브라우저 표준 기능이며, 토스플레이스 SDK에서 공식 제공하는 저장소 기능은 아닙니다. IndexedDB 이용에 따른 데이터 보존·삭제와 동작 안정성은 토스플레이스에서 보장하는 범위가 아니므로, 상세 답변 드리기 어려운 점 양해 부탁 드립니다. 사용 가능 용량, 플러그인 업데이트·POS 재시작·POS 앱 업데이트 후 데이터 유지, 7일 이상 보관 여부나 권장 보관 기간도 보장하여 안내 드리기는 어렵습니다. 2. SDK Storage API Storage API는 간단한 문자열 데이터를 저장·조회·삭제하는 기능입니다. 객체나 배열은 문자열로 변환해 저장할 수 있습니다. 저장 범위: 각 POS 단말의 앱별 저장소입니다. 같은 매장의 다른 POS나 다른 앱과 자동 공유되지 않습니다. 용량: 키 개수, 값 하나의 크기, 전체 용량의 수치 상한은 공개 가이드에 명시되어 있지 않습니다. 무제한 저장이 가능하다는 의미는 아닙니다. 데이터 유지: 단순 POS 재시작이나 동일 앱의 플러그인 버전 변경만으로 초기화하는 방식은 아닙니다. 다만 POS 앱 업데이트 전후나 삭제·재설치 후의 보존을 보장하는 공개 기준은 없으므로, 장기 보관이 필요한 로그의 유일한 백업 수단으로 사용하지 않도록 권장합니다. 호출 제한: 공개 가이드는 이벤트 구독 외 요청에 60초 100회, 30분 200회 제한을 안내하며, Storage에 대한 예외는 명시하지 않습니다. 해당 기준을 고려해 호출량을 관리해 주세요. 대용량 로그를 안정적으로 저장·조회하는 용도로 제공되는 기능은 아닌 점 고려해 주세요. Storage API 가이드와 호출 제한 가이드를 참고해 주세요. 앱별 저장소가 분리되는 점은 기존 포럼 답변의 2번 항목에서도 안내 드렸습니다. 3. 로그 보관 권장 방식 공개 가이드에서 권장하는 방식은 Sentry 또는 솔루션사 로그 수집 서버를 이용하는 것입니다. 단말 내부에서 로그를 7일 이상 보관하도록 보장하는 별도 SDK 기능은 안내되어 있지 않습니다. 7일 이상 보관해야 하는 백업 로그는 별도 수집 서버에서 보관 기간과 용량을 관리하는 구성을 권장합니다. 개인정보·카드번호·결제 인증정보 등 민감정보는 로그에 기록하지 않도록 해 주세요. POS 로그 수집 가이드를 참고 부탁 드립니다.

안녕하세요. 토스플레이스 개발자센터입니다. 자사 매장에 사용하는 경우에도 개발자센터 등록만으로 바로 설치되는 것은 아니며, 라이브 검수·배포와 VAN 대리점의 앱 활성화가 필요합니다. 개발자센터에서 플러그인을 라이브 검수 요청하고, 승인 후 배포해 주세요. 앱 이름·ID와 이용 중인 VAN 대리점의 명칭·사업자번호를 developer-support@tossplace.com으로 전달해 주세요. 해당 대리점에서 앱을 활성화할 수 있도록 권한 연결을 요청하는 절차입니다. 권한 연결 후 VAN 대리점에서 해당 매장의 플러그인 사용을 ON으로 설정하고, 프론트에서 재온보딩하여 적용해 주세요. 자세한 절차는 검수·배포 및 앱 설치 가이드를 참고해 주세요. 자체 매장 1곳에서 사용하는 경우에도 같은 절차가 필요하다는 내용은 기존 포럼 답변에서도 안내 드렸습니다.

안녕하세요. 토스플레이스 개발자센터입니다. 토스 POS SDK로 주문을 취소하는 경우에도 취소 주문서가 출력되도록 업데이트할 예정입니다. 1. 변경 내용 기존에는 POS SDK를 통해 주문을 취소해도 취소 주문서가 출력되지 않았으나, 업데이트 후에는 매장의 ‘취소 주문서 출력’ 설정에 따라 출력됩니다. POS SDK로 주문 취소 기능을 연동한 솔루션사에서는 기존에 나오지 않던 취소 주문서가 출력될 수 있다는 점을 참고해 주세요. 2. 출력 설정 변경 방법 취소 주문서 출력이 필요하지 않은 경우, 아래 경로에서 설정을 해제해 주세요. 토스 POS → 기타 설정 → 주방 주문서 → 기타 출력설정 → ‘취소 주문서 출력’ 체크 해제 감사합니다.

POS 플러그인 SDK의 업데이트 내역을 안내드려요. 0.0.31 테이블 [신규] move 추가 주문을 다른 테이블로 이동해요. 전체 변경 이력은 POS 플러그인 SDK 릴리즈 노트에서 확인할 수 있어요.

안녕하세요. 토스플레이스 개발자센터입니다. 문의 주신 프린터 지원 범위와 연결 조건을 항목별로 안내 드립니다. 1. 지원 프린터 기종 외부 프린터는 일반적으로 시리얼 포트 연결을 지원하는 경우 프론트와 연동할 수 있습니다. 다만 모든 제조사·기종의 호환성을 보장하지는 않으므로, 사용하실 프린터로 실제 연결 및 주방 주문서 출력이 정상 동작하는지 직접 확인 부탁 드립니다. 동일 모델이라도 연결 옵션까지 확인해 주세요. 2. OS별 연결 방식 POS에 직접 연결하는 방식과 프론트를 거쳐 연결하는 방식은 구분해야 합니다. POS 직접 연결 설정은 운영체제와 앱 버전에 따라 다음과 같이 구분됩니다. Windows·macOS: 시리얼, USB 등 OS에 등록된 프린터 장치, 네트워크 유·무선 연결 iOS: Bluetooth, 네트워크 유·무선 연결 Android: Bluetooth, 네트워크 유·무선 연결. USB는 POS 앱 1.23.7 이상에서 연결 설정 제공 다만 모든 프린터 기종이 모든 POS 환경에서 사용 가능하다고 보장해드리기 어렵습니다. 사용하실 프린터와 POS 환경에서 실제 연결 및 출력 동작을 직접 확인 부탁 드립니다. 3. POS 직접 연결과 프론트 경유 연결 POS 직접 연결: 프린터를 POS 기기에 연결하고, 해당 연결 유형으로 등록하는 방식입니다. 프론트 경유 연결: 프린터를 프론트의 시리얼 포트에 연결하고, POS에서 연결 유형을 ‘토스 프론트’로 선택하는 방식입니다. 모델명만으로 연결 방식을 구분하기보다는 프린터의 실제 연결 옵션과 사용하실 POS 환경을 함께 확인해 주세요. 4. 드라이버·펌웨어 및 권장 설정 POS에 프린터 장치로 직접 연결하는 경우에는 사용하는 OS에서 프린터가 정상적으로 인식되는지 확인해 주세요. 드라이버와 펌웨어는 해당 모델·OS에 맞는 제조사 안내를 확인 부탁 드립니다. 프론트 시리얼 연결은 프린터 연결 가이드에 따라 통신 속도를 9600으로 맞추고 테스트 출력해 주세요. 이후 주방 주문서 설정 가이드에 따라 출력 여부와 매수를 설정해 주세요. 감사합니다.

안녕하세요. 토스플레이스 개발자센터입니다. 개발자센터의 ‘테스트 매장’ 목록과 실제 운영 매장 등록·관리는 별개이며, 테스트 매장 5개 한도가 운영 매장 수를 제한하는 것은 아닙니다. 신규 운영 매장 등록은 담당 VAN 대리점을 통해 진행해 주세요. 이미 토스플레이스를 이용 중인 매장은 새로 만들지 않고 기존 매장에 플러그인을 연결하시면 됩니다. POS 플러그인은 아래 순서로 적용해 주세요. 운영용 앱의 라이브 검수·배포를 완료합니다. 개발자센터의 내 애플리케이션(포스)에서 서비스 코드를 확인합니다. 각 매장의 POS → 설정 → 기타설정 → 서비스 연동 → 서비스 코드로 연결에서 해당 코드를 입력합니다. 자세한 방법은 POS 서비스 설치 가이드를 참고 부탁 드립니다. 이전에 안내 드린 환경별 앱 구성·라이브 배포 답변도 함께 참고해 주세요. 운영 단말에 라이브 버전을 적용하려면 해당 단말이 테스트 단말기로 등록되어 있지 않은지도 확인 부탁 드립니다.

안녕하세요. 토스플레이스 개발자센터입니다. 문의 주신 환경별 배포와 ACL 설정, 이전 버전 복귀 방법을 안내 드립니다. 1. 개발·스테이징·운영 구성 앱은 추가 등록할 수 있으며, 앱마다 개발·라이브 배포를 구분합니다. 세 환경의 빌드와 ACL을 독립적으로 운영하시려면 환경별로 앱을 분리하는 구성을 제안 드립니다. 운영용 앱은 개발 배포가 아닌 검수 후 라이브 배포로 운영해 주세요. 2. 테스트 단말기별 버전 같은 앱의 개발 배포는 등록된 테스트 단말기에 공통으로 적용됩니다. 단말기마다 서로 다른 개발 버전을 지정하는 기능은 제공하지 않습니다. dev와 stg 빌드를 동시에 유지하려면 앱을 분리하고 각각 테스트 단말기를 등록해 주세요. 앱별 테스트 단말기 등록은 기존 답변도 참고해 주세요. 3. ACL 설정 ACL은 여러 URL을 줄바꿈으로 등록할 수 있습니다. 다만 같은 앱의 개발·라이브 배포에 공통 적용됩니다. 개발용 URL을 삭제하면 해당 앱의 개발 배포에서도 접근할 수 없으므로, 환경별 허용 목록까지 분리하려면 앱을 나눠 주세요. ACL 설정 가이드 4. 실행 환경 구분 공개 SDK는 개발·라이브 구분값을 제공하지 않으며, getPluginInfo에서는 이름과 버전을 조회할 수 있습니다. 서버 주소와 Sentry 설정은 현재처럼 환경별 빌드 설정으로 구분해 주세요. Plugin API 5. 라이브 검수 및 이전 버전 복귀 검수는 매주 월·목요일, 근무일 기준으로 진행되며, 검수 승인 후 라이브 배포할 수 있습니다. 이전 버전으로 되돌리는 롤백 기능은 제공하지 않습니다. 이전 코드로 복귀가 필요하면 정상 동작하던 코드를 신규 버전으로 업로드한 뒤, 검수·배포하는 방식을 권장합니다. 배포 후 POS를 새로고침하거나 재시작하여 변경 사항을 반영해 주세요. 검수·배포 가이드

Open API의 업데이트 내역을 안내드려요. 2026-11-01 데이터 내보내기 (Data Export) API가 추가되었어요. 주문·결제 내역, 매장 카탈로그 등 토스 POS가 제공하는 데이터를 대량으로 조회 및 추출할 수 있는 기능을 제공해요. 자세한 사항은 문서를 참고해주세요. 전체 변경 이력은 Open API 릴리즈 노트에서 확인할 수 있어요.

안녕하세요. 토스플레이스 개발자센터입니다. 기존 NVCAT 결제를 유지하면서 프론트 플러그인을 함께 사용하는 방법을 안내 드립니다. 1. 멀티패드 연동 구성 현재 구성에서는 플러그인에서 시리얼로 받은 NVCAT 전문을 프론트 내부 VAN 처리 기능으로 전달하는 멀티패드 연동이 필요합니다. 포인트 적립 화면만 구현하는 것과 별도로, 아래 결제 요청 전달 흐름을 구성해 주세요. 외부 POS·NVCAT → 시리얼 수신 → 플러그인 → sdk.van.write → 프론트 내부 VAN 처리 2. 확인할 설정 sdk.serial.open 호출 시 intercept: true를 설정하고, 통신 속도는 NVCAT 측 설정과 맞춰 주세요. sdk.serial.listen으로 수신한 전문을 sdk.van.write로 전달하는지 확인해 주세요. NVCAT에서 일반 카드 리딩 요청이 아닌 통합결제창을 호출하도록 구성되어 있는지 확인 부탁 드립니다. 구현 방법은 Serial API 가이드와 멀티패드 연동 예제를 참고해 주세요. 기존 POS·VCAT 연동과 프론트 직접 승인 방식의 차이는 이전 관련 답변에서도 확인하실 수 있습니다. 위 구성을 확인한 후에도 반응이 없다면 앱 ID, 프론트 시리얼번호, 재현 날짜·시각, NVCAT 호출 명령을 developer-support@tossplace.com으로 전달 부탁 드립니다. 단말 식별정보는 공개 게시글에 남기지 말아 주세요. 감사합니다.

안녕하세요. 토스플레이스 개발자센터입니다. 사업자 변경 이후 현재 매장의 merchantId를 확인하는 방법을 안내 드립니다. 1. merchantId 변경 여부 merchantId는 사업자번호가 아닌 매장 식별값입니다. 사업자 변경 과정에서 새 매장으로 등록하고 해당 매장으로 다시 로그인한 경우에는 기존과 다른 merchantId를 사용하게 됩니다. 2. 현재 매장의 merchantId 확인 방법 프론트 플러그인에서 sdk.app.getMerchant()를 호출한 응답의 id로 현재 로그인된 매장의 merchantId를 확인하실 수 있습니다. 함께 반환되는 매장명과 사업자번호도 대조해 주세요. 매장 정보 조회 가이드 웹훅에서 받은 merchantId로 Open API 매장 정보 조회를 호출하여 해당 매장명·사업자번호를 확인하는 방법도 있습니다. 3. 개발자센터에 기존 매장 ID가 표시되는 경우 테스트 가맹점 목록은 개발자센터 계정에 연결된 매장 정보이므로, 현재 단말에 로그인된 매장과 다를 수 있습니다. 현재 단말에서 조회한 매장 정보와 웹훅의 merchantId를 먼저 대조해 주세요. 변경 후 매장이 불러오기 목록에 표시되지 않는다면 개발자센터 계정과 연결할 매장의 사업자번호가 일치하는지도 확인 부탁 드립니다. 관련 내용은 이전 테스트 가맹점 연결 안내를 참고해 주세요.