계좌성명조회 (6000/100)
이체 전 계좌 유효성 및 예금주명을 확인하는 전문입니다. 이체 예비거래로 사용됩니다.
전문 정보
| 항목 | 요청 | 응답 |
|---|---|---|
| 전문코드 | 6000 | 6100 |
| 업무구분 | 100 | 100 |
| 방향 | 업체→은행 | 은행→업체 |
NOTE
이체 전 필수 조회
대금 지급 전 반드시 계좌성명조회를 수행하여 예금주를 확인하는 것을 권장합니다.
공통부 (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 | 업무구분 (100) |
| 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 | - | 헥토파이낸셜 고유영역 |
개별부 (200 바이트)
요청/응답 파라미터
| No | 항목 | 위치 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| 1 | 계좌번호 | 100 | 15 | Y | 조회할 계좌번호 |
| 2 | 실명번호 | 115 | 13 | Y | 생년월일(YYMMDD) 또는 사업자번호 |
| 3 | 예금주명1 | 128 | 12 | - | 예금주명 최대 12바이트 (응답) |
| 4 | 은행코드 | 140 | 3 | Y | 조회할 은행코드 |
| 5 | 금액 | 143 | 13 | Y | 조회금액 |
| 6 | 모계좌번호 | 156 | 15 | N | 특정 은행에서 사용 (새마을금고, 광주은행, 신협 등) |
| 7 | 실명번호체크구분 | 171 | 2 | N | 2014년 8월 7일부터 사용불가 |
| 8 | 예금주명2 | 173 | 20 | - | 예금주명 최대 20바이트 (응답, 특정 은행) |
| 9 | 계좌고정여부 | 193 | 1 | - | 인출제한여부 (Y: 제한, N: 제한없음) (응답) |
| 10 | 계좌상태 | 194 | 1 | - | 개설/해지상태 (N: 개설, C: 해지) (응답) |
| 11 | 계좌상태일자 | 195 | 8 | - | 계좌상태 적용일자 (응답) |
| 12 | 등록기관코드 | 203 | 2 | - | 등록기관 (01: 조달청, 02: 클린페이) (응답) |
| 13 | 카카오페이상품코드 | 205 | 8 | N | 농협 카카오페이 전용 |
| 14 | 예비 | 213 | 87 | - | SPACE |
전문 구조
계좌성명조회 요청 전문 (300 바이트)300 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
개별부200B · offset 100
계좌번호15 · 100
실명번호13 · 115
예금주명112 · 128
은행코드3 · 140
금액13 · 143
모계좌번호15 · 156
실명번호체크구분2 · 171
예금주명220 · 173
계좌고정여부1 · 193
계좌상태1 · 194
계좌상태일자8 · 195
등록기관코드2 · 203
카카오페이상품코드8 · 205
예비87 · 213
필수
선택
응답전용 / 예비
길이 · 위치응답 파라미터
| No | 항목 | 위치 | 길이 | 설명 |
|---|---|---|---|---|
| 3 | 예금주명1 | 128 | 12 | 예금주명 (최대 12바이트) |
| 8 | 예금주명2 | 173 | 20 | 예금주명 (최대 20바이트, 특정 은행) |
| 9 | 계좌고정여부 | 193 | 1 | 인출제한여부 (Y/N) |
| 10 | 계좌상태 | 194 | 1 | 개설/해지상태 (N/C) |
| 11 | 계좌상태일자 | 195 | 8 | 계좌상태 적용일자 |
| 12 | 등록기관코드 | 203 | 2 | 등록기관 (조달청/클린페이 한정) |
사용 시나리오
1. 업체 → 은행: 계좌성명조회 요청 (6000/100)
2. 은행 → 업체: 계좌성명조회 응답 (6100/100)
- 정상: 예금주명 반환
- 실패: 응답코드에 에러코드 세팅
3. 예금주 확인 후 이체 진행 (2000/100)
주의사항
- 농협 지준이체 시 계좌성명조회 전문번호를 이체전문(2000/100)의 원거래전문번호 필드에 세팅해야 합니다.
- 응답코드는 은행별로 상이합니다.
- 예금주명은 일반 은행은 최대 12바이트(예금주명1)이며, 특정 은행(기업, 수협, 농협, 우리, SC, 광주, 새마을, 신협, 제주, 경남, 케이뱅크, 카카오뱅크, 토스뱅크)은 20바이트(예금주명2)를 제공합니다.
- 계좌고정여부/계좌상태/계좌상태일자/등록기관코드(9~12항목)는 조달청, 클린페이에 한합니다.
- 개인사업자 계좌는 생년월일로 조회 가능합니다.
