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

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

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

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

안녕하세요. 토스플레이스 개발자센터입니다. 문의 주신 프린터 지원 범위와 연결 조건을 항목별로 안내 드립니다. 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으로 맞추고 테스트 출력해 주세요. 이후 주방 주문서 설정 가이드에 따라 출력 여부와 매수를 설정해 주세요. 감사합니다.

안녕하세요. 토스플레이스 개발자센터입니다. 테스트 가맹점 로그인 조건과 현재 기기로 테스트하는 방법을 안내 드립니다. 테스트 가맹점이 모두 KIS 기기로만 제한되는 것은 아닙니다. 다만 로그인할 가맹점의 VAN과 프론트가 지원하는 VAN이 맞아야 합니다. 전달해 주신 기기의 로그에서도 KIS 지원 기기 안내와 함께 가맹점 인증이 거절된 내역을 확인했습니다. 현재 프론트의 VAN에 맞는 테스트 가맹점을 이용하는 방법으로 진행해 주세요. 단말을 공급한 VAN 대리점에 해당 VAN의 테스트 가맹점 생성을 요청하고, 생성된 가맹점 정보로 프론트에 로그인한 뒤 개발자센터에 연결하시면 됩니다. 기기 자체의 VAN 전환 가능 여부는 단말을 공급한 대리점에 확인 부탁 드립니다. 개발자센터 계정의 사업자번호 변경이 필요하면 아래 가이드의 필수 정보를 개발자센터 메일로 전달 부탁 드립니다. 자세한 절차는 테스트 가맹점 연결 가이드의 VAN 불일치 안내를 참고해 주세요.

안녕하세요. 토스플레이스 개발자센터입니다. 테스트로 만든 앱을 정리하기 어려우신 점과 삭제 기능에 대한 개선 요청을 확인했습니다. 현재 개발자센터에서는 생성한 애플리케이션을 직접 삭제하는 기능을 제공하지 않습니다. 앱 이름이나 설명을 정리하려면 ‘내 애플리케이션 > 해당 앱 > 정보 수정’에서 변경하실 수 있습니다. 같은 문의에 안내한 애플리케이션 삭제 관련 기존 답변도 함께 참고해 주세요. 기능 추가 여부나 제공 시점은 확정해 안내 드리기 어려운 점 양해 부탁 드립니다.

안녕하세요. 토스플레이스 개발자센터입니다. 탭 화면과 웹 워커 구성, 결제 후 화면 복귀 방법을 안내 드립니다. 1. 패키지와 앱 등록 현재 개발자센터에서는 실행 환경을 탭 화면 또는 웹 워커로 구분해 등록합니다. 탭 화면 앱과 웹 워커 앱을 각각 등록·배포하고, 같은 매장에 활성화하는 방식으로 구성해 주세요. ‘함께 사용하는 구조’는 두 역할을 연계한다는 의미이며, 파일을 한 ZIP에 넣는 것만으로 두 실행 환경이 함께 활성화되는 것은 아닙니다. 탭 화면 ZIP은 최상위에 iframe-manifest.json과 화면 파일을, 웹 워커 ZIP은 최상위에 main.js를 포함합니다. 각 탭 화면 가이드와 웹 워커 가이드의 샘플로 각각 빌드해 주세요. 2. 앱 간 데이터 전달 서로 다른 앱의 Storage는 공유되지 않습니다. 실행 중인 앱 간에는 Plugin Unicast API를 사용할 수 있으며, send(message, to)의 to에는 수신할 앱의 앱 ID(packageName)를 넣습니다. 탭이 닫힌 동안의 메시지를 나중에 자동으로 받는 구조로 의존하지 말고, 결제 결과는 서버에 저장해 탭을 다시 열 때 조회하도록 구성해 주세요. 3. 이동할 탭 지정 navigation.navigate('plugin-tab', packageName)의 packageName도 이동할 탭 앱의 앱 ID입니다. 해당 탭 앱에서 조회한 plugin.getPluginInfo().name과 같은 값이며, 화면에 표시되는 탭 제목이나 숫자 App ID가 아닙니다. 워커에서 조회한 name은 워커 자신의 ID이므로 그대로 넣지 않도록 주의해 주세요. 4. 결제 후 복귀 웹 워커에서 payment.on('paid')를 수신한 뒤, 해당 서비스의 주문인지와 전체 결제 완료 여부를 확인하고 탭 앱으로 이동해 주세요. 분할결제는 결제 건마다 이벤트가 발생하므로, 주문의 paymentPrice.paymentUnpaidValue가 0인지 확인하는 과정이 필요합니다. 같은 흐름을 안내한 기존 결제 이벤트 답변과 화면 자동 이동 공지를 함께 참고해 주세요. 개발 배포가 적용되지 않은 원인은 패키지에 main.js가 있다는 사실만으로 확정하기 어렵습니다. 해당 앱 ID, 개발 배포 버전 번호, POS 시리얼번호를 개발자센터 메일로 전달 부탁 드립니다. 발생 시간은 글에 남겨주신 10월 24일 11:50~12:10 KST 기준으로 확인하겠습니다.

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

