헥토파이낸셜 개발자센터
Products서비스
PG 결제
다양한 간편 결제
내통장결제
실시간 계좌이체 서비스
간편현금결제
계좌 등록 / 결제 / 송금
화이트라벨
브랜드페이-통합결제지원
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
LLMs로 연동하기
MCP 서버 및 AI 챗봇
API & SDKAPI & SDK
PG 결제
다양한 간편 결제
내통장결제
실시간 계좌이체 서비스
간편현금결제
계좌 등록 / 결제 / 송금
화이트라벨
브랜드페이-통합결제지원
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
블로그블로그
FAQFAQ
서비스 상태
PG 결제
내통장결제
간편현금결제
화이트라벨
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
LLMs로 연동하기
MCP 서버 및 AI 챗봇
PG 결제
내통장결제
간편현금결제
화이트라벨
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
블로그
기술 블로그 및 소식
FAQ
자주 묻는 질문
서비스 상태
서비스 장애 및 점검 현황
PG 결제
연동 준비하기서버 및 네트워크 정보전체 연동 플로우노티(notiUrl) 연동결제 취소 및 환불운영 전환
결제창 연동JavaScript SDKFORM-SUBMIT
신용카드 표준 결제창신용카드 결제창 (직호출)신용카드 노티 전문신용카드 승인 (인증분리)신용카드 카드등록 (빌키발급 결제창)신용카드 빌키 결제신용카드 빌키 삭제신용카드 취소
계좌이체 결제창계좌이체 노티 전문계좌이체 승인 (인증분리)계좌이체 취소
가상계좌 결제창가상계좌 노티 전문가상계좌 채번가상계좌 채번 (고정식 무제한)가상계좌 채번정보 변경가상계좌 채번취소가상계좌 수취 조회가상계좌 환불가상계좌 입금테스트
010 가상계좌 개요010가상계좌 결제창휴대폰 점유 인증 요청휴대폰 인증 확인동일 금액 확인010가상계좌 채번010가상계좌 채번취소010가상계좌 환불010가상계좌 노티010가상계좌 입금테스트
휴대폰 결제창휴대폰결제 노티 전문휴대폰 승인 (하이브리드)휴대폰 자동결제휴대폰결제 취소휴대폰결제 환불
상품권 결제창상품권 노티 전문상품권 취소
티머니 결제창티머니 노티 전문티머니 취소
포인트다모아 결제창포인트다모아 노티 전문포인트다모아 승인 (인증/승인 분리)포인트다모아 취소
간편결제 개요페이코 결제창페이코 테스트 환경삼성페이 결제창카카오페이 결제창네이버페이 결제창토스페이 결제창간편결제 노티 전문간편결제 취소간편 정기결제간편 정기결제 상태조회간편 정기결제 키삭제
실시간 거래 조회영수증(매출전표) 조회 (무인증)영수증(매출전표) 조회 (인증)거래대사정산대사2차 이하 PG하위사업자 정보 등록영중소사업자 차액정산영중소사업자 환급정산
에러 코드카드사 코드금융기관 코드결제수단 코드가상계좌 은행 코드
내통장결제
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
결제창 연동
내통장 결제인증내통장 결제승인내통장 결제취소내통장 망취소
내통장 거래결과조회내통장 거래내역조회현금영수증 조회
내통장 자동결제 키 발급내통장 자동결제 승인내통장 자동결제 해지
에러 코드금융기관 코드은행 점검시간
간편현금결제
연동 준비하기서버 및 네트워크 정보펌뱅킹 연동 플로우
휴대폰 본인인증 요청휴대폰 본인인증 확인예금주성명조회Ⅰ예금주성명조회Ⅱ예금주성명조회 (금액포함)계좌점유인증계좌점유인증 요청계좌점유인증 확인ARS 인증 요청ARS 인증 확인계좌점유인증 내역 조회결제비밀번호 확인
계좌 등록계좌 해지가맹점 자체 계좌 등록금융결제원 출금이체정보 해지 조회
결제결제 취소/환불송금송금계좌 잔액 조회
정기결제 키 발행정기결제 승인정기결제 해지정기결제 정보 조회정기결제 거래내역 조회
거래 결과 조회거래 내역 조회계좌 목록 조회은행 목록 조회은행 점검 조회계좌점유인증 은행점검조회테스트콜
연동 준비하기서버 및 네트워크 정보오픈뱅킹 연동 플로우
계좌 등록오픈뱅킹 계좌등록오픈뱅킹 서비스해지
결제결제 취소송금
자금반환청구 요청자금반환청구 확인
거래 결과 조회거래내역조회계좌목록조회출금이체한도 조회
거절코드표금융기관코드표은행 점검시간
화이트라벨
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
결제창결제 승인결제 취소
조회
에러 코드금융기관 코드은행 점검시간
현금영수증
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
현금영수증 등록현금영수증 취소
현금영수증 발급오류내역 조회현금영수증 발급상태 조회
현금영수증 재처리 등록현금영수증 재처리 결과내역 조회
참고
실시간 펌뱅킹
연동 준비하기전체 연동 플로우
관리전문
당타행 지급이체집금(수납) 이체수납출금계좌 등록/해지일반지준이체 (SC은행)특정금전신탁 입지급 (우리은행)
타행이체불능통지예금거래명세통지어음명세통지어음명세결번일반지준이체결과통지 (SC은행)타행이체불능통지결번예금거래명세통지결번
계좌성명조회이체처리결과조회잔액조회일반지준이체결과조회 (SC은행)자동이체결과조회 (SC은행 전용)
자금이체집계집금이체집계통지현황
관리전문
외화송금의뢰외화송금의뢰취소외화송금결과통지외화송금결과통지 결번외화송금의뢰(MX)외화송금결과통지(MX)외화송금결과통지결번(MX)
국내 외화 당행 예금주명조회국내 외화 예금주명 조회환율정보거래환율정보거래(외환은행)외화 송금처리결과 조회외화잔액조회
외화송금집계외화자동이체집계외화당행송금집계
외화입출금거래명세통지외화입출금거래명세통지 결번
VAN 가상계좌
VAVS 시작하기통신 및 전문 구성전문 공통부
수취조회 (2000/2100)입금 및 취소
송금 (6010/6110)예치금 잔액조회 (6001/6101)
요약전문
성명조회 (2001/2101)실입금자명 통보 (1030/1130)실입금자명 파일 통보실입금자명 결번요청 (1033/1133)출금계좌등록 (5080/5180)
은행 코드응답 코드매체 코드은행 운영 및 점검시간
안심선불
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
회원가입 화면 연동내정보 화면 연동
선불금 사용사용 취소머니 선물포인트 회수
잔액 조회잔액 옵션 조회잔액 상세 조회충전건별 잔액조회출금 가능 머니 조회거래 내역 조회거래 상세 조회상점 거래 상세 조회회원 정보 조회소멸 예정 포인트 조회충전 수단 조회
충전충전 취소머니 출금대기머니 출금
오류 코드거래구분코드

