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 가상계좌는 별도 계약 및 은행 심사가 필요합니다. 영업담당자를 통해 문의해 주세요. () |
