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

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

안녕하세요. 토스플레이스 개발자센터입니다. 프론트 플러그인 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 감사합니다.

안녕하세요. 토스플레이스 개발자센터입니다. 문의하신 프론트 결제 주문의 상품명 변경에 대해 안내 드립니다. 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만으로 프론트 결제 주문의 상품명을 실제 상품명으로 지정하거나 변경하는 방식은 지원되지 않습니다. 프론트 결제 가이드 솔루션사 시스템에서 상품정보와 결제 결과를 연결해 관리할 수는 있으나, 이 방식이 토스 매출 내역이나 영수증의 상품명을 변경하는 것은 아닙니다.

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

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

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

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

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

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

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

안녕하세요. 토스플레이스 개발자센터입니다. 1. getHalls 반환 형식 가이드상 반환값은 홀 목록 배열(PluginHall[])입니다. 각 항목에는 id(홀 ID), title(홀 이름), order(정렬 순서)가 포함됩니다. Table API 가이드를 참고해 주세요. 2. SDK 지원 버전 getHalls는 SDK 0.0.19에서 추가되었으며, 사용 중인 0.0.27에도 포함되어 있습니다. SDK 변경 이력을 참고해 주세요. 3. 라이브 환경 로그 확인 운영 웹 워커는 운영 문제 해결 가이드에 따라 Sentry 등으로 수집한 로그를 기반으로 확인해 주세요. 이번 문의에서는 getHalls 호출 직후의 반환값 자료형, 배열 여부, 배열인 경우 항목 수, 검증에 실패한 지점과 오류 메시지를 확인 부탁 드립니다. 오류 로그만으로는 정상 완료된 호출의 반환값을 확인하기 어려울 수 있으므로, 해당 정보가 기록되어 있지 않다면 호출 결과를 직접 로그로 남기도록 구성해 주세요.

안녕하세요. 토스플레이스 개발자센터입니다. Open API 앱을 활성화하기 이전의 주문·결제 데이터도 조회할 수 있습니다. 데이터가 토스플레이스 서버에 저장되어 있으므로, 앱 설치 이후에 발생한 데이터만 조회되는 구조는 아닙니다. 1. 과거 데이터 조회 범위 앱이 연결된 매장의 서버 저장 데이터를 조회할 수 있으며, 앱 설치 시점이나 최근 몇 개월을 기준으로 조회기간을 제한하지 않습니다. 2. 한 번에 지정할 수 있는 기간 from~to 사이의 기간에 별도의 최대 일수 제한은 없습니다. 다만 두 값은 주문 생성 시각이 아니라 결제 내역이 변동된 시각을 기준으로 조회합니다. 주문 조회 가이드를 참고해 주세요. 3. 과거 주문을 여러 페이지로 조회할 때 한 페이지는 기본 100건, 최대 500건입니다. 호출량은 토큰이 최대 100개까지 충전되고 초당 10개씩 보충되는 방식으로 제한됩니다. 요청마다 토큰 1개를 사용하며, 한도를 초과하면 HTTP 429가 반환됩니다. 응답 헤더의 x-ratelimit-remaining과 x-ratelimit-reset을 확인해 호출 속도를 조정해 주세요. 호출량 제한 가이드를 참고해 주세요. 4. 결제 내역 조회 결제 내역도 앱 활성화 이전 데이터라는 이유로 조회가 제한되지는 않습니다. 주문 목록에서 주문 ID를 확인한 뒤, 주문의 결제건 모두 조회 API로 해당 주문의 결제 내역을 조회할 수 있습니다. 결제 조회 가이드를 참고해 주세요.

안녕하세요. 토스플레이스 개발자센터입니다. 별도 사업자인 체인점에도 기존 개발자 계정의 프론트 플러그인과 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를 별도 방식으로 교체하는 것은 아니며, 실제 기능 차이에 따른 수정 여부는 이 테스트를 기준으로 확인해 주세요.

