﻿================================================
  posai POS 설치 가이드 - Windows 7 전용
================================================
  작성 2026-07-14 (루원시티 2호기 실전 검증판)
  Win10/11 기기는 Win10 가이드를 보세요.

[준비물]
  - 카드단말 패드: KSNET KSP-S8A
  - 영수증 프린터: SEWOO SLK-TS100 + 80mm 감열지
  - 인터넷 되는 상태의 포스기 (Chrome 설치)


------------------------------------------------
  0단계. Windows 7이 다른 점 (먼저 읽기)
------------------------------------------------

  1) ".NET 4.7.2"를 가장 먼저 설치해야 합니다.
     - 이거 없이는 카드 프로그램이 아예 안 뜹니다.
     - 주의: 4.8.1 버전은 Win10 전용입니다.
       Win7에서는 설치 자체가 안 되니 받지 마세요.

  2) 설치 패키지는 2026-07-13 이후 버전만 됩니다.
     - 옛 패키지는 Win7에서 빨간 에러가 납니다.
     - 아래 주소에서 새로 받으면 항상 최신입니다.

  3) 카드 패드가 어느 COM 포트인지 화면으로는
     확인이 안 됩니다. (본체 내장 포트라서)
     - COM1부터 차례로 시도하면 됩니다. (3단계)


------------------------------------------------
  1단계. 파일 2개 다운로드
------------------------------------------------

  포스기 Chrome 주소창에 입력:

  (1) .NET 4.7.2 (84MB)
      https://posai.co.kr/downloads/dotnet472_offline.exe

  (2) 설치 패키지 (52MB)
      https://posai.co.kr/downloads/pos_install_pkg.zip


------------------------------------------------
  2단계. .NET 4.7.2 설치 + 재부팅
------------------------------------------------

  1) 받은 dotnet472_offline.exe 더블클릭
  2) 설치 완료되면 반드시 [재부팅]

  * "지원되지 않는 운영 체제" 에러가 나면
    Win7에 서비스팩1(SP1)이 없는 기기입니다.
    -> 관리자에게 연락 주세요.


------------------------------------------------
  3단계. 카드단말 프로그램 (KSnCAT)
------------------------------------------------

  1) pos_install_pkg.zip 을 [압축 풀기]
     * 중요: 압축 프로그램 창 안에서 파일을
       바로 더블클릭하면 안 됩니다.
       반드시 압축을 다 푼 뒤 폴더에서 실행!

  2) 풀린 폴더 안 installers 폴더의
     KSnCAT.zip 을 "바탕화면\ks" 폴더에 풀기

  3) ks 폴더의 KSnCAT.ini 를 메모장으로 열어
     아래 4곳만 확인:

       agentid=KS-CGEJ6034   <- 그대로 둠 (공용값)
       devmode=0             <- 0=운영, 1=테스트
       port=COM1             <- 패드 연결 포트
       ip=210.181.28.137     <- 운영 승인서버

     * 패드가 안 잡히면 port를 COM2, COM3 으로
       바꿔가며 KSnCAT을 재시작해 보세요.

  4) 패드 케이블 연결 -> KSnCAT.exe 실행
     -> 패드에 대기 화면이 뜨면 성공


------------------------------------------------
  4단계. 브리지 설치 (pos_setup.bat)
------------------------------------------------

  * KSnCAT이 켜져 있는 상태에서 진행하세요.

  1) 압축 푼 폴더의 pos_setup.bat 더블클릭
  2) 권한 창이 뜨면 [예]
  3) 마지막 줄에 아래 문구가 나오면 성공:
       [OK] Bridge responding on 27099.
  4) Chrome을 완전히 껐다가 다시 켜기


------------------------------------------------
  5단계. 영수증 프린터 (SLK-TS100)
------------------------------------------------

  * 프린터는 공장 출고 상태로는 컴퓨터가
    "프린터"로 인식하지 못합니다.
    모드 전환을 먼저 해야 합니다. (딱 1번)

  1) installers 폴더의
     Configuration Utility_V1.81.zip 풀어 실행
  2) Main 탭: COM 포트 선택, 속도 115200
     -> [Print] 눌러 시험 인쇄 확인
  3) Interface 탭 -> [Print USB] 버튼 클릭
  4) 프린터 전원 끄고 5초 뒤 켜기
  5) installers 폴더의
     "SEWOO Windows Driver 1.1.exe" 실행
     - OS: Windows 7 선택 / 연결: USB
     - 기종: SLK-TS100
     - [Check USB Port] 에 USB001 나오면 정상
     - [Install Now] 로 설치
  6) 제어판 프린터에서 SEWOO SLK-TS100 을
     [기본 프린터]로 지정
  7) 테스트 페이지 인쇄해서 종이 나오면 완료

  * Chrome 인쇄 창에서는:
    - 설정 더보기 -> 머리글/바닥글 체크 해제
    - 여백: 없음


------------------------------------------------
  6단계. 단말번호 지정 (포스 여러 대면 필수)
------------------------------------------------

  1) POS 로그인(비밀번호 입력) 화면 맨 아래
     회색 글씨 [단말번호: 1] 클릭
  2) 숫자 버튼에서 이 기기 번호 선택
     (1호기=1, 2호기=2)
  3) [완료] 클릭

  * 한 번만 하면 계속 저장됩니다.
  * 지정 안 하면 무조건 1번으로 결제됩니다.
  * 손님화면(보조 모니터)을 쓰면 손님화면도
    같은 번호로 맞춰 주세요.


------------------------------------------------
  7단계. 최종 확인 (결제 테스트)
------------------------------------------------

  1) https://posai.co.kr 로그인
  2) 아무 상품 담고 소액 카드 결제
  3) 패드에 "카드를 대주세요" -> 카드 대기
  4) 승인 후 영수증이 자동으로 인쇄되는지,
     영수증에 승인번호/카드사가 찍히는지 확인
  5) 테스트 결제는 바로 취소
     * 취소는 "결제했던 그 포스"에서 하세요.
       다른 포스에서는 "원거래내역없음" 에러.


------------------------------------------------
  문제가 생기면 (증상 -> 조치)
------------------------------------------------

  "pos_setup.ps1 이 없습니다" 빨간 에러
   -> 압축을 안 풀고 실행한 것.
      압축 풀고 폴더에서 다시 실행 (3단계 1번)

  bat 실행 시 Where-Object 빨간 에러
   -> 옛날 패키지. zip을 다시 다운로드

  KSnCAT이 .NET 에러로 안 뜸
   -> 2단계(.NET 4.7.2)를 안 한 것

  결제 시 9999 에러
   -> 1) KSnCAT이 켜져 있는지 확인 (제일 흔함)
      2) 취소 중이면: 결제한 그 포스가 맞는지
      3) 그래도 안 되면 관리자 연락

  패드 무반응
   -> 패드 케이블 뺐다 꽂기 + KSnCAT 재시작

  프린터 연결음은 나는데 목록에 없음
   -> 5단계 모드 전환(Print USB)을 안 한 것

  로그 파일 위치 (관리자 문의 시 필요)
   -> 바탕화면\ks\log\ 폴더


================================================
  관리자: 서버 root@175.126.111.34
  문서 최신본:
  https://posai.co.kr/downloads/POS_setup_guide_win7.txt
================================================
