헥토파이낸셜 개발자센터

에러 코드

PG 결제 서비스에서 반환하는 응답 코드 목록입니다.

PG 공통 응답 코드

코드내용코드내용
0000정상처리0009사용자취소
1001결제 요청 정보 누락(상점아이디)1002결제 요청 정보 누락(결제수단)
1003결제 요청 정보 누락(거래일자)1004결제 요청 정보 누락(거래시간)
1005결제 요청 정보 누락(상점주문번호)1006결제 요청 정보 누락(상점한글명)
1007결제 요청 정보 누락(상점영문명)1008결제 요청 정보 누락(상품명)
1009결제 요청 정보 누락(거래금액)1010결제 요청 정보 누락(결과처리URL)
1011결제 요청 정보 누락(결과화면URL)1012결제 요청 정보 누락(결제취소URL)
1013결제 요청 정보 누락(상점고객아이디)1101결제 요청 정보 길이 오류(상점아이디)
1102결제 요청 정보 길이 오류(결제수단)1103결제 요청 정보 길이 오류(요청일자)
1104결제 요청 정보 길이 오류(요청시간)1105결제 요청 정보 길이 오류(상점주문번호)
1106결제 요청 정보 길이 오류(상점한글명)1107결제 요청 정보 길이 오류(상점영문명)
1108결제 요청 정보 길이 오류(상품명)1109결제 요청 정보 길이 오류(거래금액)
1110결제 요청 정보 길이 오류(고객명)1111결제 요청 정보 길이 오류(결과처리URL)
1112결제 요청 정보 길이 오류(결과화면URL)1113결제 요청 정보 길이 오류(결제취소URL)
1114결제 요청 정보 길이 오류(상점예약필드)1115결제 요청 정보 길이 오류(이메일)
1116결제 요청 정보 길이 오류(상품제공기간)1117결제 요청 정보 길이 오류(상점고객아이디)
1118결제 요청 정보 길이 오류(면세여부)1119결제 요청 정보 길이 오류(과세금액)
1120결제 요청 정보 길이 오류(부가세금액)1121결제 요청 정보 길이 오류(비과세금액)
1122결제 요청 정보 길이 오류(봉사료)1123결제 요청 정보 길이 오류(카드결제타입)
1124결제 요청 정보 길이 오류(특정카드사코드)1125결제 요청 정보 길이 오류(앱스키마)
1126결제 요청 정보 길이 오류(고객IP주소)1127결제 요청 정보 길이 오류(hash 데이터)
1901해쉬값 불일치 오류1902암호화 항목 미처리 오류
2001보안숫자가 일치하지 않음2002보안숫자 인증 횟수 초과
2003인증 시간 초과5001잘못된 경로로 접근(null error)
5002거래 시간 초과(expired error)5003잘못된 경로로 접근(encoding error)
5004잘못된 경로로 접근(parse error)5005잘못된 경로로 접근(mapping error)
5006잘못된 경로로 접근(io error)6001유효하지 않은 요청 전문
9001레거시코드 조회 오류9002결제창옵션 조회 오류
9003결제창배너 조회 오류9004약관리스트 조회 오류
9005공지사항 조회 오류9006제휴할인 조회 오류
9007결제정보 조회 오류9901게이트웨이 요청 전문 오류
9902게이트웨이 응답 전문 오류9903게이트웨이 요청 오류
9904게이트웨이 응답 오류9905게이트웨이 시스템 오류
9999내부 시스템 오류3007취소 한도 초과
ST01고객정보 없음STR1~STR8내부 정책
ST06거래정보 없음ST03기 결제건
ST08이미 등록된 계좌입니다ST07유효하지 않은 전문
ST09유효하지 않은 요청전문ST10내부 시스템 오류
ST11원천사 점검 시간ST13인증내역 없음
ST19기타 거래 불가ST24예금주 불일치
ST25중복 취소 요청ST26취소 정보 오류
ST30인증 시간 만료ST32예금주 성명 오류
ST38처리 진행 중ST39환불 중복 요청
ST41트래픽 과다ST44원천사 정보 오류
ST45취소 실패ST46취소기간 경과
ST47미등록 상점ST48미등록 가맹점
ST50중복요청ST54부분취소 불가
ST55복합과세 금액 불일치ST56취소회차 오류
ST57취소금액(환불금액)이 원거래금액을 초과합니다.ST58취소요청금액이 원거래금액과 일치하지 않습니다.
ST60비정상 처리ST68서비스 중지
ST69서비스 불가ST70정책 차단
ST79시스템 오류ST90~ST97결제 수단별 개별 정의
ST99기타 오류VTIM원천사 타임아웃

신용카드 응답 코드

코드내용코드내용
CA01원천사 점검CA02원천사 장애
CA03전문 유효성 체크CA04결제 중계사 장애
CA10거래정보 없음CA11기매입 거래
CA12기취소 거래CA13~CA19요청정보 오류
CA20카드 유효기간이 유효하지 않습니다.CA21~CA23할부 관련 오류
CA26사용횟수 초과CA27~CA29비밀번호 관련 오류
CA30식별번호 오류CA31~CA37한도 관련 오류
CA38포인트한도 미달로 거래 불가CA40~CA41거래금액 오류
CA421000원 미만 99,999,999원 이상 금액 거래 불가CA50~CA57카드상태 오류
CA58미등록 카드입니다. 카드사로 문의해 주세요.CA60~CA64가맹점상태 오류
CA59법인카드는 거래가 불가능합니다.J999카드사 전화 요망
CA65인증거래미약정가맹점CA70식별번호(생년월일/사업자번호)+비밀번호가 유효하지 않음
CA75공동인증서 인증정보가 유효하지 않습니다.CA80서비스 불가 거래
CA81거래 처리 중 오류 발생0905본인확인요망
CA82카드사 전화 요망CA83해당 거래는 취소가 불가합니다.
CA84기타 오류가 발생하였습니다.CA85취소거래 처리 시 오류가 발생하였습니다.
CA86이중 거래 입니다.CA87가맹점 번호가 유효하지 않습니다.
CA88해당 선불카드(기프트카드)는 부분취소가 불가합니다.8373카드사 전화 요망
8375기타 에러 처리

