﻿================================================
  posai POS 설치 가이드 - Windows 10 / 11
================================================
  작성 2026-07-14
  Windows 7 구형 기기는 Win7 가이드를 보세요.
  (.NET 별도 설치 등 절차가 다릅니다)

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


------------------------------------------------
  1단계. 설치 패키지 다운로드
------------------------------------------------

  포스기 Chrome 주소창에 입력:

      https://posai.co.kr/downloads/pos_install_pkg.zip

  * .NET은 Win10/11에 내장되어 있어
    따로 설치할 것이 없습니다.


------------------------------------------------
  2단계. 압축 풀기
------------------------------------------------

  1) pos_install_pkg.zip 을 [압축 풀기]

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

  2) 풀린 폴더에 아래 3개가 같이 보여야 정상:
     pos_setup.bat / pos_setup.ps1 / KscatBridge.exe


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

  * 표준은 A방식입니다. (전 매장 검증본)

  [A방식 - 권장]
  1) installers 폴더의 KSnCAT.zip 을
     "바탕화면\ks" 폴더에 풀기
  2) ks 폴더의 KSnCAT.ini 를 메모장으로 열어
     아래 4곳만 확인:

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

     * USB 연결 패드는 장치관리자(Win+X, M)
       -> 포트(COM & LPT) 에서 번호 확인 가능
  3) 패드 연결 -> KSnCAT.exe 실행
     -> 패드에 대기 화면이 뜨면 성공

  [B방식 - KSNET 신형 프로그램 (KSCAT v2.4)]
  1) https://posai.co.kr/downloads/kscat_v240_setup.zip
     받아서 Setup 폴더의 KSCAT_Setup.msi 설치
  2) 설정 탭 "1. 암호화 리더기"에서
     [자동검색](38400) -> [테스트]
  3) [설정저장] -> [서비스 시작] 버튼 클릭
     (이 버튼 안 누르면 결제 시 9999 에러)

  * 주의: A와 B를 같이 깔면 안 됩니다.
    (포트가 겹쳐서 충돌) 한 가지만 쓰세요.


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

  * 카드단말 프로그램이 켜져 있는 상태에서!

  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초 뒤 켜기
     * 확인: 장치관리자에서
       "USB 직렬 장치(COMxx)"가 사라지고
       "USB 인쇄 지원"이 생기면 정상
  5) installers 폴더의
     "SEWOO Windows Driver 1.1.exe" 실행
     - OS: Windows 10 선택 / 연결: USB
     - 기종: SLK-TS100
     - [Check USB Port] 에 USB001 나오면 정상
     - [Install Now] 로 설치
  6) 설정 -> 프린터 및 스캐너:
     - "Windows에서 기본 프린터 관리" 끄기
     - 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) 테스트 결제는 바로 취소
     * 취소는 "결제했던 그 포스"에서 하세요.
       다른 포스에서는 "원거래내역없음" 에러.

  [새 매장을 여는 경우 - 관리자 작업]
  - 서버에 매장 등록 + TID 연결이 필요합니다.
    (provision_tenant_kscat.php)
  - 기존 매장에 포스만 추가하는 경우는
    이 단계가 필요 없습니다.


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

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

  "KSnCAT folder not found" 에러
   -> 카드단말 프로그램을 안 켜고 bat 실행.
      프로그램 먼저 켜고 다시 (4단계)

  결제 시 9999 에러
   -> 1) 카드단말 프로그램(서비스) 켜져 있는지
      2) 취소 중이면: 결제한 그 포스가 맞는지
      3) 그래도 안 되면 관리자 연락

  패드 무반응
   -> 패드 USB 뺐다 꽂기 + 프로그램 재시작

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

  로그 파일 위치 (관리자 문의 시 필요)
   -> A방식: 바탕화면\ks\log\ 폴더
   -> B방식: 내 문서\KSNet_LOG 폴더


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