헥토파이낸셜 개발자센터
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)
은행 코드응답 코드매체 코드은행 운영 및 점검시간
안심선불
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
회원가입 화면 연동내정보 화면 연동
선불금 사용사용 취소머니 선물포인트 회수
잔액 조회잔액 옵션 조회잔액 상세 조회충전건별 잔액조회출금 가능 머니 조회거래 내역 조회거래 상세 조회상점 거래 상세 조회회원 정보 조회소멸 예정 포인트 조회충전 수단 조회
충전충전 취소머니 출금대기머니 출금
오류 코드거래구분코드

도구

암호화 테스트

입금 및 취소

은행에서 발생한 가상계좌 입금과 입금 취소를 이용기관에 전달하는 전문입니다.


거래 코드

구분요구응답설명
입금10001100주로 창구 입금
입금 Retry100111011000 응답 미수신 재요청
입금이체30003100계좌이체 방식 입금
입금이체 Retry300131013000 응답 미수신 재요청
입금 취소101011101000 계열 원거래 취소
입금이체 취소301031103000 계열 원거래 취소
결번 입금10031103결번 입금
결번 취소10131113결번 취소

은행별로 1000과 3000의 발생 기준이 다를 수 있으므로 거래코드만으로 고객의 실제 입금 매체를 확정하지 마세요.

은행
헥토파이낸셜
이용기관
11. 입금 요구 (1000/3000)
1. 입금 요구 (1000/3000)
22. 입금 요구 전달
2. 입금 요구 전달
33. 입금 응답 (1100/3100)
3. 입금 응답 (1100/3100)
44. 입금 응답 전달
4. 입금 응답 전달

개별부

No항목MODE길이위치요구응답설명
1공통부-700●○전문 공통부
2계좌번호AN1670●○가상계좌번호
3예금주명AN2086-⊙가상계좌 예금주명. 일부 보험사 연동은 실입금자명
4취급은행AN2106●○2자리 은행코드
5취급은행지점AN4108●○취급 지점
6거래금액N13112●○입금 또는 취소 금액
7입금의뢰인명AN20125●○입금 시 입력된 의뢰인명
8수표금액N13145●○수표 입금 금액
9CMS_CDAN15158●○CMS 식별값
10모계좌정보AN14173●○은행에서 전달한 모계좌 정보
11신취급은행AN3187●○3자리 금융회사 코드
12FillerAN8190●○공백
13매체AN2198●○매체 코드

보험사 연동 중 신한은행과 하나은행 입금은 예금주명 필드에 실입금자명이 전달될 수 있습니다.


입금 처리

Unique Key

거래일자(8) + 기관코드(8) + 거래번호(7)
  • 동일 Unique Key의 입금이 다시 수신되면 원거래를 조회합니다.
  • 이미 처리한 거래라면 금액을 다시 반영하지 않고 정상 응답합니다.
  • 원거래가 없다면 신규 입금과 동일하게 처리합니다.

SAF 재전송

이용기관의 입금 응답을 받지 못하면 헥토파이낸셜이 기본 5분 간격으로 최대 5회 재전송할 수 있습니다. 이후 미처리 거래도 요청에 따라 재전송될 수 있으므로 멱등 처리가 필수입니다.


취소 대행 방식

헥토파이낸셜이 수취조회와 입금 거래를 대행하는 경우, 취소 처리 권한을 누가 갖는지 에 따라 두 가지로 나뉩니다. 이용기관이 어느 방식에 해당하는지 계약 시 확인하세요.

방식취소 처리 주체설명
수취대행이용기관취소 요구에 대한 결과를 이용기관이 결정하고, 그 응답값에 따라 취소가 처리됩니다. (자동취소 제외)
거래대행헥토파이낸셜이용기관으로부터 취소 처리 권한을 위임받아 헥토파이낸셜이 대신 처리합니다.
NOTE

자동취소는 방식과 무관

자동취소(공통부 자동취소여부 A)는 은행에서 이미 취소가 완료된 통지이므로, 수취대행·거래대행과 관계없이 이용기관이 원 입금을 반드시 취소 처리해야 합니다.

일반취소

  • 자행 창구 입금 정정 또는 타행환 입금 정정 요청으로 당일에 발생할 수 있습니다.
  • 일반적으로 창구 입금 건에서 발생합니다.
  • 이용기관의 취소 응답에 따라 은행 취소 결과가 결정됩니다.
  • 거래통보(SAF) 방식에서는 일반취소도 통보 방식으로 전달될 수 있습니다.
  • 취소 전문은 원 입금과 동일한 거래번호를 사용합니다.

취소 응답코드 0000, V601(원거래 없음), V607(이미 취소된 거래)는 은행에서 정상 취소 처리로 취급될 수 있으므로 원거래 상태를 정확히 확인한 뒤 응답하세요.


자동취소

자동취소는 은행 입금 처리 오류, 이용기관 응답 Timeout 또는 반드시 취소해야 하는 은행 거래로 인해 발생할 수 있습니다.

자동취소는 응답과 무관하게 완료된 거래

공통부 자동취소여부가 A인 취소는 은행에서 이미 취소가 완료된 통지입니다. 이용기관은 응답 결과와 관계없이 원 입금을 반드시 취소 처리해야 합니다.

자동취소 발생 가능 은행은 다음과 같습니다. (2026년 7월 24일 기준)

은행코드은행명은행코드은행명
003기업은행037전북은행
020우리은행039경남은행
023SC제일은행071우체국
027한국씨티은행088신한은행
031IM뱅크092토스뱅크
032부산은행
035제주은행

입금 지연 처리 옵션

자동취소 리스크를 줄이기 위해 입금 전문을 협의된 시간 동안 보류한 뒤, 해당 시간 안에 취소가 없을 경우 이용기관에 입금을 전달하는 옵션입니다.

  • 지연 시간 동안 동일 계좌·동일 금액의 중복 입금은 오류 처리됩니다.
  • 헥토파이낸셜 담당자와 사전 협의한 이용기관만 사용할 수 있습니다.
  • 지연 시간이 지난 뒤 수신한 자동취소는 이용기관이 직접 취소 처리해야 합니다.

주요 응답코드

코드의미
0000정상처리
V141기관 시스템 장애 또는 FORMAT 오류
V142기관 미개시
V151개설기관 서비스 시간이 아님
V309중복거래 또는 이중거래
V413기타 수취불가
V416기납부계좌 또는 불입횟수 초과
V601원거래 없음
V607이미 취소된 거래
V637취소불가 또는 취소거래 불가기관
V682입금기간 불일치
V683입금기간 만료
V713거래금액 오류
V783개설기관 BUSY 또는 기타 거래불가
V785기타 거래불가
V816해당계좌 없음
V817계좌 오류
VTIMTimeout
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?

코드 샘플

HectoFinancial GitHub