💳 카드단말기 설치
KSP-S8A 카드단말기를 이 매장 POS PC에 연결하는 순서입니다.
① POS 신규 세팅 패키지 최신·권장
이 매장 POS PC에 카드단말 브리지(KscatBridge)와 설정을 한 번에 설치합니다. 압축을 풀고 pos_setup.bat을 더블클릭하세요.
⬇ POS 설치 패키지 (.zip)
- 압축 해제 후 pos_setup.bat 더블클릭 → 자동 설치·실행 (포트 9700 대기)
- 자세한 순서는 동봉된 POS_신규세팅_가이드.md 참고
- 설치 후 POS 💳 단말설정 → 연결 테스트로 확인
⚠ 실카드 결제는 KSNET VAN 심사 완료 후 가능 (먼저 설치·테스트).
0 어댑터 1클릭 설치 권장
아래 버튼으로 ksncat_setup.bat을 다운로드 후 더블클릭하면 자동으로 설치·실행됩니다.
(Node.js 미설치 시 자동으로 설치됨)
⬇ 어댑터 1클릭 설치 (.bat)
- 다운로드 후 더블클릭 → 검은 창이 뜨면 정상 (포트 9700 대기 중)
- 검은 창을 닫지 말고, POS로 돌아가 💳 단말설정 → 연결 테스트 확인
- PC 재시작 시 다시 실행 필요 (자동시작 설정은 README.md 참고)
⚠ 실카드 결제는 KSNET VAN 심사 완료 후 가능합니다.
1 KSnCAT 데몬 설치
KSNET에서 제공하는 카드결제 프로그램(데몬). 카드단말기(KSP-S8A)와 직접 통신합니다.
데몬 설치파일 — 본사 문의
※ 설치 후 C:\KSnCAT 에서 데몬이 실행됩니다.
2 카드단말 어댑터 (수동 설치)
1클릭 설치(.bat)가 안 될 경우 수동으로 설치합니다. 먼저 Node.js(LTS)를 설치하세요.
Node.js 다운로드 →
📥 어댑터 .zip 다운로드
- 압축을 풀고
run_adapter.bat 더블클릭 → 어댑터 시작
- 포트·데몬 설정은
config.json 참고
3 카드사 심사 후 실연동
VAN 심사 + 단말기 연결이 끝나면:
- POS 상단 💳 단말설정 → 모드: HTTP, 포트: 9700 → 저장
- 🔌 연결 테스트 버튼으로 어댑터 응답 확인
⚠ 실카드 결제는 카드사 심사 완료 후 가능. 그 전엔 시뮬 모드로 흐름 확인.
← POS로 돌아가기