[프론트 플러그인] 다른 POS(KIS VAN)와 연동 중인 프론트 2에 플러그인 적용 시 기존 연동 유지 여부

[TY]

어떤 제품을 사용하나요?

• 제품: 프론트 플러그인 / Open API
• SDK 또는 API 버전: 개발 시작 전(문서 기준 검토 중)
• 환경: 개발

무엇이 궁금한가요?

매장에서 토스 프론트 2를 쓰고 있고, 카드 결제는 다른 POS 프로그램이 KIS VAN을 통해 단말기에 요청하는 방식입니다(토스 POS는 쓰지 않음). 개발자센터에서 테스트 가맹점(VAN: KIS)을 불러왔고 프론트 플러그인 앱을 만들었습니다.

자체 웹 시스템에서 프론트를 결제 단말기로 쓰려고 프론트 플러그인(플러그인이 저희 서버를 폴링하는 방식)을 개발하려 합니다. 자주 묻는 질문에서 테스트 단말기 등록에 재온보딩이 필요하고, 테스트·라이브는 재온보딩으로 오갈 수 있다는 것은 확인했습니다.

1. 다른 POS(KIS VAN)와 연동된 프론트에 프론트 플러그인이 켜지면 기존 연동은 어떻게 되나요? 함께 쓸 수 있는지, 플러그인 모드로 바뀌어 기존 연동이 끊기는지 궁금합니다.
2. 운영 중인 프론트를 테스트 가맹점으로 재온보딩했다가 원래 가맹점으로 다시 로그인하면, 다른 POS(KIS VAN)와의 결제 연동도 그대로 복구되나요?
3. 프론트만 쓰는 매장에서 다른 POS(KIS VAN 경유)로 한 결제도 Open API 결제 웹훅으로 오나요?

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

안녕하세요. 토스플레이스 개발자센터입니다.
문의하신 내용은 프론트가 카드 리더기로 동작하는 경우와, 프론트에서 직접 결제를 승인하는 경우를 구분해야 합니다.

1. 기존 POS 연동과 플러그인 사용
   프론트 플러그인을 리더기 모드로 구성해 기존 POS/VCAT의 결제 요청을 받는 방식도 있으므로, 플러그인을 사용한다는 이유만으로 기존 POS 연동이 반드시 끊기는 것은 아닙니다.
   다만, 자체 웹 시스템의 요청을 받아 프론트 Payment API로 결제하는 방식은 VCAT을 사용하는 리더기 모드와 다른 결제 경로입니다. 현재 KIS 연동과 이 결제 경로를 같은 단말기에서 병행할 수 있는지는 실제 연결 구성과 설정을 확인해야 합니다.

2. 테스트 후 운영 매장 복귀
   재온보딩으로 매장을 변경할 수는 있지만, 원래 매장에 다시 로그인하는 것만으로 기존 POS의 결제 연동 설정까지 그대로 복구된다고 확답드리기는 어렵습니다. 운영 단말기를 변경하기 전에 담당 VAN 대리점과 기존 연결 설정 및 복귀 절차를 확인해 주세요. 가능하면 별도 테스트 단말기를 사용하는 것을 권장드립니다.
   프론트 개발·테스트 가이드: https://docs.tossplace.com/guide/front-integration/plugin/develop/develop-tutorial.html

3. Open API 결제 웹훅
   프론트 플러그인에서 직접 처리한 결제는 해당 매장에 Open API 앱을 별도로 연결하고 웹훅을 설정하면 제공 범위 내에서 승인·취소 이벤트를 수신할 수 있습니다. 토스 POS가 없는 매장은 VAN 대리점을 통해 Open API 앱을 적용합니다.
   다만, 프론트가 카드 리딩만 수행하고 기존 POS/VCAT이 승인한 거래까지 모두 웹훅으로 제공된다는 의미는 아닙니다. 문의하신 KIS 결제 경로는 실제 구성을 구분해 확인해야 합니다.
   Open API 설치 가이드: https://docs.tossplace.com/guide/pos-integration/open-api/service-install.html
   프론트 FAQ: https://docs.tossplace.com/guide/front-integration/faq.html