휴대폰 결제 응답 코드

코드내용코드내용
MP01요청자료 오류MP02요청정보 불일치
MP03결제정보 없음MP04미등록 가맹점/서비스
MP05~MP13고객 관련결제 불가MP14~MP17이통사소액결제 이용 불가
MP18~MP19이통사소액결제 이용 동의MP20~MP21이통사소액결제 차단 요청
MP22이통사 자동결제 차단MP23~MP26한도 초과
MP27~MP33원천사 RM(imPAY)MP34~MP36원천사 중복 처리
MP37~MP40원천사 부가서비스MP41~MP44소액결제 비밀번호
MP45월자동결제 전월 정보 없음MP50~MP51유효시간 초과
MP60~MP77인증 관련 오류MP78간편결제 서비스
MP80취소 실패MP81취소 기간 경과
MP82기 취소 거래MP94서비스 불가
MP95~MP96원천사 트래픽 과다MP97내부 오류
MP98기타 오류MP99결제창 인증 취소 처리

계좌이체 응답 코드

코드내용코드내용
RA01이체횟수 초과RA02~RA04한도 관련 오류
RA05잔액부족RA10~RA13고객정보 불일치
RA14금액초과RA15금액 불일치
RA16중복 결제RA17은행정보 없음
RA20은행정보 없음RA21계좌번호 상태 에러
RA30~RA31업무시간 마감RA32서비스 불가 상점
RA33기취소 거래RA34원거래 조회 실패
RA35거래정보 없음RA40수표 처리
RA41증서 처리RA80~RA81원천사 네트워크 오류
RA82헥토파이낸셜 오류RA83원천사 네트워크 오류
RA84헥토파이낸셜 오류RA85인증 처리
RA86~RA87은행 오류RA88은행 업무종료

가상계좌 / 대사 API 응답 코드

코드내용
0000정상 처리 되었습니다.
1001조회내역 없음
ST09유효하지 않은 요청전문
ST10내부 시스템 에러
ST90등록되지 않은 상점 아이디
ST91필수 파라미터 오류
ST92해쉬 값 불일치

포인트 다모아 응답 코드

코드내용코드내용
CP01한도 초과CP02사용가능금액 초과
CP03요청금액 초과CP04금액 불일치
CP10~CP11고객정보조회 실패CP12인증 관련
CP13고객정보 미존재CP14약관내역 미존재
CP15~CP16회원정보 관련CP17중복결제 오류
CP30기취소 거래CP31거래시간 만료
CP32~CP33원거래 조회 실패CP34중복결제 오류
CP70가맹점상태 오류CP71광고 관련 오류
CP80~CP87원천사 관련 오류CP88파일 관련 오류
CP89포인트 조회 관련 오류CP90입력정보 오류

상품권 응답 코드

코드내용코드내용
GC01요청자료 오류GC02요청정보 불일치
GC03결제정보 없음GC04미등록 가맹점/서비스
GC05결제정보 없음GC06중복결제 오류
GC07한도초과GC08처리완료
GC09인증정보 오류GC10회원정보 관련
GC11한도초과GC12~GC13가맹점상태 오류
GC20~GC24원천사 관련 오류GC40취소 실패
GC41취소 기처리GC42취소 불가
GC94서비스 불가GC95~GC96원천사 시스템 오류
GC97내부 오류GC98기타 오류
ST90상품권류 개별 Alert창 출력

티머니 응답 코드

코드내용코드내용
TM01기 취소 거래TM02결제정보 없음
TM03중복 취소TM04취소금액 초과
TM05요청자료 오류TM11취소오류
TM14미등록 가맹점/서비스TM22~TM23CASHBEE 거래
TM30환불 기간 초과TM40취소 실패
TM99알수 없는 오류

간편결제 응답 코드

코드내용코드내용
PZ01, PZ05원천사 점검PZ02원천사 장애
PZ03결제 중계 오류PZ04허용되지 않은 접근
PZ06유효하지 않은 계좌PZ07유효하지 않은 카드번호
PZ08카드 유효기간이 유효하지 않음PZ09요청정보 오류
PZ10원거래 정보 미존재PZ14~PZ19비밀번호 관련 오류
PZ26~PZ27유효하지 않은 금액PZ31해당거래불가가맹점
PZ32가맹점 운영 시간 종료PZ33~PZ35결제수단 거래 불가
PZ40, PZ42할부 관련 오류PZ45인증 오류 횟수 초과
PZ50~PZ54카드상태 오류PZ60~PZ65회원정보 관련 오류
PZ69전문포맷오류PZ70서비스 불가 거래
PZ71거래 처리 중 오류 발생PZ72쿠폰 사용 불가합니다.
PZ73사업자/법인등록번호 불일치PZ74카드사 전화 요망
PZ75취소 불가 거래PZ76기타 오류
PZ77~PZ78환불/취소 처리 오류PZ79거래제한시간 만료
PZ80조회 가능한 기간 아님PZ81진행 중 거래
PZ82승인내역 미존재PZ83쿠폰 적용 불가
PZ84환불 불가PZ85이벤트 참여 불가
PZ86기처리 거래PZ87기취소 거래
PZ88기매입 거래PZ89~PZ90인증정보 관련 오류
PZ91할인 적용 불가
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?