Windows C# 자체 POS WebSocket 연동 시 ACL 등록 방법 문의

[닉원이]

어떤 제품을 사용하나요?

• 제품: 프론트 플러그인
• SDK 또는 API 버전: 개발 준비 단계(미정)
• 환경: Windows 11 / C# .NET 10 / 자체 개발 POS

무엇이 궁금한가요?

안녕하세요.

현재 토스 프론트 2(PLF20WH)와 토스 터미널 2(PLT20WH)를 설치하여 카드 결제를 정상적으로 사용하고 있습니다.

별도로 자체 개발한 Windows C# 기반 RE HyperbaricPOS와 토스 프론트 2의 결제 승인·취소 기능을 연동하려고 합니다.

연동 방식은 Windows POS에서 프론트 플러그인으로 WebSocket 통신을 수행하는 방식을 검토하고 있습니다. 외부 API나 별도 클라우드 서버는 사용할 계획이 없습니다.

개발자센터에서 프론트 플러그인 애플리케이션 생성 시 ACL 등록 항목이 필수로 표시되어 문의드립니다.

1. Windows C# POS에서 프론트의 WebSocket 서버에 직접 연결하는 구성에서도 ACL 등록이 필요한가요?

2. 외부 API 또는 외부 서버를 사용하지 않는 경우 ACL에는 어떤 값을 입력해야 하나요?

3. 현재 운영 중인 프론트 2와 터미널 2의 기존 결제 기능을 유지하면서 개발·테스트할 수 있나요?

4. 실제 매장에 적용할 때 별도의 플러그인 검수나 VAN 활성화 절차가 필요한가요?

확인 부탁드립니다. 감사합니다.

오류가 있다면 알려주세요

오류 문의가 아니면 이 항목은 지워도 돼요.

• 발생 시각: 해당 없음
• 재현 방법: 개발자센터 → 프론트 플러그인 → 애플리케이션 생성 → ACL 입력 필수
• 기대한 결과와 실제 결과: 외부 서버를 사용하지 않는 환경에서 애플리케이션 생성
• 오류 코드·메시지: 없음

키·토큰·비밀번호·개인정보와 매장·단말 식별정보는 공개 글에 올리지 말아주세요. 개별 확인이 필요한 정보는 운영진이 안내한 비공개 채널로 보내주세요.
글을 올리기 전에 포럼 운영 안내를 확인해주세요.

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

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

1. Windows POS에서 프론트로 연결할 때도 ACL이 필요한가요?
C# POS가 같은 매장 네트워크에서 프론트의 WebSocket 서버로 접속하는 경우, 접속하는 POS의 IP를 ACL에 등록할 필요는 없습니다. ACL은 반대로 플러그인이 외부로 호출할 URL을 등록하는 항목입니다. 프론트 플러그인에서 서버를 열고, POS의 요청을 받으면 승인·취소 전에 접속 상대를 확인한 뒤 결제 API를 호출하는 구조입니다. 동일 구성에 대한 기존 답변 · 프론트 WebSocket API

2. 외부 서버가 없으면 어떤 값을 입력하나요?
앱 생성 화면에서는 ACL을 비워 둘 수 없습니다. 외부로 호출하는 주소가 전혀 없다면 등록용 예시값 https://*.example.com을 입력해 주세요. 이 주소로 실제 접속할 필요는 없고, C# POS에서는 예시 주소가 아닌 프론트의 실제 IP와 포트로 접속합니다.

3. 기존 매장 결제를 유지하면서 테스트할 수 있나요?
영업 중인 프론트 2와 터미널 2는 현재 설정 그대로 두고, 별도 프론트를 테스트 가맹점에 연결해 개발 배포로 테스트해 주세요. 운영 중인 프론트를 테스트 가맹점으로 전환하면 재온보딩이 필요하므로, 같은 프론트에서 기존 매장 결제를 중단 없이 병행하는 방식은 권장하지 않습니다. 테스트 환경 설정

4. 실제 매장에 적용할 때는 어떤 절차가 필요한가요?
테스트와 달리 실제 매장 1곳만 사용하더라도 라이브 검수·배포와 VAN 대리점의 플러그인 활성화가 필요합니다. 검수·배포 후 앱 이름·ID와 대리점명·사업자번호를 개발자센터에 전달해 주세요. 대리점 권한이 연결되면 담당 대리점이 토스플레이스 파트너스에서 해당 매장의 플러그인을 켤 수 있습니다. 매장 설치 절차

[닉원이]

답변 감사합니다.