국내 외화 예금주명 조회 (6000/450)
국내 외화계좌의 예금주명을 조회하는 전문입니다. 당행/타행 외화계좌 모두 조회 가능합니다.
전문 정보
| 항목 | 요청 | 응답 |
|---|---|---|
| 전문코드 | 6000 | 6100 |
| 업무구분 | 450 | 450 |
| 방향 | 업체→은행 | 은행→업체 |
| 전문 크기 | 2000 바이트 (공통부 100 + 개별부 1900) |
은행별 제한사항
우리은행은 당행 예금주명 조회 시 수취인정보(한글)가 최대 12바이트만 리턴됩니다. 하나은행은 생년월일 확인을 하지 않습니다. 산업은행은 사용 불가합니다.
NOTE
우리은행 거주구분 연계
우리은행 외화송금(2000/400) 송금구분 4(금결원) 시 이 전문에서 리턴받은 거주자/비거주자 구분 값을 세팅해야 합니다.
공통부 (100 바이트)
모든 실시간 펌뱅킹 전문의 공통 헤더입니다.
| No | 항목 | 위치 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| 1 | 식별코드 | 0 | 9 | Y | 수신자의 TRANSACTION CODE (SETTLEBNK 또는 SPACE) |
| 2 | 업체번호 | 9 | 12 | Y | 헥토파이낸셜에서 부여한 업체번호 |
| 3 | 은행코드 | 21 | 3 | Y | 펌뱅킹 계약된 개설은행코드 |
| 4 | 전문구분코드 | 24 | 4 | Y | 전문코드 (요청: 6000, 응답: 6100) |
| 5 | 업무구분코드 | 28 | 3 | Y | 업무구분 (450) |
| 6 | 송신회수 | 31 | 1 | Y | '1' 고정 |
| 7 | 전문번호 | 32 | 6 | Y | 일별 Unique 전문번호 (MAX 950,000) |
| 8 | 전송일자 | 38 | 8 | Y | 전문전송 일자 (YYYYMMDD) |
| 9 | 전송시간 | 46 | 6 | Y | 전문전송시간 (hhmmss) |
| 10 | 응답코드 | 52 | 4 | - | 응답코드 (에러코드), 요청 시 SPACE |
| 11 | 예비영역 | 56 | 44 | - | 헥토파이낸셜 고유영역 |
개별부 (1900 바이트)
요청/응답 파라미터
| No | 항목 | 위치 | 길이 | 요청 | 응답 | 설명 |
|---|---|---|---|---|---|---|
| 1 | 주민(사업자)번호 | 100 | X(13) | Y | - | |
| 2 | 고객번호 | 113 | X(10) | Y | - | 은행내부관리번호 |
| 3 | 송금인 영문명 | 123 | X(35) | Y | - | |
| 4 | 수취인 은행코드 | 158 | X(3) | Y | - | |
| 5 | 수취인 계좌번호 | 161 | X(16) | Y | - | |
| 6 | 거래통화 | 177 | X(3) | Y | - | |
| 7 | 거래금액 | 180 | 9(15) | Y | - | 정수 12, 소수점 이하 3 (12,3) |
| 8 | 수취인정보(한글) | 195 | X(44) | - | Y | |
| 9 | 수취인정보(영문) | 239 | X(42) | - | Y | |
| 10 | 지급은행지점코드 | 281 | X(7) | - | Y | |
| 11 | 거래가능여부 | 288 | X(1) | - | Y | |
| 12 | 거주자/비거주자구분 | 289 | X(2) | - | Y | 첫번째:송금인거주구분, 두번째:수취인거주구분. 1:거주자, 2:비거주자 |
| 13 | CMS계좌여부 | 291 | X(1) | - | Y | 외환은행만 사용. Y:CMS계좌, N:CMS계좌아님 |
| 14 | 삼성화재영역 | 292 | X(143) | - | - | 외환은행 사용 |
| 15 | 예비 | 435 | X(1565) | - | - | SPACE |
NOTE
거래통화 참고
하나은행의 경우 외화계좌가 38로 끝나는 다통화계좌가 아닌 단일통화계좌는 통화코드를 체크하지 않습니다.
전문 구조
요청 전문 (2000 바이트)2000 bytes
공통부100B · offset 0
식별코드9 · 0
업체번호12 · 9
은행코드3 · 21
전문구분코드4 · 24
업무구분코드3 · 28
송신회수1 · 31
전문번호6 · 32
전송일자8 · 38
전송시간6 · 46
응답코드4 · 52
예비영역44 · 56
개별부1900B · offset 100
주민(사업자)번호13 · 100
고객번호10 · 113
송금인 영문명35 · 123
수취인 은행코드3 · 158
수취인 계좌번호16 · 161
거래통화3 · 177
거래금액15 · 180
수취인정보(한글)44 · 195
수취인정보(영문)42 · 239
지급은행지점코드7 · 281
거래가능여부1 · 288
거주자/비거주자구분2 · 289
CMS계좌여부1 · 291
삼성화재영역143 · 292
예비1565 · 435
필수
선택
응답전용 / 예비
길이 · 위치응답 코드
응답코드는 은행별로 상이하며, 코드 리스트는 해당 은행이나 헥토파이낸셜에 요청할 수 있습니다.
- 공통부 응답코드 항목은 요청 전문에는 SPACE로 세팅하며, 응답 전문에는 해당 에러코드를 세팅합니다.
- 응답코드 중 VTIM의 경우 응답시간초과 세션에러이므로 오류응답이 아닙니다. (3000/700이 안 올 경우, 3000/800으로 확인)
