🔢카드 오류 코드
결제가 거절되면 화면의 코드로 원인을 찾습니다.
- VAN 사 단말기번호(KIS 8자리 · KOVAN 10자리)
- 사업자번호 · 다운로드 비밀번호(VAN 사 발급)
- VAN 승인 프로그램 설치본
- 멀티리더기 · 서명패드와 연결 포트
- 무응답 — 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 안내를 따릅니다).