도구

암호화 테스트
PG 결제
연동 준비하기서버 및 네트워크 정보전체 연동 플로우노티(notiUrl) 연동결제 취소 및 환불운영 전환
결제창 연동JavaScript SDKFORM-SUBMIT
신용카드 표준 결제창신용카드 결제창 (직호출)신용카드 노티 전문신용카드 승인 (인증분리)신용카드 카드등록 (빌키발급 결제창)신용카드 빌키 결제신용카드 빌키 삭제신용카드 취소
계좌이체 결제창계좌이체 노티 전문계좌이체 승인 (인증분리)계좌이체 취소
가상계좌 결제창가상계좌 노티 전문가상계좌 채번가상계좌 채번 (고정식 무제한)가상계좌 채번정보 변경가상계좌 채번취소가상계좌 수취 조회가상계좌 환불가상계좌 입금테스트
010 가상계좌 개요010가상계좌 결제창휴대폰 점유 인증 요청휴대폰 인증 확인동일 금액 확인010가상계좌 채번010가상계좌 채번취소010가상계좌 환불010가상계좌 노티010가상계좌 입금테스트
휴대폰 결제창휴대폰결제 노티 전문휴대폰 승인 (하이브리드)휴대폰 자동결제휴대폰결제 취소휴대폰결제 환불
상품권 결제창상품권 노티 전문상품권 취소
티머니 결제창티머니 노티 전문티머니 취소
포인트다모아 결제창포인트다모아 노티 전문포인트다모아 승인 (인증/승인 분리)포인트다모아 취소
간편결제 개요페이코 결제창페이코 테스트 환경삼성페이 결제창카카오페이 결제창네이버페이 결제창토스페이 결제창간편결제 노티 전문간편결제 취소간편 정기결제간편 정기결제 상태조회간편 정기결제 키삭제
실시간 거래 조회영수증(매출전표) 조회 (무인증)영수증(매출전표) 조회 (인증)거래대사정산대사2차 이하 PG하위사업자 정보 등록영중소사업자 차액정산영중소사업자 환급정산
에러 코드카드사 코드금융기관 코드결제수단 코드가상계좌 은행 코드
내통장결제
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
결제창 연동
내통장 결제인증내통장 결제승인내통장 결제취소내통장 망취소
내통장 거래결과조회내통장 거래내역조회현금영수증 조회
내통장 자동결제 키 발급내통장 자동결제 승인내통장 자동결제 해지
에러 코드금융기관 코드은행 점검시간
간편현금결제
연동 준비하기서버 및 네트워크 정보펌뱅킹 연동 플로우
휴대폰 본인인증 요청휴대폰 본인인증 확인예금주성명조회Ⅰ예금주성명조회Ⅱ예금주성명조회 (금액포함)계좌점유인증계좌점유인증 요청계좌점유인증 확인ARS 인증 요청ARS 인증 확인계좌점유인증 내역 조회결제비밀번호 확인
계좌 등록계좌 해지가맹점 자체 계좌 등록금융결제원 출금이체정보 해지 조회
결제결제 취소/환불송금송금계좌 잔액 조회
정기결제 키 발행정기결제 승인정기결제 해지정기결제 정보 조회정기결제 거래내역 조회
거래 결과 조회거래 내역 조회계좌 목록 조회은행 목록 조회은행 점검 조회계좌점유인증 은행점검조회테스트콜
연동 준비하기서버 및 네트워크 정보오픈뱅킹 연동 플로우
계좌 등록오픈뱅킹 계좌등록오픈뱅킹 서비스해지
결제결제 취소송금
자금반환청구 요청자금반환청구 확인
거래 결과 조회거래내역조회계좌목록조회출금이체한도 조회
거절코드표금융기관코드표은행 점검시간
화이트라벨
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
결제창결제 승인결제 취소
조회
에러 코드금융기관 코드은행 점검시간
현금영수증
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
현금영수증 등록현금영수증 취소
현금영수증 발급오류내역 조회현금영수증 발급상태 조회
현금영수증 재처리 등록현금영수증 재처리 결과내역 조회
참고
실시간 펌뱅킹
연동 준비하기전체 연동 플로우
관리전문
당타행 지급이체집금(수납) 이체수납출금계좌 등록/해지일반지준이체 (SC은행)특정금전신탁 입지급 (우리은행)
타행이체불능통지예금거래명세통지어음명세통지어음명세결번일반지준이체결과통지 (SC은행)타행이체불능통지결번예금거래명세통지결번
계좌성명조회이체처리결과조회잔액조회일반지준이체결과조회 (SC은행)자동이체결과조회 (SC은행 전용)
자금이체집계집금이체집계통지현황
관리전문
외화송금의뢰외화송금의뢰취소외화송금결과통지외화송금결과통지 결번외화송금의뢰(MX)외화송금결과통지(MX)외화송금결과통지결번(MX)
국내 외화 당행 예금주명조회국내 외화 예금주명 조회환율정보거래환율정보거래(외환은행)외화 송금처리결과 조회외화잔액조회
외화송금집계외화자동이체집계외화당행송금집계
외화입출금거래명세통지외화입출금거래명세통지 결번
VAN 가상계좌
VAVS 시작하기통신 및 전문 구성전문 공통부
수취조회 (2000/2100)입금 및 취소
송금 (6010/6110)예치금 잔액조회 (6001/6101)
요약전문
성명조회 (2001/2101)실입금자명 통보 (1030/1130)실입금자명 파일 통보실입금자명 결번요청 (1033/1133)출금계좌등록 (5080/5180)
은행 코드응답 코드매체 코드은행 운영 및 점검시간
안심선불
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
회원가입 화면 연동내정보 화면 연동
선불금 사용사용 취소머니 선물포인트 회수
잔액 조회잔액 옵션 조회잔액 상세 조회충전건별 잔액조회출금 가능 머니 조회거래 내역 조회거래 상세 조회상점 거래 상세 조회회원 정보 조회소멸 예정 포인트 조회충전 수단 조회
충전충전 취소머니 출금대기머니 출금
오류 코드거래구분코드

