카드단말기 설치

KSNET KSP-S8A 카드패드를 매장 POS PC에 연결하는 순서예요. 위에서부터 차례로 하면 돼요.

최종 개정 2026-10-29 · 구성: KSnCAT(27098) → 브리지(27099) → 웹 POS

받을 파일

압축 프로그램 창 안에서 바로 실행하면 「pos_setup.ps1 없습니다」 오류가 나요. 폴더에 다 푼 뒤 실행해요.

풀린 폴더에 pos_setup.bat · pos_setup.ps1 · KscatBridge.exe 세 개가 같이 보이면 정상이에요.

항목	값	설명
`agentid`	`KS-CGEJ6034`	posai 공용값이에요. 매장마다 바꾸지 않아요.
`devmode`	`0`	0 = 운영, 1 = 개발테스트
`port` / `webport`	`27015` / `27098`	그대로 둬요.
`[reader] port`	`COM1`~	장치관리자 → 포트(COM)에 패드가 잡힌 번호. 안 되면 COM2, COM3 순서로 바꿔 봐요.
`baudrate`	`38400`
`[van] ip`	`210.181.28.137`	운영 승인서버. 개발테스트 서버는 `210.181.28.116`이에요.
`[van] port`	`9563`
`termid`	비워 둠	단말번호(TID)는 웹 POS가 결제마다 실어 보내요.

테스트로 세팅했던 매장이면 devmode=1, ip=210.181.28.116으로 되어 있어요. 운영 값(0, 210.181.28.137)으로 바꾸고 KSnCAT을 다시 켜야 실제 결제가 돼요.

KSNET 신형 KSCAT v2.4(MSI)는 Win10·11에서만 써요. 구 KSnCAT과 같이 깔면 포트가 겹치니 둘 중 하나만 둬요.

KSnCAT을 켜 둔 채로 pos_setup.bat을 더블클릭하고 권한 창에서 [예]를 눌러요.
마지막에 [OK] Bridge responding on 27099가 나오면 성공이에요.
Chrome을 완전히 종료했다가 다시 켜고, 주소창에 chrome://policy를 열어 LocalNetworkAccessAllowedForUrls가 보이는지 확인해요. 없으면 POS가 브리지에 접속하지 못해요.

POS 로그인(PIN) 화면 아래 단말번호를 눌러 이 기기 번호를 골라요. 기기마다 한 번만 하면 저장돼요. 지정하지 않으면 1번으로 결제돼요.

명령 프롬프트에서 두 포트가 모두 LISTENING인지 봐요.
```
netstat -ano | findstr "27098 27099"
```
POS 새로고침 → 카드단말 설정 → TID 확인. KSnCAT 연결만 되면 돼요. 결과가 「9999」로 나와도 정상이에요(지금까지 모든 매장이 그랬어요). 실제 확인은 다음 줄의 소액 결제로 해요.
소액으로 카드 결제 → 승인번호 확인 → 바로 취소. 간편결제(카카오페이)도 한 번 해 봐요.

취소는 결제한 그 단말에서만 돼요. 다른 단말에서 하면 「원거래내역없음(9999)」이 나와요.

카드단말 설정 화면의 설정 저장은 모드·포트만 바꿔요. 단말번호(TID) 등록·변경은 본사에 요청해요.

증상	조치
TID 확인이 바로 「KSnCAT 연결 실패」	KSnCAT이나 브리지가 꺼져 있어요. `netstat`에서 27098이 없으면 2번, 27099가 없으면 3번을 다시 해요.
「pos_setup.ps1 없습니다」	압축을 안 풀고 실행했어요. 1번부터.
「KSnCAT folder not found」	KSnCAT을 먼저 켜고 `pos_setup.bat`을 다시 실행해요.
장비 보고값과 기대값 불일치	KSNET 대리점에 이 장비 단말 세팅 확인을 요청해요.
RES=9999	KSnCAT 서비스가 켜졌는지, 취소라면 결제한 단말인지, `[van] ip`가 운영 서버인지 확인해요.
패드 무응답	USB를 뺐다 꽂고 KSnCAT을 다시 켜요. 그래도 안 되면 `[reader] port` COM 번호를 바꿔 봐요.

기록 위치: 바탕화면\ks\log\ (KSCAT v2.4는 내 문서\KSNet_LOG)