[프론트 플러그인] 직접 개발한 플러그인을 체인점(다른 가맹점)에도 쓰는 절차 문의

[세탁플랜]

어떤 제품을 사용하나요?

• 제품: 프론트 플러그인 / Open API
• SDK 또는 API 버전: 프론트 SDK v1 (플러그인 '세탁플랜 스마트결제 프론트' laundryplan-front, 개발 배포 1.4.0), Open API v1 (laundryplan-pay)
• 환경: 개발 (테스트 가맹점으로 등록한 실제 매장)

무엇이 궁금한가요?

안녕하세요. 세탁플랜입니다.
저희가 직접 만든 프론트 플러그인을 저희 매장(프론트1 + 터미널1)에서 개발 배포로 매일 쓰고 있습니다.
이번에 같은 상호를 쓰는 체인점 한 곳에도 같은 플러그인과 Open API 앱을 쓰려고 합니다.

1. 라이브 검수 신청에 필요한 자료와 보통 걸리는 기간이 궁금합니다.
2. 라이브 배포 뒤 체인점 단말기에 켜려면 대리점 권한 연결이 필요하다고 들었습니다. 저희 매장을 담당하는 대리점과 같은 대리점에서 단말기를 사면 되는지, 다른 대리점이면 따로 연결 요청이 필요한지 알고 싶습니다.
3. 체인점의 Open API(결제 내역 조회)는 체인점이 직접 앱을 만들어야 하는지, 저희 앱을 서비스 코드로 설치하면 되는지 궁금합니다.
4. 체인점은 별도 사업자입니다. 이 경우에도 저희 개발자 계정의 앱으로 지원이 가능한지 알려 주세요.
5. 체인점은 2세대 단말기(토스 프론트2 + 터미널2)를 새로 살 예정입니다. 저희 플러그인은 프론트1 + 터미널1에서 개발·시험했는데, 프론트2 + 터미널2에서도 같은 SDK로 동작하는지, 따로 바꿔야 할 점이 있는지 알려 주세요.

오류가 있다면 알려주세요

• 오류는 없습니다.

감사합니다.

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

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

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