도구

암호화 테스트

에러 코드

화이트라벨 서비스에서 반환하는 거절 코드 목록입니다.

NOTE

결제수단별 응답 메시지

사용하는 결제수단(간편현금결제, PG)에 따라서 같은 응답코드의 응답 메시지가 상이할 수 있습니다. 아래 응답코드를 모두 참고해 주세요.

화이트라벨 전용 응답 코드

공통

코드내용코드내용
0000정상처리0009사용자 취소

결제요청 정보 누락 (1001~1011)

코드내용코드내용
1001결제요청 정보 누락(상점아이디)1002결제요청 정보 누락(요청일자)
1003결제요청 정보 누락(요청시간)1004결제요청 정보 누락(상점주문번호)
1005결제요청 정보 누락(거래금액)1006결제요청 정보 누락(결과화면 URL)
1007결제요청 정보 누락(결제취소 URL)1008결제요청 정보 누락(상점고객아이디)
1009결제요청 정보 누락(이메일)1010결제요청 정보 누락(hash 데이터)
1011결제요청 정보 누락(상품명)

결제요청 정보 길이 오류 (1101~1122)

코드내용코드내용
1101결제 요청 정보 길이 오류(상점아이디)1102결제 요청 정보 길이 오류(요청일자)
1103결제 요청 정보 길이 오류(요청시간)1104결제 요청 정보 길이 오류(상점주문번호)
1105결제 요청 정보 길이 오류(거래금액)1106결제 요청 정보 길이 오류(결과화면 URL)
1107결제 요청 정보 길이 오류(결제취소 URL)1108결제 요청 정보 길이 오류(상점고객아이디)
1109결제 요청 정보 길이 오류(hash 데이터)1110결제 요청 정보 길이 오류(상점명)
1111결제 요청 정보 길이 오류(상점 예약필드)1112결제 요청 정보 길이 오류(이메일)
1113결제 요청 정보 길이 오류(면세여부)1114결제 요청 정보 길이 오류(과세금액)
1115결제 요청 정보 길이 오류(부가세금액)1116결제 요청 정보 길이 오류(비과세금액)
1117결제 요청 정보 길이 오류(봉사료금액)1118결제 요청 정보 길이 오류(상품명)
1119결제 요청 정보 길이 오류(통장인자내용)1120결제 요청 정보 길이 오류(자원순환보증금)
1121결제 요청 정보 길이 오류(현금영수증추가공제구분)1122결제 요청 정보 길이 오류(CI검증여부)

