# KIS 설치 · 설정 (Windows)

> KIS-NAGT를 카드를 받을 포스 PC마다 설치하고 가맹점 다운로드까지 합니다.

> **누가** 대리점 설치 기사 · **걸리는 시간** 20~30분
> **준비물** 대리점 계정(시스템 게시판) · VAN 사 단말기번호(KIS 8자리 · KOVAN 10자리) · 사업자번호 · 리더기 · 서명패드(USB 젠더 포함) · VAN 사 단말기번호(KIS 8자리 · KOVAN 10자리) · 사업자번호 · 다운로드 비밀번호(VAN 사 발급) · VAN 승인 프로그램 설치본 · 멀티리더기 · 서명패드와 연결 포트

> [!INFO]
> 이 설명은 **KIS 에이전트 — Windows(포스용) 3.4.6.0** 기준입니다.

![KIS 설치 순서 (KIS 설치 가이드 화면)](https://0.0.0.0:3100/files/f82ba6a330f5a6074a4bba18c025f487)
2. 포스 판매화면과 옛 KIS Agent 를 모두 끄고, 옛 버전이 있으면 Windows [앱 제거]로 먼저 지웁니다.
3. 설치본을 **관리자 권한으로 실행** → [다음]으로 진행합니다.
4. 설치 완료 [마침] → PC 를 다시 시작합니다.
6. 트레이 아이콘 → [옵션 → 기타 설정] → **Agent 자동 재실행 사용**을 켜고 [환경 저장].
7. [옵션 → 가맹점 정보]에서 사업자번호 · 비밀번호 → **[가맹점 정보 다운로드]**. 이어서 [카드결제(VAN)] 장의 'KIS 가맹점 다운로드 · 장치 설정'(단말기번호 8자리 · 리더기 · 서명패드 포트) → 포스 [연동 확인] → 소액 시험 결제 · 반품.
8. 업데이트 — 트레이 우클릭 → [업데이트 실행], 또는 새 버전을 받아 위 순서로 다시 설치합니다.

## 설치

1. **[VAN사 에이전트 → KIS → 포스용]에서 KisAgent_Setup_…exe 받기**
2. **포스 판매화면과 옛 KIS Agent를 모두 끄고, 옛 버전은 [앱 제거]로 지웁니다**
3. **관리자 권한으로 실행 → [마침] → **PC 재시작****
4. **확인: 작업 관리자에 KIS-NAGT · KIS-NAGTM, 트레이에 KIS 아이콘**
5. **트레이 → [옵션 → 기타 설정] → **Agent 자동 재실행** 켜고 [환경 저장]**

## 가맹점 다운로드 · 장치 설정

1. **트레이 우클릭 → [옵션] → 가맹점 정보: 사업자번호 · 단말기 일련번호 · 다운로드 비밀번호 → 다운로드**
   단말기번호 8자리가 들어옵니다. **서버의 단말기번호와 같아야** 합니다.
2. **멀티리더기 COM 포트 · 속도 (기본 115200, R210S 19200 · MP5000 57600)**
   모르면 [검색].
3. **서명패드 (기본 57600) — 안 쓰면 포트 0**
4. ****[최초 키 다운로드]** → **[환경저장]****

> [!WARNING]
> **자주 하는 실수** — 'OCX 복사 실패' — 포스나 Agent가 켜져 있습니다. 둘 다 끄고 다시 설치합니다. 방화벽 프로그램이 로컬 1515 포트를 막지 않게 하세요.

<details>
<summary>결제 흐름 · 매장에 알려 줄 것</summary>

- 신용카드: 결제 → 리더기에 카드 → 승인. IC를 못 읽으면 마그네틱(Fallback)으로 넘어감
- 서명: 서버 기본은 무서명. 정확히 50,000원일 때 기준은 VAN사에 확인
- 현금영수증: 포스 창에 번호 또는 [입력 요청]으로 서명패드
- 간편결제: 손님 폰 바코드를 리더기로. 가맹점 미등록 페이는 K994로 거절, 취소 때도 손님 QR을 다시 읽음
- 환불: [영수증 관리]에서 반품하면 원거래로 카드 승인도 함께 취소
- 결제 기록: %APPDATA%\MightPos\kis.log
</details>

<details>
<summary>승인 서버 (참고)</summary>

테스트 210.112.100.97 · 운영 210.112.100.63, 포트 60201(일반) · 60202(병원). 9011은 CAT 단말용이라 Agent에 넣으면 NF23 오류가 납니다.
</details>

## 원본 매뉴얼 자세히

화면 그림의 번호 설명은 그림 바로 아래에 있습니다. 아래는 원본 매뉴얼의 나머지 내용입니다.

<details>
<summary>📘 KIS 에이전트 — Windows(포스용)</summary>

KIS-NAGT 를 카드를 받을 포스 PC 에 설치합니다. 메인포스든 오더포스든 리더기가 꽂힌 PC 마다 설치합니다. 그림은 KIS 설치 가이드의 화면입니다.

**1.** [VAN사 에이전트 → KIS 정보통신 → 포스용 (Windows)]에서 KisAgent_Setup_…exe 를 받습니다.

**5.** 확인 — 작업 관리자에 **KIS-NAGT · KIS-NAGTM** 두 프로세스, 트레이에 KIS 아이콘. 설치 위치는 보통 C:\Program Files (x86)\KIS-NAGT 입니다.

**자주 하는 실수** — 'OCX 복사 실패' — 포스나 Agent 가 켜져 있습니다. 둘 다 끄고 다시 설치합니다.
포스는 이 PC 의 1515 포트로 KIS-NAGT 에 붙습니다 — 방화벽 프로그램이 로컬 1515 를 막지 않게 합니다.
</details>

<details>
<summary>📘 KIS-NAGT 설치</summary>

KIS 승인 프로그램(KIS-NAGT, 설치본 V3.4.6.0)을 카드를 받을 포스 PC 에 설치합니다.

**1.** 설치 전에 포스 판매화면과 옛 KIS Agent 를 모두 종료하고, 옛 버전이 있으면 [앱 제거]로 먼저 지웁니다.

**2.** 설치본(KisAgent_Setup_…exe)을 **관리자 권한으로 실행** → 끝나면 PC 를 다시 시작합니다.

**3.** 설치 위치 — 이 매장 PC 실측은 C:\Program Files (x86)\KIS-NAGT 입니다(설치 가이드 문서에는 C:\Program Files\KisAgent 로 적혀 있어 PC 마다 다를 수 있습니다).

**4.** 실행 중이면 작업 관리자에 **KIS-NAGT · KIS-NAGTM** 두 프로세스가 보이고, 트레이에 KIS 아이콘이 뜹니다(KIS-NAGTM 은 감시용).

**5.** 트레이 아이콘 → [기타 설정] → **Agent 자동 재실행**을 켜 둡니다.

**6.** 업데이트는 트레이 우클릭 → [업데이트 실행]. [KIS-AGENT정보]에서 무결성 점검 · 로그 폴더를 볼 수 있습니다.

**자주 하는 실수** — 'OCX 복사 실패' — 포스나 Agent 가 켜져 있습니다. 둘 다 끄고 다시 설치합니다.
</details>

<details>
<summary>📘 KIS 가맹점 다운로드 · 장치 설정</summary>

단말기번호를 받고(가맹점 다운로드) 멀티리더기 · 서명패드 포트를 잡습니다.

**1.** 트레이 아이콘 우클릭 → [옵션] → 가맹점 정보에 **사업자번호 · 단말기 일련번호 · 다운로드 비밀번호**를 넣고 다운로드 → 단말기번호 8자리가 들어옵니다. 이 번호가 서버의 단말기번호와 같아야 합니다.

**2.** 멀티리더기 — COM 포트를 고르고 속도는 기본 **115200**(R210S 는 19200 · MP5000 은 57600). 모르면 [검색].

**3.** 서명패드 — 기본 57600(SP420Q 등). 서명패드를 안 쓰면 포트를 0 으로 둡니다.

**4.** [최초 키 다운로드] → **[환경저장]**.

**5.** 테스트모드는 [기타 설정]에서 체크한 뒤 Agent 를 다시 켜야 걸리고, 켜지면 화면이 초록색이 됩니다. 운영 매장에서는 끕니다.

**참고** — 승인 서버(참고) — 테스트 210.112.100.97 · 운영 210.112.100.63, 포트 60201(일반) · 60202(병원). 9011 은 CAT 단말용이라 Agent 에 넣으면 NF23(연결 오류)이 납니다.

**자주 하는 실수** — 다운로드가 '통신오류'면 방화벽 · 인터넷 연결부터 봅니다.
</details>

<details>
<summary>📘 KIS 결제 · 현금영수증 · 간편결제</summary>

포스에서 KIS 로 받는 결제의 흐름과 매장에 알려 줄 것.

**1.** **신용카드** — 결제 버튼 → 리더기에 카드 삽입 → 승인. IC 를 못 읽으면 Fallback(마그네틱)으로 넘어갑니다.

**2.** 서명 — 서버 기본은 무서명 결제입니다. 무서명 기준 금액은 자료마다 '5만원 이하' / '5만원 이상이면 서명창'으로 적혀 있어 **정확히 50,000원**일 때는 VAN 사에 확인합니다.

**3.** **현금영수증** — 용도는 소득공제(개인) · 지출증빙(사업자). 번호는 포스 창에 넣거나 **[입력 요청]**으로 손님이 서명패드에 넣습니다. 번호가 없으면 자진발급(0100001234).

**4.** **간편결제** — 카카오페이 등 손님 폰 바코드(CPM)를 리더기로 읽습니다. 가맹점에 등록이 안 된 페이는 K994 로 거절됩니다. 취소할 때도 손님 QR 을 다시 읽어야 합니다.

**5.** **취소 · 반품** — [영수증 관리]에서 반품하면 포스가 저장한 원거래 정보(승인일자 · 승인번호)로 카드 승인을 함께 취소합니다. 원거래를 따로 입력할 일이 없습니다.

**참고** — 결제 기록은 포스 PC 의 %APPDATA%\MightPos\kis.log 에 남습니다(문제 해결 때 확인).
</details>