안녕하세요. 토스플레이스 개발자센터입니다. 문의하신 내용은 Open API에서 제공하는 기능과 외부 단말 연동·가맹·정산 계약에 따라 확인해야 하는 사항으로 나눠 안내 드립니다. 1. 외부 단말 연동과 데이터 수집 · 문의 2번 프론트 플러그인 SDK와 DLL은 토스 프론트 연동용이며, 듀얼아이 등 외부 리더기의 직접 연동 규격과는 다릅니다. 외부 리더기는 단말 모델, 부스 운영체제, 결제 모듈과 VAN·PG에 맞는 연동 규격을 확인해야 합니다. 2. 주문·단말 식별 · 문의 3번 Open API 결제 조회와 결제 웹훅에서는 merchantId, orderId, 결제 ID를 확인할 수 있지만, 결제 단말의 TID·시리얼 번호는 제공하지 않습니다. 여러 단말의 거래를 구분하려면 자체 연동 단계에서 부스·단말·주문번호와 결제 결과의 연결 정보를 관리해야 합니다. 외부 단말에 전달한 자체 주문번호를 Open API로 구성 가능한지는 연동가이드 스펙 혹은 직접 테스트 해주시어 검토 부탁 드리겠습니다. Open API 결제 가이드 3. 결제 취소와 응답 유실 · 문의 4번 프론트 플러그인은 전액 취소만 지원하며, 무카드 취소는 NICE의 카드 결제에서 원거래의 vanTransactionKey를 사용하는 방식입니다. 이 조건을 외부 리더기에 동일하게 적용할 수는 없습니다. Open API에서는 취소된 결제의 기존 결제 ID를 유지하고 상태와 취소 시각을 갱신합니다. 다만 Open API의 결제 취소 기록 기능은 실제 카드 승인을 취소하는 기능이 아닙니다. 프론트 SDK는 같은 paymentKey로 getPayment·getPaymentCancel을 호출해 단말에 저장된 승인·취소 성공 결과를 다시 확인할 수 있습니다. 이는 실시간 VAN 거래 조회가 아니므로, 조회 결과가 없다는 이유만으로 거래 실패를 단정하면 안 됩니다. 외부 리더기의 응답 유실 확인 방법은 해당 결제 모듈의 규격을 따라야 합니다. 프론트 결제 API 가이드 · 결제 테스트 가이드 4. 승인시각·과거 내역·호출 한도 · 문의 5·7번 approvedAt은 결제 승인시각이며, 매장의 영업 마감일자가 아닙니다. 초·밀리초 단위의 숫자가 아니라 ISO 8601 문자열이며, 끝에 Z가 붙은 값은 UTC 기준입니다. POS의 영업일별 매출 집계 기준은 이 필드와 구분해야 합니다. 앱 설치 이전이라도 토스 서버에 저장된 해당 매장의 주문·결제 내역은 조회할 수 있습니다. 구체적인 보관기간은 조회 기능과 별도로 확인이 필요합니다. 주문 목록은 페이지당 최대 500건입니다. 호출 한도는 매장별로 토큰을 초당 10개 충전하고 최대 100개까지 보유하는 방식입니다. 대량 조회도 응답의 잔여 호출량과 429 응답을 확인해 속도를 조절해 주세요. Open API 공통 가이드 5. PG 구분과 정산 자료 · 문의 6·8·9번 settlementType의 PG는 결제수단이 아니라 정산 주체의 종류를 뜻합니다. settlementSubject는 정산 주체를 나타내는 문자열이며, 고정된 전체 값 목록은 제공중이지 않습니다. PG 상세에는 토스페이먼츠가 포함될 수 있고, 값이 제공되는 경우 pgDetails의 provider와 transactionId로 PG사와 거래 ID를 확인할 수 있습니다. 두 서비스의 거래 ID가 동일하다는 의미는 아닙니다. 현재 Open API는 결제 건별 실제 차감 수수료, 입금 예정일·예정액, 실제 입금 내역을 제공하지 않습니다. 따라서 실제 수수료를 반영한 점포별 정산에는 별도의 정산 자료가 필요합니다. Open API 결제 가이드 아래 토스페이먼츠 PG 거래에 관한 아래 항목은 토스페이먼츠 계약·도입 담당자에게 문의 부탁 드립니다. 매장별·결제 건별 실제 수수료와 정산 자료 제공 범위 및 제공 방식 정산금의 입금 단위·일정·통장 적요와 매장별 구분 방법 토스플레이스 결제 내역과 페이먼츠 정산 자료의 중복 집계 여부 및 거래 대조 기준 토스페이먼츠에는 별도의 정산 조회 API가 있습니다. 다만 이번 외부 단말 결제에도 해당 API를 적용할 수 있는지는 페이먼츠 측에 확인해 주세요. 카드사에서 직접 정산받는 거래는 해당 카드사·VAN 또는 대리점에 확인해야 합니다. 토스페이 거래도 페이먼츠 PG를 경유하는지에 따라 확인 창구가 달라지므로, 모든 토스페이 정산을 토스페이먼츠 정산과 동일하게 보시면 안 됩니다. 6. 매장 개설·단말 제공·계약 조건 · 문의 1·10·11번 토스페이먼츠 오프라인 결제 도입을 검토 중이라면 아래 사항은 페이먼츠 계약·도입 담당자에게 먼저 문의 부탁 드립니다. 해당 도입 상품의 대형가맹점 판정 기준, 온라인 카드 매출 합산 여부 및 단말 구매·임대 조건 회사 명의 단말을 다른 사업자가 운영하는 점포에 설치하고, 결제대금을 가맹점주에게 정산하는 구조의 허용 여부와 심사 조건·필요 서류 토스페이먼츠의 사업자 정보·정산 계좌 변경 절차 및 계약 해지·이용 정지에 따른 영향 또한 두 서비스 간 정보 변경의 자동 반영 여부와 계약의 상호 영향은 토스플레이스와 토스페이먼츠 각각의 계약 기준으로 확인해야 합니다. 특히 회사 명의로 결제받은 금액을 가맹점주에게 정산하는 구조는 기술 연동 가능 여부와 별도로 사전 확인이 필요합니다.