안녕하세요. 토스플레이스 개발자센터입니다. 추가로 알려주신 KIS CAT 연결 구성을 기준으로 안내 드립니다. 1. Payment API 사용 조건 현재처럼 KIS-1421이 결제를 승인하고 프론트2는 멀티패드로만 사용하는 구성에서는 Payment API를 사용할 수 없습니다. Payment API를 사용하려면 프론트가 직접 결제를 승인하는 구성이어야 하며, 프론트에 TID를 포함한 매장정보 설정이 필요합니다. 기존 연결을 그대로 유지한 상태에서 Payment API만 추가하는 방식은 아니므로, 전환에 필요한 설정은 담당 KIS 대리점에 확인 부탁 드립니다. 2. 기존 CAT 결제의 웹훅 기존 KIS CAT에서 승인한 결제는 Open API 결제 웹훅으로 제공되지 않습니다. 결제 웹훅은 토스 POS·프론트 플러그인 등 토스 솔루션에서 처리한 결제를 대상으로 동작합니다. 토스 프론트를 카드 리더기로 사용한다는 이유만으로 외부 CAT의 승인 내역이 웹훅으로 전달되는 것은 아닙니다. 앞서 안내한 리더기 방식과 프론트 직접 승인 방식의 차이도 함께 참고해 주세요.

안녕하세요. 토스플레이스 개발자센터입니다. 후불형 매장의 현황 탭 설정과 Open API 주문의 결제 처리 범위를 안내 드립니다. 1. 현황 탭 활성화 말씀하신 순서가 맞습니다. 메뉴(☰) > 설정 > 현황 설정에서 ‘현황 기능 사용’을 켠 뒤, 현황 > 주문표시에서 해당 Open API 앱을 선택해 주세요. 2. 미결제 주문의 결제 처리 후불형 매장에서는 Open API로 생성한 OPENED 주문을 현황 화면에서 결제하는 경로를 제공하지 않습니다. 현황 기능을 켜더라도 해당 주문이 후불 테이블 주문에 자동으로 연결되거나 결제 버튼이 제공되는 것은 아닙니다. 테이블 기반 후불 주문과 POS 결제를 연계하려면 POS 플러그인 방식을 검토해 주세요. 앞서 안내한 현황 탭 설정은 주문을 표시하기 위한 설정이며, 후불 주문의 결제 연동과는 별개입니다. 3. 설정 전에 생성한 주문 현황 기능을 켜기 전에 생성한 당일 주문도 현재 주문 표시 조건에 맞으면 조회 대상입니다. 주문을 다시 생성할 필요는 없습니다. 해당 앱의 주문 표시 선택 여부와 당일 주문인지 먼저 확인해 주세요. 주문 생성·표시 가이드와 앞서 안내한 앱 선택·업종 확인 내용을 함께 참고해 주세요.

안녕하세요. 토스플레이스 개발자센터입니다. 애플리케이션 삭제와 재등록 방법에 대해 안내 드립니다. 현재 개발자센터에서는 생성한 애플리케이션을 직접 삭제하는 기능을 제공하지 않습니다. 앱 이름이나 설명을 잘못 입력하신 경우에는 내 애플리케이션 > 해당 앱 > 정보 수정에서 변경하실 수 있습니다. 별도의 앱이 필요하다면 기존 앱과 다른 앱 ID로 새로 등록해 주세요. 기존 앱의 삭제나 동일한 앱 ID의 재사용이 필요한 경우에는 개발자센터 계정 이메일, 대상 앱 ID, 변경하려는 내용을 개발자센터 메일로 전달 부탁 드립니다. 해당 요청의 처리 가능 여부를 확인하겠습니다.

@토스플레이스-개발자센터 빠르게 답변해주셔서 감사합니다. 개발자센터 계정과 사업자번호 및 단말기 정보 메일은 금일 오전에 전달하였습니다.

넵 감사합니다

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

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

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

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

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