### 어떤 제품을 사용하나요?

[시즌7]

어떤 제품을 사용하나요?

• 제품: 프론트 플러그인
• SDK 또는 API 버전: toss-front-plugin-template 기준 (window.TossFrontSDK)
• 환경: 개발

무엇이 궁금한가요?

안녕하세요. 토스 POS 없이, 저희 웹 서비스에서 [결제]를 누르면 매장의 토스 프론트에서 카드 결제가 되는 방식을 검토하고 있습니다.

생각한 흐름 (프론트 플러그인 템플릿의 payment.html 예제 기준):

1. 저희 웹에서 [결제] → 저희 서버에 결제 요청(금액·주문 번호) 저장
2. 토스 프론트의 저희 프론트 플러그인이 저희 서버를 폴링해 요청을 받음
3. sdk.payment.requestPayment({ paymentKey, supplyValue, tax, ... })로 결제
4. 결제 결과를 저희 서버에 올려 주문을 결제 완료로 처리

질문드립니다.

1. 토스 POS 없이 토스 프론트만 있는 매장에서 프론트 플러그인으로 결제(requestPayment)를 할 수 있나요? 토스 POS가 꼭 있어야 한다면 어떤 구성이 필요한가요?
2. 프론트 플러그인을 매장에 설치·활성화하는 방법이 궁금합니다. 등록한 프론트 앱에는 서비스 코드가 없어 대리점 활성화가 필요하다고 이해했는데,
   POS 플러그인처럼 매장주가 서비스 코드로 직접 연결하는 방법이 있나요? 라이브 검수를 통과하면 서비스 코드가 생기나요?
3. requestPayment 결과에 어떤 정보가 오나요? (승인번호, 카드사, 결제 시각 등) 결제 취소·환불도 프론트 플러그인에서 요청할 수 있나요?
4. 프론트 플러그인이 외부 서버(저희 API)와 통신할 때 ACL(서버 URL) 등록 외에 필요한 설정이 있나요? 폴링 간격 제한도 있는지 궁금합니다.
5. 이런 용도(외부 웹에서 결제 요청 → 토스 프론트에서 결제)에 더 적합한 방법(Open API 등)이 있다면 안내 부탁드립니다.

[토스플레이스-개발자센터]

안녕하세요. 토스플레이스 개발자센터입니다.

문의 주신 외부 웹 서비스와 토스 프론트의 결제 연동 구성에 대해 안내 드립니다.

1. 토스 POS 없이 결제하는 구성
토스 POS 없이도 프론트 플러그인에서 requestPayment로 결제를 요청할 수 있습니다.
다만 프론트가 직접 승인하는 구성이므로 매장 정보와 TID·VAN 설정이 필요합니다. 카드 리딩 정보만 외부 POS나 CAT에 전달하는 구성과는 구분해 주세요.

2. 매장 설치·활성화
프론트 플러그인은 운영 배포 후 연결된 VAN 대리점을 통해 매장에 활성화합니다. POS 플러그인처럼 매장주가 서비스코드를 입력해 직접 연결하는 방식은 제공하지 않으며, 라이브 검수 통과로 해당 방식이 추가되는 것은 아닙니다.
개발 테스트는 개발자센터에서 진행하고, 운영 매장 활성화 절차는 프론트 플러그인 배포 안내를 참고 부탁 드립니다.

3. 결제 결과 및 취소
카드 결제 성공 시 response.card에서 승인번호(approvalNumber), 승인 시각(timestamp), 발급사·매입사 정보를 확인할 수 있습니다.
원결제 정보를 저장한 뒤 requestPaymentCancel로 승인 취소를 요청할 수 있습니다. 결제수단별 응답과 취소에 필요한 값은 Payment API를 참고 부탁 드립니다.

4. 외부 서버 통신 및 폴링
외부 서버 주소의 ACL 등록 외에도 HTTPS 통신과 플러그인 도메인에 대한 서버 CORS 설정이 필요합니다.
연동가이드에서는 1초 간격 폴링을 권장하고 있습니다. 이는 권장 주기이며, 폴링 대신 자체 서버의 WebSocket이나 SSE를 활용하는 구성도 안내하고 있습니다.
외부 서버 통신 설정을 함께 확인 부탁 드립니다.

5. 권장 연동 방식
말씀하신 '웹에서 요청 저장 → 프론트 플러그인이 요청 수신 → Payment API 호출 → 결과를 자체 서버에 반영' 흐름으로 구성하시면 됩니다.
이번 결제 요청은 Open API로 대체하기보다 프론트 플러그인의 Payment API를 중심으로 구현해 주세요. 파트너 시스템 연동 가이드에서 해당 구성과 통신 방법을 확인하실 수 있습니다.

프론트가 승인 주체가 되기 위한 전제는 기존 유사 문의 답변도 참고 부탁 드립니다.

[시즌7]

이 게시물은 삭제되었습니다!

[시즌7]

어떤 제품을 사용하나요?

• 제품: 프론트 플러그인
• SDK 또는 API 버전: toss-front-sdk v0
• 환경: 개발

무엇이 궁금한가요?

토스 POS 없이 토스 프론트만으로 프론트 플러그인 결제(sdk.payment.requestPayment)를 하고 있습니다.
결제 후 손님에게 카드 매출전표를 주는 방법을 알고 싶습니다. 사용 중인 토스 프론트에는 출력 장치가 없습니다.

1. 프론트 플러그인 결제 건의 카드 매출전표는 어떻게 발행하나요? (출력·전자 영수증 등)
2. sdk.printer.printReceipt 는 매출전표를 출력하는 기능인가요? 넘겨야 하는 값(결제 응답 response 그대로인지, 필요한 필드)과 예시를 알려 주세요.
3. 토스 프론트에 외부 영수증 프린터를 연결할 수 있나요? 연결 가능한 프린터 종류와 프론트 설정 방법이 궁금합니다.

[토스플레이스-개발자센터]

안녕하세요. 토스플레이스 개발자센터입니다.

문의 주신 프론트 플러그인 결제 후 영수증 출력 방법을 안내 드립니다.

1. 카드 매출전표 출력
플러그인 결제 시 전자영수증은 지원하지 않습니다.
프론트에 프린터가 연결되어 있으면 결제 완료 후 기본 영수증 1장이 자동 출력됩니다. 추가 출력이나 재출력이 필요한 경우에는 Printer API의 printReceipt를 이용해 별도로 구현해 주세요.

2. printReceipt 호출값
결제 응답 전체가 아니라, 결제에 사용한 paymentKey와 출력 수량 count를 전달합니다.
1장 출력 시 paymentKey와 count: 1을 전달하시면 됩니다. 주문 정보 orderInfo와 추가 문구 additionalText는 선택 사항입니다. 파라미터와 호출 예제를 참고 부탁 드립니다.

3. 외부 프린터 연결
프론트에 연결한 시리얼·블루투스 프린터로 출력하는 경로가 있습니다. 유선 연결 예시는 CPP-3000이며, 프론트 Serial 포트에 연결한 후 프린터 설정에서 시리얼 케이블을 선택하고 테스트 출력으로 확인합니다.
사용할 프린터의 호환 여부는 구매·설치 대리점에 먼저 확인 부탁 드립니다. 연결 가이드의 유선 연결 및 프론트 설정 부분을 참고해 주세요. 해당 가이드의 POS 등록 단계는 현재 문의하신 프론트 단독 구성과 구분해 보셔야 합니다.

paymentKey로 결제 정보를 조회해 출력하는 방식은 기존 Printer API 답변도 참고 부탁 드립니다.