안녕하세요. 토스플레이스 개발자센터입니다. 현재 외부결제 내역에는 플러그인 앱 이름이 등록되며, 앱 이름과 별도로 결제수단명을 지정하는 기능은 제공하지 않습니다. 외부결제 등록: Payment API의 payment.add로 EXTERNAL 결제를 등록할 때는 앱 이름을 사용합니다. 별도의 결제수단명을 입력하는 필드는 제공되지 않습니다. 결제 화면의 표시명: PaymentMethod API의 paymentMethod.add에서는 data.paymentName으로 POS 결제 화면에 표시할 결제수단 이름을 지정할 수 있습니다. 다만, 이는 선택 화면의 표시명이며 결제내역에 등록되는 앱 이름을 변경하는 기능은 아닙니다. 위 동작은 WebSocket 사용 여부와 관계없이 동일합니다. 자세한 내용은 Payment API 가이드와 PaymentMethod API 가이드를 참고해 주세요.

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

안녕하세요. 토스플레이스 개발자센터입니다. 숫자 입력 화면의 초기값과 입력 방식에 대해 안내 드립니다. 1. 초기값과 초기화 파라미터 현재 SDK에서 숫자 입력 화면의 초기값은 빈 문자열이며, 0을 기본값으로 넣도록 구성되어 있지 않습니다. 전달해 주신 코드에 value 또는 defaultValue가 없어서 0이 표시되는 것은 아닙니다. 현재 공개된 파라미터에는 초기값을 지정하거나 입력값을 강제로 초기화하는 항목이 없습니다. value, defaultValue를 추가하는 방식은 지원하지 않습니다. 2. text 타입으로 변경하는 경우 최상위 type을 text로 변경하면 일반 문자 입력용 키보드를 사용하므로, 현재의 숫자 전용 키패드를 유지하는 방식은 아닙니다. 또한 이 변경만으로 문의하신 현상이 해결된다고 안내하기는 어렵습니다. 3. 현상 확인에 필요한 정보 현재 제공된 정보만으로는 간헐적인 0 표시의 원인이나 템플릿 수정 필요 여부를 확정할 수 없습니다. 실제 단말기 로그와 적용 버전을 확인할 수 있도록 앱 ID, 적용한 플러그인 버전, 프론트 시리얼번호·앱 버전, 최근 발생 일시(한국 시간)를 개발자센터 메일로 전달 부탁 드립니다. 공개 입력 항목은 입력화면 템플릿 가이드를 참고해 주세요.

