헥토파이낸셜 개발자센터
Products서비스
PG 결제
다양한 간편 결제
내통장결제
실시간 계좌이체 서비스
간편현금결제
계좌 등록 / 결제 / 송금
화이트라벨
브랜드페이-통합결제지원
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
LLMs로 연동하기
MCP 서버 및 AI 챗봇
API & SDKAPI & SDK
PG 결제
다양한 간편 결제
내통장결제
실시간 계좌이체 서비스
간편현금결제
계좌 등록 / 결제 / 송금
화이트라벨
브랜드페이-통합결제지원
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
블로그블로그
FAQFAQ
서비스 상태
PG 결제
내통장결제
간편현금결제
화이트라벨
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
LLMs로 연동하기
MCP 서버 및 AI 챗봇
PG 결제
내통장결제
간편현금결제
화이트라벨
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
블로그
기술 블로그 및 소식
FAQ
자주 묻는 질문
서비스 상태
서비스 장애 및 점검 현황
시작하기신용카드 결제가상계좌 결제010 가상계좌계좌이체 결제휴대폰 결제상품권 결제포인트 다모아간편결제
내통장결제
펌뱅킹오픈뱅킹
화이트라벨
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
LLMs로 연동하기
시작하기신용카드 결제가상계좌 결제010 가상계좌계좌이체 결제휴대폰 결제상품권 결제포인트 다모아간편결제
내통장결제
펌뱅킹오픈뱅킹
화이트라벨
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
LLMs로 연동하기
서비스VAN 가상계좌

VAN 가상계좌 (VAVS)

VAN 가상계좌란

고객마다 서로 다른 계좌번호를 발급해 입금을 자동으로 구분하고 싶다고 생각해보세요. 여러 은행과 각각 연동하고, 입금이 들어올 때마다 어느 주문인지 대조하는 일은 업무량이 많아질수록 감당하기 어렵습니다.

VAN 가상계좌(VAVS, Virtual Account VAN System)는 은행 계좌 체계와 동일한 가상계좌를 이용해, 이용기관 시스템과 여러 은행 사이의 입금·송금·성명조회 업무를 단일 채널로 중계하는 서비스입니다. 헥토파이낸셜을 통해 연동하면 전 은행의 가상계좌 입금을 하나의 전문 규격으로 처리할 수 있습니다.

이런 업무에 사용해요

  • 가상계좌 입금 : 고객에게 부여한 가상계좌로 전 은행의 모든 매체(CD/ATM, 인터넷·텔레뱅킹, 창구 등)에서 입금받고, 실시간으로 확인합니다.
  • 송금(이체) : 고객 환불이나 대리점·고객 계좌로의 이체가 필요할 때 사용합니다.
  • 성명조회 : 송금 전이나 계좌 인증을 위해 예금주명을 확인합니다.

주요 업무

업무설명주요 전문
수취조회입금 직전, 은행이 가상계좌의 입금 가능 여부와 표시할 예금주명을 이용기관에 확인합니다.2000/2100
입금·취소고객 입금을 처리하고, 당일 입금분에 한해 자동취소(시스템)·일반취소(고객)를 처리합니다.1000/1100, 3000/3100, 1010/3010
송금고객 계좌로 이체합니다. 은행 직접계약 방식과 예치금 기반 재판매 방식이 있습니다.6010/6110
성명조회예금주명을 조회합니다. 송금 전 계좌 검증에 활용됩니다.2001/2101
부가 업무실입금자명 통보, 출금계좌 등록, 집계(대사) 등을 지원합니다.1030, 5080, 7000

입금 처리 흐름

고객이 가상계좌로 입금을 시도하면, 은행이 먼저 수취조회(2000) 로 입금 가능 여부를 확인하고, 이용기관이 정상 응답하면 본 입금(1000/3000) 전문이 이어집니다.

고객
은행
헥토파이낸셜
이용기관
11. 가상계좌 입금 시도
1. 가상계좌 입금 시도
22. 수취조회 요구 (2000)
2. 수취조회 요구 (2000)
33. 수취조회 요구 (2000)
3. 수취조회 요구 (2000)
44. 수취조회 응답 (2100)
4. 수취조회 응답 (2100)
55. 수취조회 응답 (2100)
5. 수취조회 응답 (2100)
66. 입금 요구 (1000/3000)
6. 입금 요구 (1000/3000)
77. 입금 요구 (1000/3000)
7. 입금 요구 (1000/3000)
88. 입금 응답 (1100/3100)
8. 입금 응답 (1100/3100)

정상 수취조회 이후 입금은 거절하지 않아요

수취조회(2000)에 정상 응답한 뒤 들어오는 본 입금 전문은 시스템 장애 등이 아니라면 오류로 응답하면 안 됩니다. 이미 은행에서 입금이 완료된 상태이며, 오류 응답 시 헥토파이낸셜이 SAF(재전송)로 재통보합니다. (기본 5분 간격, 총 5회)

입금은 거래일자 + 기관코드 + 거래번호 를 Unique Key로 처리하므로, 재전송으로 동일 거래번호를 다시 받으면 원거래를 확인해 중복 입금을 방지합니다.

통신 방식

VAN 가상계좌는 일반 HTTP REST API가 아닌 TCP/IP 소켓 통신 으로 고정길이 전문을 주고받습니다. 원화 펌뱅킹과 같은 방식이지만, 공통부와 거래코드 체계가 다른 별도 규격입니다.

항목내용
프로토콜TCP/IP 소켓
전문 크기공통부 70B + 개별부 130B = 200B
인코딩EUC-KR
연결은행 ↔ 헥토파이낸셜 전용선 또는 인터넷

수취대행과 거래대행

헥토파이낸셜이 수취조회와 입금 거래를 대행하는 경우, 취소 처리 권한 에 따라 두 방식으로 나뉩니다.

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

주의사항

항목내용
본 입금 오류 응답 금지수취조회에 정상 응답한 뒤 들어오는 본 입금 전문은 오류로 응답하면 안 됩니다. 오류 응답 시 SAF(재전송)로 재통보됩니다.
중복 처리 방지거래일자 + 기관코드 + 거래번호를 Unique Key로 사용하고, 재전송 시 원거래를 확인해 중복 입금을 방지해야 합니다.
당일 취소만 가능입금 취소 전문은 당일 입금분에 한해 발생하며, 입금과 동일한 거래번호로 요청됩니다.
전문 포맷 엄수고정길이 전문이므로 필드 길이·위치·인코딩(EUC-KR)이 정확해야 합니다. 형식이 어긋나면 은행 시스템에서 오류 코드를 반환합니다.
서비스 신청 필요VAN 가상계좌는 별도 계약 및 은행 심사가 필요합니다. 영업담당자를 통해 문의해 주세요. ()

VAN 가상계좌 개발 문서 바로가기

🚀

연동 시작하기

통신 규격 및 전문 공통부

💰

입금·수취조회

수취조회, 입금 및 취소

💸

송금

송금, 예치금 잔액조회

🔍

성명조회·부가

성명조회, 실입금자명, 출금계좌등록

📊

집계·참조

집계 대사, 은행·응답·매체 코드

❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?

코드 샘플

HectoFinancial GitHub