VAN사 에이전트 받기 · KIS/KOVAN 설치 안내가 새로 정리되었습니다. 자세히 보기 →
🧰StoreSync 대리점 가이드
.md

🔢카드 오류 코드

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

👤 누가
대리점 설치 기사
⏱️ 걸리는 시간
30~40분
🧰 준비물
  • VAN 사 단말기번호(KIS 8자리 · KOVAN 10자리)
  • 사업자번호 · 다운로드 비밀번호(VAN 사 발급)
  • VAN 승인 프로그램 설치본
  • 멀티리더기 · 서명패드와 연결 포트
시간 초과 · 응답 없음 계열(KIS 결제 단계 시간 초과, KOVAN -4 · -5)은 승인이 났을 수 있습니다. 다시 결제하지 말고 단말기 화면 · VPos [거래내역조회] · 카드사 문자부터 확인하세요.
  • 무응답 — 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 가맹점 정보와 서버 값 맞추기

원본 매뉴얼 자세히#

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

›📘 KIS 오류 코드

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

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 가맹점 정보와 서버 단말기번호를 맞춥니다.

›📘 KOVAN 오류 코드

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 안내를 따릅니다).

이 페이지가 도움이 되었나요?
마지막 업데이트 1시간 전