입금 및 취소

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

거래 코드

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

은행

헥토파이낸셜

이용기관

11. 입금 요구 (1000/3000)

1. 입금 요구 (1000/3000)

22. 입금 요구 전달

2. 입금 요구 전달

33. 입금 응답 (1100/3100)

3. 입금 응답 (1100/3100)

44. 입금 응답 전달

4. 입금 응답 전달

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

거래일자(8) + 기관코드(8) + 거래번호(7)

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

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

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

NOTE

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

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

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

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

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

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

더 궁금한 내용이 있나요?

기술지원이 필요한가요?

코드 샘플