# 카드 오류 코드

> 결제가 거절되면 화면의 코드로 원인을 찾습니다.

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

> [!DANGER]
> **시간 초과 · 응답 없음 계열(KIS 결제 단계 시간 초과, KOVAN -4 · -5)은 승인이 났을 수 있습니다.** 다시 결제하지 말고 단말기 화면 · VPos [거래내역조회] · 카드사 문자부터 확인하세요.

#### KIS

- **무응답** — KIS-NAGT가 죽었거나 오류 창이 뒤에 떠 있음 → 작업 관리자 확인 후 다시 켜기
- **NV23 · NF23** — Agent 연결 실패 → KIS-NAGT 실행 · 포트 1515 · 승인 서버 포트(9011 오입력)
- **NV97 · NV98 · NV99** — VAN 서버 통신 실패 → 인터넷 · 방화벽
- **NF97** — 카드 읽기 전 실패 → 다시, 반복되면 리더기
- **IC02** 카드 대기 초과 · **CF** Fallback 요청 · **AE27 · ICxx · FBxx** 리더기 · **SNxx · PNxx** 서명패드
- **7979 · 7003 · 4001** — 미등록 단말기 → 가맹점 다운로드 · 단말기번호
- **8037** 카드번호 · **7099** 한도초과 · **7004** 분실·도난 · **8901** 이미 취소 · **5008** 원거래 없음 · **88ED** 단말에서 종료
- **단말기번호 불일치** — 포스가 자동 취소하고 결제를 막음 → Agent 가맹점 정보와 서버 값 맞추기

#### KOVAN

정상 = 반환 0 + 응답 0000 + 승인번호
- **-2** — VPos가 꺼짐 → VPos_PlusLite 켜기
- **-12** — 다른 거래 처리 중 → VPos 화면 닫고 다시
- **-4 · -5** — 응답 못 받음 → 다시 결제하지 말고 [거래내역조회]
- **4003** 단말기번호 불일치 · **4001** 리더기 포트 미설정 · **4005** 리더기 응답 없음
- **4010** 가맹점 다운로드 실패 · **4011** 키 다운로드 실패 · **5003** IC 인식 불가
- **8001** 사용자 중단 · **8325** 이미 취소 · **8999** 간편결제 2차 요청(정상 흐름)

## 원본 매뉴얼 자세히

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

<details>
<summary>📘 KIS 오류 코드</summary>

결제가 거절되면 화면 코드로 원인을 찾습니다. 앞 두 글자는 단계, 뒤는 이유입니다.

**1.** **무응답**(아무 반응 없음) — KIS-NAGT 가 죽었거나 오류 창이 뒤에 떠 있습니다. 작업 관리자에서 KIS-NAGT 를 확인하고 다시 켭니다.

**2.** **NV23 · NF23** — Agent 소켓 연결 실패. KIS-NAGT 실행 여부 · 서버 Agent 포트 1515 · 승인 서버 포트(9011 오입력)를 봅니다.

**3.** **NV97 · NV98 · NV99** — 네트워크 오류(VAN 서버와 통신 실패). 인터넷 · 방화벽 확인.

**4.** **NF97** — 카드 읽기 단계 실패(카드를 읽기 전에 결제가 넘어감). 다시 시도하고 반복되면 리더기 확인.

**5.** **IC02** — 카드 대기 시간 초과. **CF** — IC 실패로 Fallback 요청. **AE27 · ICxx · FBxx** — 리더기 오류. **SNxx · PNxx** — 서명패드 오류.

**6.** **7979 · 7003 · 4001** — 미등록 단말기(가맹점 다운로드 · 단말기번호 확인).

**7.** **8037** 카드번호 오류 · **7099** 한도초과 · **7004** 분실 · 도난 카드 · **8901** 이미 취소된 거래 · **5008** 원거래 없음 · **88ED** 사용자가 단말에서 종료.

**8.** **결제 단계에서 시간 초과** — 승인이 났을 수 있습니다. 다시 결제하지 말고 단말기 화면 · 카드사 문자를 먼저 확인합니다.

**9.** **단말기번호 불일치** — 포스가 그 승인을 자동으로 취소하고 결제를 막습니다. Agent 가맹점 정보와 서버 단말기번호를 맞춥니다.
</details>

<details>
<summary>📘 KOVAN 오류 코드</summary>

VPos 의 반환값(함수 결과)과 응답코드(rErrCode)로 원인을 찾습니다. 정상 = 반환 0 + 응답 0000 + 승인번호.

**1.** **반환 -2** — VPos 가 꺼져 있습니다. VPos_PlusLite 를 켭니다.

**2.** **반환 -12** — 다른 거래를 처리 중입니다. VPos 화면을 닫고 다시.

**3.** **반환 -4 · -5** — 응답을 못 받음. **승인이 났을 수 있습니다** — 다시 결제하지 말고 VPos [거래내역조회]부터 봅니다.

**4.** **4003** — 단말기번호 불일치(서버 값 ≠ VPos 값, 승인 전에 거절). **4001** — 리더기 포트 미설정. **4005** — 리더기 응답 없음.

**5.** **4010** — 가맹점 다운로드 실패 · **4011** — 키 다운로드 실패 · **5003** — IC 인식 불가.

**6.** **8001** — 사용자가 중단 · **8325** — 이미 취소된 거래 · **8999** — 간편결제 2차 요청(정상 흐름, VPos 안내를 따릅니다).
</details>