안녕하세요. 토스플레이스 개발자센터입니다. 통합결제창의 할부개월 설정과 선택 화면에 대해 안내 드립니다. installment의 의미 카드 결제에 사용할 초기 할부개월 값이며, 0은 일시불입니다. 결제수단을 미리 선택하는 값은 아니며, 통합결제창에서 카드 결제를 진행할 때 사용됩니다. 프론트에서 할부개월 선택 5만 원 이상 카드 결제 시 프론트의 서명 화면에서 할부개월을 선택할 수 있습니다. ‘할부’ 항목을 누르면 선택 화면이 열리고, 고객이 선택한 값으로 승인이 요청됩니다. 따라서 별도 할부 입력 화면을 개발하거나 표시 옵션을 추가할 필요는 없습니다. installment를 생략하거나 0으로 전달해도, 위 조건에서는 고객이 할부개월을 변경할 수 있습니다. 실제 할부 승인 가능 여부는 카드사·카드 조건에 따라 달라질 수 있습니다. 결제 API 가이드

안녕하세요. 토스플레이스 개발자센터입니다. 문의 주신 결제 오류 발생 후 화면 동작과 재결제 처리 방식에 대해 안내 드립니다. 예외 반환 후 오류 화면이 유지되는 이유 결제 실패 결과를 플러그인에 전달하는 처리와 프론트 결제창을 닫는 처리는 별개입니다. 따라서 catch가 실행된 뒤에도 오류 안내 화면이 잠시 표시될 수 있습니다. 현재 구현상 해당 화면은 약 3초 뒤 자동으로 닫힙니다. ‘다른 수단으로 결제’ 버튼의 동작 해당 버튼은 현재 결제창을 닫고 플러그인 화면으로 돌아가는 기능입니다. 버튼을 누르는 것만으로 결제수단 선택이나 재결제가 자동으로 진행되지는 않습니다. 이미 실패로 종료된 requestPayment에는 이후 결제 결과가 추가로 전달되지 않습니다. 재결제하려면 새로운 paymentKey로 requestPayment를 다시 호출하고, 새 요청의 결과를 처리해 주세요. 결제 요청 가이드 Template API를 통한 화면 전환 catch에서 Template API로 플러그인 화면을 변경할 수 있지만, Template API 호출만으로 프론트의 결제 오류 화면이 닫히지는 않습니다. 변경한 플러그인 화면은 결제창이 닫힌 뒤 표시됩니다. 오류 화면을 즉시 닫아야 한다면, 프론트 앱 2.71 이상에서 canCancelPayment로 종료 가능 여부를 확인한 뒤 cancelPayment를 호출할 수 있습니다. canceled가 true인지 확인하고, 화면 전환은 오류 처리 흐름 한 곳에서만 실행해 중복 처리를 방지해 주세요. 여기서 cancelPayment는 결제창을 닫는 기능이며, 승인된 결제를 취소하는 기능과는 다릅니다. 결제창 닫기 가이드