해쉬/암호화 오류

코드내용코드내용
1901해쉬값 불일치 오류1902암호화 항목 미처리 오류

고객/인증

코드내용코드내용
2005비밀번호 검증 실패2010고객 서비스 해지

토큰

코드내용코드내용
5001token null5002token expired
5003token encoding error5004token parse error
5005token mapping error5006token io error

유효성/조회

코드내용코드내용
6001유효하지 않은 요청 전문9002결제창옵션 조회 오류
9003결제창배너 조회 오류9004약관리스트 조회 오류
9005공지사항 조회 오류9006제휴할인 조회 오류
9007결제정보 조회 오류

게이트웨이/시스템

코드내용코드내용
9901게이트웨이 요청 전문 오류9902게이트웨이 응답 전문 오류
9903게이트웨이 요청오류9904게이트웨이 응답오류
9905게이트웨이 시스템 오류9999내부 시스템 오류
9998서비스 사용 해지한 사용자가 잘못된 경로로 접근

화이트라벨 전용

코드내용
WL01일정 시간 동안 10회 이상 동일한 IP로 인증을 시도하여 15분 간 인증이 제한됩니다. 잠시 후 다시 시도해 주세요.
WL02고객 정보가 유효하지 않습니다. 본인인증 하신 개인정보를 확인해 주세요.

