헥토파이낸셜 개발자센터

오류 코드

안심선불 서비스에서 반환하는 API 오류 코드 및 표준화면(UI) 리다이렉션 코드 목록입니다.

API 오류 코드

공통 오류 (A-xxx)

코드내용
A-001필수 파라미터 확인 필요
A-002pktHash 불일치
A-003암호화 필드 누락
A-004복호화 오류
A-005암호화 오류
A-008유효한 날짜/시간 확인 필요

상점 오류 (M-xxx)

코드내용
M-001상점 정보 조회 실패
M-002가맹점 상태 확인 필요
M-003가맹점 충전 수단 코드 미등록
M-004가맹점 충전 수단 미오픈
M-005정산 상점 상태 확인 필요

거래 오류 (T-xxx)

코드내용
T-001거래 번호 확인 필요
T-002거래 금액 오류
T-003거래 구분 코드 오류
T-004충전 수단 코드 오류
T-005잔액 불일치
T-006충전 가능 금액 초과
T-007월 충전 가능 금액 초과
T-008원거래 조회 실패
T-009원거래금액/요청금액 확인 필요
T-010결제 비밀번호 불일치
T-011기취소된 거래
T-012원거래 번호 확인 필요
T-013포인트 유효기간 오류
T-014포인트 지급 거래건 조회 오류
T-015출금 신청 금액이 출금 가능 금액 초과
T-016머니 출금 오류
T-017취소 불가능
T-018대기머니 미보유
T-019예금주명 불일치
T-020예금주 생년월일 불일치
T-021최소 결제금액 미만
T-022유효하지 않은 잔액 사용 순서 값
T-023현금영수증 발행 요청 여부 확인 필요
T-024대기머니 부분 출금 불가
T-025은행 점검 시간으로 출금 불가
T-026머니 출금 월 최대횟수 초과
T-027사용된 금액 취소 불가
T-028금액 검증 실패 (음수)
T-029해지출금은 부분출금 불가
T-030고객 부담 수수료 오류 (0원)
T-031포인트 만료일자 누락
T-032머니 선물은 동일 상점 내 가능
T-033머니 선물 금액이 사용 가능 잔액을 초과할 수 없음
T-034머니 선물대상 회원의 최대 보유 머니 초과
T-035머니 선물 오류. 담당자 확인 필요
T-036대기머니 잔액 존재
T-037포인트 만료기한 오류 (1년 이상 설정 오류)
T-038환불 접수 정보조회 오류
T-039충전 가능단위 오류
T-040취소요청 금액 오류
T-041재처리 환불 대상 거래 조회 오류
T-042특정 충전수단 충전취소 불가
T-043충전거래번호 미입력
T-044올바르지 않은 취소 요청 금액
T-045머니 선물 오류. 본인에게 선물할 수 없음
T-047머니출금 사업자번호 불일치
T-048취소 불가능한 거래
T-049한 페이지 사이즈는 10이상 100이하만 가능
T-051올바른 금액을 입력 필요
T-053등록되지 않은 거래상세구분 코드

회원 오류 (C-xxx)

코드내용
C-001존재하지 않는 회원
C-002유효하지 않은 회원 상태
C-003탈퇴한 회원
C-004관리자 확인 필요한 회원
C-005휴면 회원
C-006계정 잠금 회원
C-007무기명회원의 충전/출금/머니선물 제한
C-008출금 계좌 미등록
C-009해지 회원
C-010수신자 회원의 상태 확인 필요
C-011수신자 무기명회원으로 머니선물 제한
C-012회원 아이디 확인 필요
C-013KYC 미이행 상태

지갑 오류 (W-xxx)

코드내용
W-001출금 가능 금액 조회 오류
W-002잔액 조회 오류

자동충전 오류 (R-xxx)

코드내용
R-001내부 시스템 오류
R-002계좌의 잔액이 부족합니다
R-003계좌 상태를 확인하세요
R-004은행 점검 시간입니다
R-005지갑 보유한도 초과입니다
R-006고객의 자동충전 수단을 등록하세요
R-007상점의 자동충전 수단을 등록하세요
R-008자동충전 불가한 고객입니다

기타 오류 (E-xxx)

코드내용
E-001 ~ E-008요청 실패. 고객센터 문의 필요
E-002요청 초과. 잠시 후 다시 시도
E-999요청 실패. 고객센터 문의 필요

표준화면(UI) 리다이렉션 코드

status 파라미터

값내용
success선불 서비스 정상 처리 (회원가입 완료, 서비스해지 완료)
canceled사용자의 서비스 중도 취소
failure선불 서비스 오류 발생

errorCode 파라미터

서비스 상태가 failure일 경우 전달됩니다.

코드내용
101본인인증요청 페이지 오류, 서버 오류
102등록되지 않은 가맹점의 회원가입 페이지 접근
103이미 가입된 회원의 페이지 접근
104정책에 따른 재가입 불가 회원 (서비스 해지 후 30일 내 재가입 불가)
105본인인증확인 페이지 오류, 서버 오류
106입력한 개인정보 기반 CI값과 전달받은 CI값 불일치
107개인 회원 가입이 불가능한 상점 진입
201내 정보 페이지 오류, 서버 오류
202선불 서비스 휴면 회원의 내 정보 페이지 접근
204선불 서비스 비정상 상태 회원 (문의 필요)
205서비스 해지된 회원의 내 정보 페이지 접근
301서비스 해지 실패, 서비스 해지 중 머니(대기머니) 출금 실패 시 오류 발생
303신규 가입 및 다이렉트 연동 시 KYC 수행 중 가입 거절 또는 서버 오류 발생
404잘못된 URL 요청
429표준화면 서버 요청 수 초과

pktHash 해시 조합

status 값에 따라 해시 값 조합 필드가 달라집니다.

status해시 조합
success상점아이디(mId) + 선불회원아이디(mCustId) + "success" + 해시키
canceled상점아이디(mId) + 선불회원아이디(mCustId) + "canceled" + 해시키
failure상점아이디(mId) + 선불회원아이디(mCustId) + "failure" + 오류코드(errorCode) + 해시키
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?