송금 (6010/6110)
이용기관이 고객 환불, 대리점 정산 등의 목적으로 지정 계좌에 자금을 이체할 때 사용하는 전문입니다.
전문 정보
| 항목 | 요구 | 응답 |
|---|---|---|
| 거래종류코드 | 6010 | 6110 |
| 방향 | 이용기관 → 은행 | 은행 → 이용기관 |
| 요청 가능 일자 | 당일 거래일자만 가능 | - |
이용기관
헥토파이낸셜
은행
11. 송금 요구 (6010)
1. 송금 요구 (6010)
22. 송금 요구 전달
2. 송금 요구 전달
33. 송금 응답 (6110)
3. 송금 응답 (6110)
44. 송금 응답 전달
4. 송금 응답 전달
계약 방식
| 방식 | 설명 |
|---|---|
| 은행 직접계약 | 이용기관이 은행과 직접 계약하고 헥토파이낸셜이 거래를 중계합니다. |
| 재판매 | 헥토파이낸셜이 지정한 예치금 계좌에 자금을 미리 입금하고 예치금 한도 내에서 송금합니다. |
성명조회 2001은 송금 전에 사용할 수 있지만 필수 선행 전문은 아닙니다.
공통부 주요 설정
| 항목 | MODE | 길이 | 요청 값 |
|---|---|---|---|
| 거래종류코드 | N | 4 | 6010 |
| 송수신코드 | N | 1 | 3 |
| 거래일자 | N | 8 | 당일 YYYYMMDD |
| 개설은행코드 | AN | 2 | 송금 업무 계약 은행코드 |
| 거래번호 | AN | 7 | 공백 또는 0000000; 응답 시 헥토파이낸셜이 설정 |
| 신개설은행코드 | AN | 3 | 계약 은행의 3자리 금융회사 코드 |
| 사용자거래번호 | N | 7 | 이용기관이 생성한 당일 고유 번호 |
| 발생구분 | AN | 1 | O |
| 전문전송방식 | A | 1 | Y |
사용자거래번호 중복 금지
사용자거래번호는 이용기관이 당일 중복되지 않게 생성하고 거래 결과가 확정될 때까지 보관해야 합니다. Timeout 재조회에도 최초 요청과 동일한 번호를 사용합니다.
개별부
| No | 항목 | MODE | 길이 | 위치 | 요구 | 응답 | 설명 |
|---|---|---|---|---|---|---|---|
| 1 | 공통부 | - | 70 | 0 | ● | ○ | 전문 공통부 |
| 2 | 입금계좌번호 | AN | 16 | 70 | ● | ○ | 자금을 받을 계좌번호 |
| 3 | 입금적요 | AN | 20 | 86 | ● | ○ | 수취 계좌에 표시할 적요 |
| 4 | 입금은행 | AN | 2 | 106 | ● | ○ | 수취 계좌의 2자리 은행코드 |
| 5 | 입금은행지점 | AN | 4 | 108 | - | - | 지점을 아는 경우 설정, 그 외 공백 |
| 6 | 거래금액 | N | 13 | 112 | ● | ○ | 송금 금액 |
| 7 | 입금의뢰인명 | AN | 20 | 125 | ● | ○ | 이용기관명 또는 보내는 사람 |
| 8 | 예비/잔액정보 | N | 13 | 145 | ● | ○ | 요청 시 0 채움, 지원 시 응답에 송금 가능 잔액 |
| 9 | CMS_CD | AN | 15 | 158 | ● | ○ | 고객번호 등이 필요한 경우 사용 |
| 10 | Filler | AN | 14 | 173 | ● | ○ | 공백 |
| 11 | 신은행코드 | AN | 3 | 187 | ● | ○ | 수취 계좌의 3자리 금융회사 코드 |
| 12 | Filler | AN | 10 | 190 | ● | ○ | 공백 |
재판매 송금과 일부 농협 송금에서는 응답의 송금 가능 잔액이 제공되지 않을 수 있습니다.
문자열 설정
입금적요와입금의뢰인명은 은행 정책에 따라 영문을 지원하지 않을 수 있으므로 한글 또는 숫자를 권장합니다.입금은행지점을 모르면 공백으로 채웁니다.CMS_CD를 사용하지 않으면 공백 또는 협의된 기본값으로 설정합니다.- 모든 필드는 인코딩 후 바이트 길이에 맞춰 패딩합니다.
요청 값 예시
| 필드 | 예시 |
|---|---|
| 입금계좌번호 | 86010018815 + 우측 공백 |
| 입금적요 | 환불 + 우측 공백 |
| 입금은행 | 23 |
| 거래금액 | 0000000000100 |
| 입금의뢰인명 | 헥토파이낸셜 + 우측 공백 |
| 예비/잔액정보 | 0000000000000 |
| 신은행코드 | 023 |
Timeout 및 재처리
VTIM 또는 V311은 은행 송금 결과를 받지 못한 상태입니다. 실패가 확정된 응답이 아닙니다.
- 최초 요청 전문과 사용자거래번호를 보관합니다.
- 당일에 한해 최초 거래와 동일한 전문을 재전송합니다.
- 재전송 응답으로 원거래 결과를 확인합니다.
- 업무 종료 시점까지 결과가 확정되지 않으면 헥토파이낸셜 운영 담당자에게 확인합니다.
새 거래로 임의 재송금 금지
Timeout 거래에 새로운 사용자거래번호를 부여해 다시 송금하면 원거래와 재거래가 모두 성공할 수 있습니다. 반드시 동일 전문으로 원거래 결과를 확인하세요.
주요 오류 응답코드
| 코드 | 의미 | 확인 사항 |
|---|---|---|
VTIM | Timeout | 동일 전문으로 당일 결과 확인 |
V311 | Timeout | 동일 전문으로 당일 결과 확인 |
V307 | 계좌번호 형식 오류 | 계좌번호 자리수와 패딩 확인 |
V309 | 이중송금 방지 | 당일 동일 계좌·동일 금액 거래 확인 |
V142 | 기관 미개시 | 최초 1회 재시도 후 반복되면 문의 |
V606 | 원거래 기타사항 상이 | 동일 사용자거래번호의 계좌·금액 비교 |
VDBE | 데이터베이스 시스템 장애 | 일시적 시스템 오류 |
V604 | 원거래 계좌 상이 | 요청 계좌 확인 |
U201 | 출금계좌 미등록 | 입출금 모계좌 계약·등록 확인 |
V210 | 거래일 부적당 | 거래일자가 당일인지 확인 |
V413 | 기타 수취불가 | 수취 계좌 상태 확인 |
V901 | 잔액부족 | 재판매 예치금 또는 출금 가능 잔액 확인 |
운영 주의사항
- 송금 권장 시간은
01:00~23:00입니다. - 은행 업무 마감에 임박하면 신규 송금과 Timeout 재처리 오류가 증가할 수 있습니다.
- 한 요청의 응답을 수신한 뒤 다음 송금 요청을 전송하는 방식으로 순서를 관리합니다.
- 재판매 방식은 예치금 부족 시 송금할 수 없습니다.