간편현금결제 응답 코드

NOTE

간편현금결제 응답 코드

간편결제 API에서는 아래 ST 코드 외에 10xxx 형태(예: ST01 → 10001)의 숫자 코드로도 응답될 수 있습니다.
코드내용코드내용
0021성공0031실패
ST01존재하지 않는 계좌ST02유효하지 않는 계좌
ST03이중출금 발생ST04VAN 요청중 시스템 에러
ST05VAN 응답정보 없음ST06거래번호 정보가 없음
ST07통신장애ST08이미 등록된 계좌
ST09유효하지 않는 요청전문ST10내부 시스템 에러
ST11은행점검 시간ST12출금계좌 잔액부족
ST13ARS인증 결과가 없음ST14ARS 인증 요청 값이 상이함
ST15자동이체 해지계좌ST16출금계좌 거래제한
ST17주민번호 사업자번호 오류ST18계좌오류 (간편계좌등록 불가)
ST19기타거래불가ST20계좌오류
ST21수취인 계좌 없음ST22법적제한 계좌
ST23비실명 계좌ST24예금주 불일치
ST25이미 취소된 거래ST26취소금액 오류
ST27ARS인증 실패ST28ARS수신불가
ST29계좌 등록 진행 중ST30환불 진행 중
ST31이중 송금 발생ST32납부자 성명조회 실패
ST331회 한도 초과ST341일 한도 초과
ST35사고계좌입니다ST36일정시간이 지나 연결이 끊어졌습니다
ST37간편결제 취소ST38요청 진행 중
ST39환불 중복 요청ST40처리 중 요청이 있음
ST41서비스 용량초과ST42시스템 BUSY
ST43이미 등록된 계좌입니다ST44거래불가은행
ST50중복전문 요청ST51이미등록된 현금영수증 사용자
ST52미등록 현금영수증 사용자ST53이미 해지된 계좌
ST60거래실패ST611회한도 금액초과
ST62일한도 금액초과ST63월한도 금액초과
ST64일한도 건수 초과ST65월한도 건수 초과
ST66비밀번호 등록 실패ST67비밀번호 불일치
ST68서비스 이용정지ST69정책상 해당 결제서비스를 이용할 수 없습니다
ST70정책상 해당 결제서비스를 이용할 수 없습니다. 고객센터 문의 (1600-5220)ST72결제시 ARS 2차인증 필요
ST86인증 실패입니다 (휴대폰 본인인증)ST87간편본인확인 미가입자입니다 (휴대폰 본인인증)
ST99간편결제 시스템 점검중VTIM중계기관 TIMEOUT
SE01인증 유효 시간이 만료되었습니다SE02인증 번호가 불일치합니다
SE03인증확인 허용횟수를 초과하였습니다

PG 공통 응답 코드

코드내용코드내용
ST01고객정보 없음STR1~STR8내부 정책
ST03기 결제건ST06거래정보 없음
ST07유효하지 않은 전문ST08이미 등록된 계좌입니다
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원천사 타임아웃
3007취소 한도 초과

신용카드 응답 코드

코드내용코드내용
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미등록 카드입니다. 카드사로 문의해 주세요.CA59법인카드는 거래가 불가능합니다
CA60~CA64가맹점상태 오류CA65인증거래미약정가맹점
CA70식별번호(생년월일/사업자번호)+비밀번호가 유효하지 않음CA75공동인증서 인증정보가 유효하지 않습니다
CA80서비스 불가 거래CA81거래 처리 중 오류 발생
CA82카드사 전화 요망CA83해당 거래는 취소가 불가합니다
CA84기타 오류가 발생하였습니다CA85취소거래 처리 시 오류가 발생하였습니다
CA86이중 거래 입니다CA87가맹점 번호가 유효하지 않습니다
CA88해당 선불카드(기프트카드)는 부분취소가 불가합니다0905본인확인요망
J999카드사 전화 요망8373카드사 전화 요망
8375기타 에러 처리
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?

코드 샘플

HectoFinancial GitHub