# KOVAN 설치 · 설정 (Windows)

> VPos PlusLite를 C:\KOVAN에 설치합니다. 포스는 VPos를 직접 불러 승인합니다.

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

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

1. **[VAN사 에이전트 → KOVAN → 포스용]에서 SetupVposPlusLite_….zip 받기 → 압축 풀기**
   비밀번호는 내역에 적힌 값.
2. **Setupvpos_…exe 실행 → C:\KOVAN 에 VPos 파일이 생깁니다**
3. **VPos PlusLite 실행 → [환경설정] 탭**
4. **리더기 · 서명패드 종류 고르고 **[리더기 자동설정] · [서명패드 자동설정]****
5. ****[테스트OFF]** 체크 — 운영 서버 주소가 들어갑니다(운영 매장은 체크된 채로)**
6. **가맹점 정보 — 단말기번호 10자리 · 사업자번호**
7. ****[가맹점다운로드]** — 인증 → 가맹점 → KEY 다운로드가 차례로 진행**

![VPos 환경설정 (KOVAN 안내서 화면)](https://0.0.0.0:3100/files/803e736575b9152cb796d18fe106dd14)
4. VPos PlusLite 를 실행해 **[환경설정]** 탭을 엽니다.
5. 리더기 · 서명패드 종류를 고르고 **[리더기 자동설정]** · [서명패드 자동설정] — 연결된 포트(COM) 번호가 저절로 들어갑니다.
6. 접속 정보는 **[테스트OFF]** 체크로 운영 서버 주소 · 포트가 저절로 들어갑니다 — 운영 매장은 체크된 채로 둡니다.
7. 가맹점 정보 — **단말기번호 10자리** · 사업자번호(설치자 이름 · 연락처 · 대리점코드)를 넣습니다.
8. **[가맹점다운로드]** — 사용자 인증 → 가맹점 다운로드 → KEY 다운로드가 차례로 진행됩니다. 성공하면 버튼이 흐려집니다(다시 하려면 리더기 · 가맹점 정보를 고칩니다).

> [!DANGER]
> 서버 단말기번호와 VPos 단말기번호가 다르면 승인 전에 **4003**으로 거절됩니다. 둘을 같게 맞추세요.

- VPos가 켜져 있어야 결제됩니다 — 시작 프로그램에 두세요
- KOVAN은 서명패드 번호 입력이 없습니다. 현금영수증 번호는 포스 창 또는 [입력 요청]
- KIS-NAGT가 같이 깔려 있으면 리더기 포트를 서로 잡습니다

## 원본 매뉴얼 자세히

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

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

KOVAN VPos PlusLite 를 카드를 받을 포스 PC 에 설치합니다. 포스는 VPos 의 DLL 을 직접 불러 승인합니다. 그림은 KOVAN 안내서의 환경설정 화면입니다(견본 값은 지웠습니다).

**1.** [VAN사 에이전트 → KOVAN → 포스용 (Windows)]에서 SetupVposPlusLite_….zip 을 받습니다.

**2.** 압축을 풉니다 — **비밀번호는 내역에 적힌 값**(벤더가 exe 첨부 제한을 피하려고 암호 압축으로 줍니다).

**3.** Setupvpos_…exe 실행(Windows 7 이상) → C:\KOVAN 에 VPos_PlusLite.exe · VPOS_Client_64.dll · VPos_Connector.exe 가 생깁니다.

**9.** 다음 — [카드결제(VAN)] 장의 'KOVAN VPos 설치 · 설정' · 서버 VAN = KOVAN · 포스 [연동 확인](DLL · VPos 실행 · 단말기번호 일치) → 소액 시험 결제 · 반품.

**자주 하는 실수** — 서버 단말기번호와 VPos 의 단말기번호가 다르면 승인 전에 **4003** 으로 거절됩니다 — 둘을 같게 맞춥니다.
KIS-NAGT 가 같이 깔려 있으면 리더기 포트를 서로 잡습니다 — 한 PC 에는 쓰는 VAN 하나만 둡니다.
</details>

<details>
<summary>📘 KOVAN VPos 설치 · 설정</summary>

KOVAN 매장은 VPos PlusLite 를 C:\KOVAN 에 설치합니다. 포스는 VPos 의 DLL 을 직접 불러 승인합니다.

**1.** 설치본 Setupvpos_…exe 실행(Windows 7 이상) → C:\KOVAN 에 VPos_PlusLite.exe · VPOS_Client_64.dll · VPos_Connector.exe 가 생깁니다.

**2.** VPos [환경설정] → 리더기 · 서명패드 **자동 설정**(포스 안내문에는 [디바이스 정보 → 리더기 자동설정]으로 적혀 있습니다 — 버전마다 메뉴 이름이 조금 다릅니다).

**3.** **[가맹점 다운로드]** → 단말기번호 10자리가 들어옵니다. 서버의 단말기번호와 같아야 합니다(다르면 VPos 가 승인 전에 4003 으로 거절).

**4.** 포스는 C:\KOVAN\Config\Option.ini 를 읽어 단말기번호 · 리더기 포트 · 서명패드 포트 · 승인 서버 · 취소 창 · Fallback 을 [연동 확인]에 보여 줍니다(예: 리더기 COM5/115200, 서명패드 COM14/38400).

**5.** 테스트는 VPos [테스트 모드] 체크 — 승인 서버 IP · 포트가 자동으로 바뀝니다. 운영 매장에서는 끕니다.

**6.** VPos 가 켜져 있어야 결제됩니다(시작 프로그램에 두세요).

**참고** — KOVAN 은 서명패드 번호 입력이 없습니다 — 현금영수증 번호는 포스 창에 넣거나 [입력 요청]으로 VPos 가 손님에게 받습니다. 간편결제는 QR 을 읽으면 VPos 가 페이를 구분합니다.
</details>