현재 사용 중인 POS 프로그램명, KIS 결제모듈명·버전, POS와 프론트의 연결 방식, 그리고 기존 POS 결제와 자체 웹 시스템 결제를 같은 프론트에서 병행하려는 것인지 알려주시겠어요?

[TY]

@토스플레이스-개발자센터

답변 감사합니다. 문의하신 내용 답변드립니다.

• 병행 여부: 전환 기간에만 병행이고, 목표는 저희 본부(자체 웹 → Payment API) 결제만 쓰는 것입니다. 본부 화면과 연동을 검증하는 대략 1~3일 동안은 기존 POS 결제도 같은 프론트 2에서 계속 받아야 하고, 검증이 끝나면 POS 연동은 끊고 본부 결제만 씁니다.
• POS 프로그램: 핸드SOS(미용실 POS)
• VAN: KIS정보통신
• 연결: 핸드SOS 하드웨어 연동 설정 기준 데스크 PC COM7, 9,600bps(케이블 종류는 확인 중)
• KIS 결제모듈명·버전: 토요일에 매장에서 확인해볼게요

궁금한 점:

1. 플러그인을 '리더기 모드'로 두면서, 같은 플러그인이 저희 서버 요청으로 Payment API 결제도 처리하는 구성이 가능한지(가능하면 설정 방법·문서 위치)
2. 그 구성이 없다면 별도 테스트 단말기(대여·구매)를 쓰는 경로와 비용
3. 복귀 절차는 담당 VAN 대리점(KIS)에 확인하겠습니다. 대리점이 확인해야 할 항목이 있으면 알려 주세요.

[TY]

현장 확인 결과를 덧붙입니다. 저희 매장은 KIS정보통신 CAT 단말기 KIS-1421이 승인기이고, 토스 프론트 2는 KIS-1421의 핀패드 포트에 연결된 KIS 멀티패드(손님용 카드 리더기·화면, 프론트 TID 없음, VAN KIS)로 쓰이고 있습니다. POS는 핸드SOS(크롬 웹) → KisCat_Deamon 1.0.0.3 → COM 9600 → KIS-1421이고, 토스POS는 설치만 돼 있고 실행하지 않습니다.

질문:

1. 이 구성(프론트 = KIS 멀티패드)에서 프론트 플러그인을 켜고 Payment API로 직접 승인하려면 프론트에 별도 TID 발급·재온보딩이 필요한지, 그 뒤에도 KIS 멀티패드 역할이 유지되는지
2. 유지되지 않는다면 저희는 당분간 KIS CAT 연동(기존 POS와 같은 길)으로 가고 플러그인은 보류할 예정인데, 이 경우 Open API 웹훅은 받을 수 없는 것이 맞는지

병행 여부는 전환 기간에만 병행이고 목표는 본부 결제만입니다.

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

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

추가로 알려주신 KIS CAT 연결 구성을 기준으로 안내 드립니다.

1. Payment API 사용 조건
현재처럼 KIS-1421이 결제를 승인하고 프론트2는 멀티패드로만 사용하는 구성에서는 Payment API를 사용할 수 없습니다.
Payment API를 사용하려면 프론트가 직접 결제를 승인하는 구성이어야 하며, 프론트에 TID를 포함한 매장정보 설정이 필요합니다.
기존 연결을 그대로 유지한 상태에서 Payment API만 추가하는 방식은 아니므로, 전환에 필요한 설정은 담당 KIS 대리점에 확인 부탁 드립니다.

2. 기존 CAT 결제의 웹훅
기존 KIS CAT에서 승인한 결제는 Open API 결제 웹훅으로 제공되지 않습니다.
결제 웹훅은 토스 POS·프론트 플러그인 등 토스 솔루션에서 처리한 결제를 대상으로 동작합니다. 토스 프론트를 카드 리더기로 사용한다는 이유만으로 외부 CAT의 승인 내역이 웹훅으로 전달되는 것은 아닙니다.

앞서 안내한 리더기 방식과 프론트 직접 승인 방식의 차이도 함께 참고해 주세요.