실입금자명 파일 통보
보험사 등 협의된 이용기관에 가상계좌 실입금자 정보를 고정길이 파일로 제공합니다.
파일명
ISR{기관구분}{거래일자}
예: ISR01YYYYMMDD, ISR02YYYYMMDD
기관구분 값과 전송 경로·시간은 계약 후 제공되는 파일 연동 규격을 따릅니다.
파일 구성
파일은 헤더 1건, 데이터 0건 이상, 트레일러 1건으로 구성됩니다.
Header
Data
Data
...
Trailer
거래내역이 없는 날도 헤더와 트레일러가 포함된 빈 데이터 파일을 전송합니다.
헤더
| No | 항목 | 형식 | 길이 | 누적 | 설명 |
|---|---|---|---|---|---|
| 1 | 식별부호 | A | 1 | 1 | H |
| 2 | 기관코드 | A | 8 | 9 | 헥토파이낸셜이 부여한 기관코드 |
| 3 | 거래일자 | A | 8 | 17 | YYYYMMDD |
| 4 | 공백 | A | 131 | 148 | SPACE |
| 5 | 줄바꿈 | A | 2 | 150 | CRLF |
데이터
| No | 항목 | 형식 | 길이 | 누적 | 설명 |
|---|---|---|---|---|---|
| 1 | 식별부호 | A | 1 | 1 | D |
| 2 | 기관코드 | A | 8 | 9 | 이용기관 코드 |
| 3 | 은행코드 | A | 2 | 11 | 입금 취급은행 |
| 4 | 거래번호 | A | 7 | 18 | 헥토파이낸셜 거래번호 |
| 5 | 은행거래번호 | A | 20 | 38 | 은행이 부여한 거래번호 |
| 6 | 거래일자 | A | 8 | 46 | YYYYMMDD |
| 7 | 거래시간 | A | 6 | 52 | HHMMSS |
| 8 | 계좌번호 | A | 16 | 68 | 가상계좌번호 |
| 9 | 거래금액 | N | 13 | 81 | 원 단위, 0 채움 |
| 10 | 실입금자명 | A | 50 | 131 | 실제 송금계좌 예금주명 |
| 11 | 공백 | A | 17 | 148 | SPACE |
| 12 | 줄바꿈 | A | 2 | 150 | CRLF |
트레일러
| No | 항목 | 형식 | 길이 | 누적 | 설명 |
|---|---|---|---|---|---|
| 1 | 식별부호 | A | 1 | 1 | T |
| 2 | 전체건수 | N | 7 | 8 | 헤더·데이터·트레일러를 포함한 전체 라인 수 |
| 3 | 공백 | A | 140 | 148 | SPACE |
| 4 | 줄바꿈 | A | 2 | 150 | CRLF |
검증 순서
- 파일명이 협의된 기관구분과 거래일자 형식인지 확인합니다.
- 각 라인이 CRLF를 포함해 150바이트인지 확인합니다.
- 첫 라인이
H, 마지막 라인이T인지 확인합니다. - 트레일러 전체건수와 실제 라인 수가 같은지 확인합니다.
기관코드와 거래일자가 헤더 및 데이터에서 일치하는지 확인합니다.거래일자 + 기관코드 + 거래번호기준으로 중복 반영을 방지합니다.
문자 수가 아닌 바이트 수
파일 인코딩은 EUC-KR입니다. 실입금자명에 한글이 포함되므로 문자열 길이가 아니라 EUC-KR로 인코딩한 바이트 길이가 정확히 150바이트인지 검증해야 합니다.
