콘텐츠로 건너뛰기

자유 문의

74 토픽 187 게시물

프론트·POS 플러그인과 Open API의 개발 질문, 개선 의견, 활용 사례를 나누는 공간이에요.

  • 2 게시물
    10k 조회수
    토스플레이스-개발자센터토
    안녕하세요. 토스플레이스 개발자센터입니다. 문의 주신 알림음 재생 중 다른 앱의 소리를 조절하는 기능에 대해, 현재 지원 범위를 안내 드립니다. 1. Sound API 지원 범위 현재 Sound API에는 다른 앱의 소리를 자동으로 줄이거나 일시 정지한 뒤 복원하는 옵션이 없습니다. volume은 플러그인에서 재생하는 알림음 자체의 음량을 조절하는 값이므로, 100으로 설정해도 음악 앱의 소리는 줄어들지 않습니다. Sound API 가이드를 참고 부탁 드립니다. 2. 토스 POS 자체 알림음 현재 토스 POS 알림음 설정에서도 다른 앱의 음량을 자동 조절하는 설정은 제공하지 않습니다. 알림음 자체의 음량·반복 횟수 등을 설정하는 방식입니다. 3. 현재 가능한 대안 플러그인에서 애플뮤직·유튜브뮤직의 재생 상태나 음량을 제어하는 API는 제공하지 않습니다. 탭 화면의 audioSession 설정 역시 Sound API에서 제공하는 옵션이 아닙니다. 매장에서는 음악 재생 기기와 POS를 분리하거나, 음악 음량을 낮추고 알림음을 반복 재생하는 방식을 고려해 주세요. 다만 이는 알림 중에만 음악을 자동으로 줄이는 기능과는 다른 운영상 대안입니다. 요청해 주신 기능 추가 사항은 내부 검토 후 안내 드릴 예정입니다.
  • requestPayment() 오류 처리와 화면 제어

    프론트 플러그인
    2
    2 게시물
    10k 조회수
    토스플레이스-개발자센터토
    안녕하세요. 토스플레이스 개발자센터입니다. 문의 주신 결제 오류 발생 후 화면 동작과 재결제 처리 방식에 대해 안내 드립니다. 예외 반환 후 오류 화면이 유지되는 이유 결제 실패 결과를 플러그인에 전달하는 처리와 프론트 결제창을 닫는 처리는 별개입니다. 따라서 catch가 실행된 뒤에도 오류 안내 화면이 잠시 표시될 수 있습니다. 현재 구현상 해당 화면은 약 3초 뒤 자동으로 닫힙니다. ‘다른 수단으로 결제’ 버튼의 동작 해당 버튼은 현재 결제창을 닫고 플러그인 화면으로 돌아가는 기능입니다. 버튼을 누르는 것만으로 결제수단 선택이나 재결제가 자동으로 진행되지는 않습니다. 이미 실패로 종료된 requestPayment에는 이후 결제 결과가 추가로 전달되지 않습니다. 재결제하려면 새로운 paymentKey로 requestPayment를 다시 호출하고, 새 요청의 결과를 처리해 주세요. 결제 요청 가이드 Template API를 통한 화면 전환 catch에서 Template API로 플러그인 화면을 변경할 수 있지만, Template API 호출만으로 프론트의 결제 오류 화면이 닫히지는 않습니다. 변경한 플러그인 화면은 결제창이 닫힌 뒤 표시됩니다. 오류 화면을 즉시 닫아야 한다면, 프론트 앱 2.71 이상에서 canCancelPayment로 종료 가능 여부를 확인한 뒤 cancelPayment를 호출할 수 있습니다. canceled가 true인지 확인하고, 화면 전환은 오류 처리 흐름 한 곳에서만 실행해 중복 처리를 방지해 주세요. 여기서 cancelPayment는 결제창을 닫는 기능이며, 승인된 결제를 취소하는 기능과는 다릅니다. 결제창 닫기 가이드
  • 2 게시물
    10k 조회수
    토스플레이스-개발자센터토
    안녕하세요. 토스플레이스 개발자센터입니다. 통합결제창의 할부개월 설정과 선택 화면에 대해 안내 드립니다. installment의 의미 카드 결제에 사용할 초기 할부개월 값이며, 0은 일시불입니다. 결제수단을 미리 선택하는 값은 아니며, 통합결제창에서 카드 결제를 진행할 때 사용됩니다. 프론트에서 할부개월 선택 5만 원 이상 카드 결제 시 프론트의 서명 화면에서 할부개월을 선택할 수 있습니다. ‘할부’ 항목을 누르면 선택 화면이 열리고, 고객이 선택한 값으로 승인이 요청됩니다. 따라서 별도 할부 입력 화면을 개발하거나 표시 옵션을 추가할 필요는 없습니다. installment를 생략하거나 0으로 전달해도, 위 조건에서는 고객이 할부개월을 변경할 수 있습니다. 실제 할부 승인 가능 여부는 카드사·카드 조건에 따라 달라질 수 있습니다. 결제 API 가이드
  • 3 게시물
    10k 조회수
    토스플레이스-개발자센터토
    안녕하세요. 토스플레이스 개발자센터입니다. SDK 오류의 해석, 취소 결과 확인과 재시도 기준, 추가로 문의하신 테스트 승인 처리에 대해 안내 드립니다. 1. 오류 필드와 UNKNOWN·2666의 의미 TossFrontSDKError의 name은 오류 유형, invokeName은 호출한 기능명, code는 전달된 오류 코드, message는 오류 설명, raw는 원본 오류 데이터입니다. UNKNOWN은 전달된 오류 데이터에 code가 없을 때 SDK가 사용하는 기본값입니다. 전달해 주신 예시도 raw에 message만 있어 UNKNOWN으로 표시됩니다. message 안의 2666을 SDK가 별도 code 필드로 변환하지는 않습니다. API별 파라미터·응답 및 조회 오류는 Payment API 가이드를 참고해 주세요. 2666의 정확한 원인과 발생 단계는 실제 단말기 호출·응답 로그 확인이 필요합니다. 현재 글에는 대상 단말기와 발생 시각이 없어 해당 거래 로그를 확인하지 못했습니다. 앱 ID, 프론트 시리얼번호·앱 버전, 사용 VAN, 발생 일시(한국 시간)를 개발자센터 메일로 전달 부탁 드립니다. 카드번호·현금영수증 식별번호 등 개인정보는 보내지 않으셔도 됩니다. 2. 예외 발생 후 실제 거래 상태 확인 SDK 예외나 UNKNOWN만으로 실제 승인·취소 여부를 일괄 판단하지 마세요. getPayment와 getPaymentCancel은 VAN에 거래 상태를 다시 조회하는 API가 아니라, 요청한 단말기에 저장된 성공 응답을 복구하는 API입니다. getPaymentCancel의 PAYMENT_NOT_FOUND는 해당 paymentKey의 취소 성공 응답이 단말 캐시에 없다는 뜻이지, 실제 거래가 취소되지 않았다는 확정 결과는 아닙니다. 캐시는 성공 결과만 저장하며, 보관기간 만료나 저장 가능한 건수 제한 등의 영향도 받습니다. 먼저 취소를 요청한 동일 단말기에서 원래 paymentKey로 조회해 주세요. 결과를 복구하지 못하면 자동 재시도를 멈추고, 원승인번호·승인 시각·금액을 기준으로 VAN 대리점을 통해 실제 승인·취소 상태를 확인해 주세요. 승인 캐시와 취소 캐시는 별도이므로, getPayment에 승인 결과가 남아 있다는 이유만으로 미취소로 판단하지 않아야 합니다. 3. 동일 paymentKey로 재요청하는 경우 같은 paymentKey를 전달하는 것만으로 중복 거래가 자동 차단되지는 않습니다. 결과가 미확정인 상태에서는 자동으로 승인·취소를 반복하지 마세요. 취소 재요청은 원거래의 실제 상태를 먼저 확인하고 원승인 정보를 그대로 사용해야 합니다. 4. 테스트 현금영수증 승인 처리 실제 현금영수증을 발급한 테스트 건은 테스트 후 취소 처리해 주세요. 단순 화면·결제 흐름 확인이 목적이라면 현금 결제 > 현금영수증 미발급 방식으로 테스트하시는 것을 권장합니다. 자진발급 설정에 따라 실제 발급될 수 있으므로 응답의 cash.isCashReceipt도 확인해 주세요. 미취소 내역의 구체적인 처리 영향은 등록된 VAN·가맹점 조건에 따라 확인이 필요하므로, 해당 VAN 대리점에 확인 부탁 드립니다. 결제 테스트 가이드도 함께 참고해 주세요.
  • 2 게시물
    11k 조회수
    토스플레이스-개발자센터토
    안녕하세요. 토스플레이스 개발자센터입니다. 숫자 입력 화면의 초기값과 입력 방식에 대해 안내 드립니다. 1. 초기값과 초기화 파라미터 현재 SDK에서 숫자 입력 화면의 초기값은 빈 문자열이며, 0을 기본값으로 넣도록 구성되어 있지 않습니다. 전달해 주신 코드에 value 또는 defaultValue가 없어서 0이 표시되는 것은 아닙니다. 현재 공개된 파라미터에는 초기값을 지정하거나 입력값을 강제로 초기화하는 항목이 없습니다. value, defaultValue를 추가하는 방식은 지원하지 않습니다. 2. text 타입으로 변경하는 경우 최상위 type을 text로 변경하면 일반 문자 입력용 키보드를 사용하므로, 현재의 숫자 전용 키패드를 유지하는 방식은 아닙니다. 또한 이 변경만으로 문의하신 현상이 해결된다고 안내하기는 어렵습니다. 3. 현상 확인에 필요한 정보 현재 제공된 정보만으로는 간헐적인 0 표시의 원인이나 템플릿 수정 필요 여부를 확정할 수 없습니다. 실제 단말기 로그와 적용 버전을 확인할 수 있도록 앱 ID, 적용한 플러그인 버전, 프론트 시리얼번호·앱 버전, 최근 발생 일시(한국 시간)를 개발자센터 메일로 전달 부탁 드립니다. 공개 입력 항목은 입력화면 템플릿 가이드를 참고해 주세요.
  • 내 어플리케이션 삭제 방법

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

    1
    1 게시물
    11 조회수
  • [POS 플러그인] 외부결제 결제수단 명칭 수정

    pos 플러그인
    2
    2 게시물
    12k 조회수
    토스플레이스-개발자센터토
    안녕하세요. 토스플레이스 개발자센터입니다. 현재 외부결제 내역에는 플러그인 앱 이름이 등록되며, 앱 이름과 별도로 결제수단명을 지정하는 기능은 제공하지 않습니다. 외부결제 등록: Payment API의 payment.add로 EXTERNAL 결제를 등록할 때는 앱 이름을 사용합니다. 별도의 결제수단명을 입력하는 필드는 제공되지 않습니다. 결제 화면의 표시명: PaymentMethod API의 paymentMethod.add에서는 data.paymentName으로 POS 결제 화면에 표시할 결제수단 이름을 지정할 수 있습니다. 다만, 이는 선택 화면의 표시명이며 결제내역에 등록되는 앱 이름을 변경하는 기능은 아닙니다. 위 동작은 WebSocket 사용 여부와 관계없이 동일합니다. 자세한 내용은 Payment API 가이드와 PaymentMethod API 가이드를 참고해 주세요.
  • 3 게시물
    13k 조회수
    C
    @토스플레이스-개발자센터 빠르게 답변해주셔서 감사합니다. 개발자센터 계정과 사업자번호 및 단말기 정보 메일은 금일 오전에 전달하였습니다.
  • 외부 단말 연동 및 매장별 결제·정산 데이터 제공 범위 문의

    open-api
    2
    2 게시물
    13k 조회수
    토스플레이스-개발자센터토
    안녕하세요. 토스플레이스 개발자센터입니다. 문의하신 내용은 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번 토스페이먼츠 오프라인 결제 도입을 검토 중이라면 아래 사항은 페이먼츠 계약·도입 담당자에게 먼저 문의 부탁 드립니다. 해당 도입 상품의 대형가맹점 판정 기준, 온라인 카드 매출 합산 여부 및 단말 구매·임대 조건 회사 명의 단말을 다른 사업자가 운영하는 점포에 설치하고, 결제대금을 가맹점주에게 정산하는 구조의 허용 여부와 심사 조건·필요 서류 토스페이먼츠의 사업자 정보·정산 계좌 변경 절차 및 계약 해지·이용 정지에 따른 영향 또한 두 서비스 간 정보 변경의 자동 반영 여부와 계약의 상호 영향은 토스플레이스와 토스페이먼츠 각각의 계약 기준으로 확인해야 합니다. 특히 회사 명의로 결제받은 금액을 가맹점주에게 정산하는 구조는 기술 연동 가능 여부와 별도로 사전 확인이 필요합니다.
  • 이 토픽은 삭제되었습니다!

    1
    1 게시물
    6k 조회수
    답글이 없습니다
  • [POS 플러그인] 직원호출 기능 문의

    pos 플러그인 개발자센터
    4
    4 게시물
    13k 조회수
    김
    넵 감사합니다
  • 2 게시물
    13k 조회수
    토스플레이스-개발자센터토
    안녕하세요. 토스플레이스 개발자센터입니다. 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] 서비스 설치 이전 주문의 조회 가능 기간 문의

    open-api
    2
    2 게시물
    13k 조회수
    토스플레이스-개발자센터토
    안녕하세요. 토스플레이스 개발자센터입니다. Open API 앱을 활성화하기 이전의 주문·결제 데이터도 조회할 수 있습니다. 데이터가 토스플레이스 서버에 저장되어 있으므로, 앱 설치 이후에 발생한 데이터만 조회되는 구조는 아닙니다. 1. 과거 데이터 조회 범위 앱이 연결된 매장의 서버 저장 데이터를 조회할 수 있으며, 앱 설치 시점이나 최근 몇 개월을 기준으로 조회기간을 제한하지 않습니다. 2. 한 번에 지정할 수 있는 기간 from~to 사이의 기간에 별도의 최대 일수 제한은 없습니다. 다만 두 값은 주문 생성 시각이 아니라 결제 내역이 변동된 시각을 기준으로 조회합니다. 주문 조회 가이드를 참고해 주세요. 3. 과거 주문을 여러 페이지로 조회할 때 한 페이지는 기본 100건, 최대 500건입니다. 호출량은 토큰이 최대 100개까지 충전되고 초당 10개씩 보충되는 방식으로 제한됩니다. 요청마다 토큰 1개를 사용하며, 한도를 초과하면 HTTP 429가 반환됩니다. 응답 헤더의 x-ratelimit-remaining과 x-ratelimit-reset을 확인해 호출 속도를 조정해 주세요. 호출량 제한 가이드를 참고해 주세요. 4. 결제 내역 조회 결제 내역도 앱 활성화 이전 데이터라는 이유로 조회가 제한되지는 않습니다. 주문 목록에서 주문 ID를 확인한 뒤, 주문의 결제건 모두 조회 API로 해당 주문의 결제 내역을 조회할 수 있습니다. 결제 조회 가이드를 참고해 주세요.
  • 2 게시물
    13k 조회수
    토스플레이스-개발자센터토
    안녕하세요. 토스플레이스 개발자센터입니다. 판매할 때마다 상품과 옵션을 선택하는 과정에서, 플러그인 화면 공간이 좁아 불편을 겪고 계신 점 확인했습니다. 왼쪽 메뉴 접기·숨기기, 플러그인 화면 확대 등 화면 공간과 접근성 개선은 내부 검토 중입니다. 다만 현재 적용 여부와 일정이 확정되지 않아 구체적인 지원 시점을 안내 드리기 어렵습니다. 현재 공개된 플러그인 기능에는 POS의 왼쪽 메뉴를 직접 숨기거나, 기본 상품 선택 영역을 자체 UI로 교체하는 기능이 포함되어 있지 않습니다. 상품 등록·수정·삭제 API 역시 일반 제공 범위에는 포함되어 있지 않습니다. 전달해 주신 상품 검색·옵션 선택·결제로 이어지는 사용 흐름과 화면 공간 확보 필요성을 확인했습니다. 당장 적용 가능한 화면 확대 설정이나 상품 동기화 방식으로 안내 드리지 못하는 점 양해 부탁 드립니다.
  • 4 게시물
    15k 조회수
    토스플레이스-개발자센터토
    안녕하세요. 토스플레이스 개발자센터입니다. 추가로 문의 주신 세 가지 항목 안내 드립니다. 1. settlement로 카드 결제 여부를 판단할 수 있나요? settlementType이 ACQUIRER라는 이유만으로 카드 결제로 판단할 수는 없습니다. 정산 정보와 결제 재원 구분은 서로 다른 정보이므로, payType이 없는 건을 settlement 값으로 카드·선불로 확정하지 말아 주세요. 2. easyPayDetails.acquirer도 문자열 비교로 판단하면 안 되나요? 네. acquirer는 매입사명을 전달하는 문자열 필드이며, 가이드에도 ‘토스머니’와 같은 값이 예시로 포함되어 있습니다. 카드사명만 내려오는 고정 목록이 아니므로, 해당 이름을 비교해 카드·선불을 구분하지 않는 것이 맞습니다. 3. acquirerId는 어떤 코드인가요? acquirerId는 VAN사에서 전달한 값입니다. 토스플레이스의 공통 정규화 코드로 해석하지 말아 주세요. 별도의 코드표는 제공하지 않습니다. 따라서 기존에 안내 드린 것처럼, 구분 정보가 없는 건은 임의로 카드나 선불로 분류하지 않고 판별 보류로 처리해 주세요. 결제 데이터 가이드를 참고해 주세요.
  • 2 게시물
    13k 조회수
    토스플레이스-개발자센터토
    안녕하세요. 토스플레이스 개발자센터입니다. 별도 사업자인 체인점에도 기존 개발자 계정의 프론트 플러그인과 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를 별도 방식으로 교체하는 것은 아니며, 실제 기능 차이에 따른 수정 여부는 이 테스트를 기준으로 확인해 주세요.
  • 2 게시물
    13k 조회수
    토스플레이스-개발자센터토
    안녕하세요. 토스플레이스 개발자센터입니다. 현재 프론트 플러그인에서 페이스페이만 실행하는 전용 API·템플릿과 카드 결제만 실행하는 전용 화면은 별도로 제공하지 않습니다. 자체 POS에서 결제를 시작하더라도, 프론트 플러그인에서는 requestPayment로 통합 결제 화면을 호출하는 방식을 사용해 주세요. 문의 주신 페이스페이와 카드 결제도 이 화면에서 진행합니다. 결제 수단 제외 옵션인 excludePaymentTypes는 현재 현금(CASH)만 지원하므로, 이 옵션으로 페이스페이 또는 카드만 남기는 구성은 지원하지 않습니다. 자세한 호출 방법은 Payment API 가이드를 참고해 주세요.
  • 2 게시물
    13k 조회수
    violet.foxV
    안녕하세요, order.addMenu()의 dto.lineItems에는 새로 추가하는 항목만 넣어 주세요. 이미 저장된 항목까지 포함하면 그 항목이 한 번 더 반영됩니다. 기존 항목과 같으면 수량이 합산되고, 다르면 lineItem이 추가로 생성됩니다. 요청하신 예시 상황에서는 A를 다시 넣지 않고 B만 전달합니다. await sdk.order.addMenu(orderId, { discounts: [], lineItems: [ { ... item: { id: 2, title: 'B', ... }, ... }, ], }); 이미 저장된 주문 항목의 수량을 변경하거나 삭제하는 API는 현재 제공하지 않습니다. 감사합니다.
  • 개인 개발자 등록 문의

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