VAVS 시작하기
VAVS(Virtual Account VAN System)는 가상계좌 이용기관과 여러 은행 사이의 입금·송금·조회 업무를 하나의 채널로 중계하는 서비스입니다.
NOTE
PG 가상계좌 API와 다른 연동 규격
이 문서는 HTTP/JSON 기반 PG 가상계좌 API가 아닌 TCP/IP 고정길이 전문 방식의 VAVS 연동 규격입니다. 두 방식을 하나의 전문으로 혼용할 수 없습니다.
지원 업무
| 업무 | 설명 | 주요 전문 |
|---|---|---|
| 입금 | 고객이 은행 창구, CD/ATM, 인터넷·텔레뱅킹 등의 매체를 통해 가상계좌로 입금합니다. | 수취조회 2000, 입금 1000/3000, 취소 1010/3010 |
| 송금 | 고객 환불, 대리점 정산 등 이용기관에서 외부 계좌로 송금합니다. | 송금 6010, 예치금 잔액조회 6001 |
| 조회 | 입금 가능 여부, 가상계좌 예금주명 또는 송금 대상 계좌의 예금주명을 확인합니다. | 수취조회 2000, 성명조회 2001 |
| 정산 | 전일 입출금 건수와 금액을 집계하여 대사합니다. | 집계 7000 |
| 부가서비스 | 보험사 실입금자명 통보, 결번조회, 은행별 출금계좌 등록을 처리합니다. | 1030, 1033, 5080 |
입금 업무 흐름
수취조회 후 입금
은행
헥토파이낸셜
이용기관
11. 수취조회 요구 (2000)
1. 수취조회 요구 (2000)
22. 수취조회 요구 (2000)
2. 수취조회 요구 (2000)
33. 수취조회 응답 (2100)
3. 수취조회 응답 (2100)
44. 수취조회 응답 (2100)
4. 수취조회 응답 (2100)
55. 입금 요구 (1000/3000)
5. 입금 요구 (1000/3000)
66. 입금 요구 (1000/3000)
6. 입금 요구 (1000/3000)
77. 입금 응답 (1100/3100)
7. 입금 응답 (1100/3100)
88. 입금 응답 (1100/3100)
8. 입금 응답 (1100/3100)
수취조회 2000에 정상 응답한 뒤 발생한 본 입금 전문은 시스템 장애와 같은 예외가 아니라면 오류로 응답하지 않아야 합니다.
중복 입금 방지
입금 거래는 거래일자(8) + 기관코드(8) + 거래번호(7)를 Unique Key로 관리하세요. 동일 거래번호가 재전송되면 원거래 처리 여부를 확인하고, 이미 처리한 거래에는 중복 반영 없이 정상 응답해야 합니다.
입금 취소
- 입금 취소는 당일 입금 건에 한해 발생할 수 있습니다.
- 취소 전문은 원 입금과 동일한 거래번호로 전달됩니다.
- 취소 전문도 원거래와 취소 처리 여부를 확인하여 멱등하게 처리해야 합니다.
- 자동취소는 이용기관의 응답 결과와 관계없이 은행에서 이미 취소된 거래이므로 반드시 취소로 반영해야 합니다.
수취대행과 거래대행
| 방식 | 수취조회 | 일반취소 결정 |
|---|---|---|
| 수취대행 | 헥토파이낸셜이 수취조회를 대행 | 이용기관의 취소 응답에 따라 결정 |
| 거래대행 | 헥토파이낸셜이 수취조회와 입금거래를 대행 | 이용기관이 위임한 권한으로 헥토파이낸셜이 처리 |
자동취소는 대행 방식과 관계없이 은행에서 이미 완료된 취소이므로 이용기관 원장에 반드시 반영합니다.
송금 업무 흐름
이용기관
헥토파이낸셜
은행
11. 성명조회 요구 (2001, 선택)
1. 성명조회 요구 (2001, 선택)
22. 성명조회 전달
2. 성명조회 전달
33. 성명조회 응답 (2101)
3. 성명조회 응답 (2101)
44. 성명조회 결과
4. 성명조회 결과
55. 송금 요구 (6010)
5. 송금 요구 (6010)
66. 송금 전달
6. 송금 전달
77. 송금 응답 (6110)
7. 송금 응답 (6110)
88. 송금 결과
8. 송금 결과
송금은 은행 직접계약 방식과 재판매 방식으로 구분됩니다. 재판매 방식은 헥토파이낸셜이 지정한 예치금 계좌에 자금을 미리 입금하고 예치금 한도 내에서 송금합니다.
Timeout 거래 재처리
송금 Timeout은 은행에서 거래가 처리되었으나 응답만 유실된 상태일 수 있습니다. 당일에 한해 최초 거래와 동일한 사용자거래번호 및 동일 전문을 재전송하여 결과를 확인하고, 임의로 새로운 거래번호를 발급해 재송금하지 마세요.
운영 업무
- 은행과 헥토파이낸셜 사이의 운영관리 전문
8xxx는 이용기관이 직접 처리하지 않습니다. - 전일 집계 내역은 매일 약 00시 35분에 헥토파이낸셜에서 이용기관으로 전송됩니다.
- 필요한 경우 이용기관에서 집계
7000을 요청할 수 있습니다. - 별도 협의한 이용기관은 테스트콜로 회선 상태를 점검할 수 있습니다.
다음 단계
- 통신 및 전문 구성에서 TCP/IP 연결과 고정길이 규칙을 확인합니다.
- 전문 공통부를 공통 파서로 구현합니다.
- 사용할 업무별 개별부와 응답코드를 구현합니다.
- 테스트 환경에서 정상·중복·Timeout·자동취소 시나리오를 검증합니다.
