헥토파이낸셜 개발자센터
Products서비스
PG 결제
다양한 간편 결제
내통장결제
실시간 계좌이체 서비스
간편현금결제
계좌 등록 / 결제 / 송금
화이트라벨
브랜드페이-통합결제지원
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
LLMs로 연동하기
MCP 서버 및 AI 챗봇
API & SDKAPI & SDK
PG 결제
다양한 간편 결제
내통장결제
실시간 계좌이체 서비스
간편현금결제
계좌 등록 / 결제 / 송금
화이트라벨
브랜드페이-통합결제지원
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
블로그블로그
FAQFAQ
서비스 상태
PG 결제
내통장결제
간편현금결제
화이트라벨
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
LLMs로 연동하기
MCP 서버 및 AI 챗봇
PG 결제
내통장결제
간편현금결제
화이트라벨
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
블로그
기술 블로그 및 소식
FAQ
자주 묻는 질문
서비스 상태
서비스 장애 및 점검 현황
PG 결제
연동 준비하기서버 및 네트워크 정보전체 연동 플로우노티(notiUrl) 연동결제 취소 및 환불운영 전환
결제창 연동JavaScript SDKFORM-SUBMIT
신용카드 표준 결제창신용카드 결제창 (직호출)신용카드 노티 전문신용카드 승인 (인증분리)신용카드 카드등록 (빌키발급 결제창)신용카드 빌키 결제신용카드 빌키 삭제신용카드 취소
계좌이체 결제창계좌이체 노티 전문계좌이체 승인 (인증분리)계좌이체 취소
가상계좌 결제창가상계좌 노티 전문가상계좌 채번가상계좌 채번 (고정식 무제한)가상계좌 채번정보 변경가상계좌 채번취소가상계좌 수취 조회가상계좌 환불가상계좌 입금테스트
010 가상계좌 개요010가상계좌 결제창휴대폰 점유 인증 요청휴대폰 인증 확인동일 금액 확인010가상계좌 채번010가상계좌 채번취소010가상계좌 환불010가상계좌 노티010가상계좌 입금테스트
휴대폰 결제창휴대폰결제 노티 전문휴대폰 승인 (하이브리드)휴대폰 자동결제휴대폰결제 취소휴대폰결제 환불
상품권 결제창상품권 노티 전문상품권 취소
티머니 결제창티머니 노티 전문티머니 취소
포인트다모아 결제창포인트다모아 노티 전문포인트다모아 승인 (인증/승인 분리)포인트다모아 취소
간편결제 개요페이코 결제창페이코 테스트 환경삼성페이 결제창카카오페이 결제창네이버페이 결제창토스페이 결제창간편결제 노티 전문간편결제 취소간편 정기결제간편 정기결제 상태조회간편 정기결제 키삭제
실시간 거래 조회영수증(매출전표) 조회 (무인증)영수증(매출전표) 조회 (인증)거래대사정산대사2차 이하 PG하위사업자 정보 등록영중소사업자 차액정산영중소사업자 환급정산
에러 코드카드사 코드금융기관 코드결제수단 코드가상계좌 은행 코드
내통장결제
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
결제창 연동
내통장 결제인증내통장 결제승인내통장 결제취소내통장 망취소
내통장 거래결과조회내통장 거래내역조회현금영수증 조회
내통장 자동결제 키 발급내통장 자동결제 승인내통장 자동결제 해지
에러 코드금융기관 코드은행 점검시간
간편현금결제
연동 준비하기서버 및 네트워크 정보펌뱅킹 연동 플로우
휴대폰 본인인증 요청휴대폰 본인인증 확인예금주성명조회Ⅰ예금주성명조회Ⅱ예금주성명조회 (금액포함)계좌점유인증계좌점유인증 요청계좌점유인증 확인ARS 인증 요청ARS 인증 확인계좌점유인증 내역 조회결제비밀번호 확인
계좌 등록계좌 해지가맹점 자체 계좌 등록금융결제원 출금이체정보 해지 조회
결제결제 취소/환불송금송금계좌 잔액 조회
정기결제 키 발행정기결제 승인정기결제 해지정기결제 정보 조회정기결제 거래내역 조회
거래 결과 조회거래 내역 조회계좌 목록 조회은행 목록 조회은행 점검 조회계좌점유인증 은행점검조회테스트콜
연동 준비하기서버 및 네트워크 정보오픈뱅킹 연동 플로우
계좌 등록오픈뱅킹 계좌등록오픈뱅킹 서비스해지
결제결제 취소송금
자금반환청구 요청자금반환청구 확인
거래 결과 조회거래내역조회계좌목록조회출금이체한도 조회
거절코드표금융기관코드표은행 점검시간
화이트라벨
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
결제창결제 승인결제 취소
조회
에러 코드금융기관 코드은행 점검시간
현금영수증
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
현금영수증 등록현금영수증 취소
현금영수증 발급오류내역 조회현금영수증 발급상태 조회
현금영수증 재처리 등록현금영수증 재처리 결과내역 조회
참고
실시간 펌뱅킹
연동 준비하기전체 연동 플로우
관리전문
당타행 지급이체집금(수납) 이체수납출금계좌 등록/해지일반지준이체 (SC은행)특정금전신탁 입지급 (우리은행)
타행이체불능통지예금거래명세통지어음명세통지어음명세결번일반지준이체결과통지 (SC은행)타행이체불능통지결번예금거래명세통지결번
계좌성명조회이체처리결과조회잔액조회일반지준이체결과조회 (SC은행)자동이체결과조회 (SC은행 전용)
자금이체집계집금이체집계통지현황
관리전문
외화송금의뢰외화송금의뢰취소외화송금결과통지외화송금결과통지 결번외화송금의뢰(MX)외화송금결과통지(MX)외화송금결과통지결번(MX)
국내 외화 당행 예금주명조회국내 외화 예금주명 조회환율정보거래환율정보거래(외환은행)외화 송금처리결과 조회외화잔액조회
외화송금집계외화자동이체집계외화당행송금집계
외화입출금거래명세통지외화입출금거래명세통지 결번
VAN 가상계좌
VAVS 시작하기통신 및 전문 구성전문 공통부
수취조회 (2000/2100)입금 및 취소
송금 (6010/6110)예치금 잔액조회 (6001/6101)
요약전문
성명조회 (2001/2101)실입금자명 통보 (1030/1130)실입금자명 파일 통보실입금자명 결번요청 (1033/1133)출금계좌등록 (5080/5180)
은행 코드응답 코드매체 코드은행 운영 및 점검시간
안심선불
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
회원가입 화면 연동내정보 화면 연동
선불금 사용사용 취소머니 선물포인트 회수
잔액 조회잔액 옵션 조회잔액 상세 조회충전건별 잔액조회출금 가능 머니 조회거래 내역 조회거래 상세 조회상점 거래 상세 조회회원 정보 조회소멸 예정 포인트 조회충전 수단 조회
충전충전 취소머니 출금대기머니 출금
오류 코드거래구분코드

도구

암호화 테스트
PG 결제
연동 준비하기서버 및 네트워크 정보전체 연동 플로우노티(notiUrl) 연동결제 취소 및 환불운영 전환
결제창 연동JavaScript SDKFORM-SUBMIT
신용카드 표준 결제창신용카드 결제창 (직호출)신용카드 노티 전문신용카드 승인 (인증분리)신용카드 카드등록 (빌키발급 결제창)신용카드 빌키 결제신용카드 빌키 삭제신용카드 취소
계좌이체 결제창계좌이체 노티 전문계좌이체 승인 (인증분리)계좌이체 취소
가상계좌 결제창가상계좌 노티 전문가상계좌 채번가상계좌 채번 (고정식 무제한)가상계좌 채번정보 변경가상계좌 채번취소가상계좌 수취 조회가상계좌 환불가상계좌 입금테스트
010 가상계좌 개요010가상계좌 결제창휴대폰 점유 인증 요청휴대폰 인증 확인동일 금액 확인010가상계좌 채번010가상계좌 채번취소010가상계좌 환불010가상계좌 노티010가상계좌 입금테스트
휴대폰 결제창휴대폰결제 노티 전문휴대폰 승인 (하이브리드)휴대폰 자동결제휴대폰결제 취소휴대폰결제 환불
상품권 결제창상품권 노티 전문상품권 취소
티머니 결제창티머니 노티 전문티머니 취소
포인트다모아 결제창포인트다모아 노티 전문포인트다모아 승인 (인증/승인 분리)포인트다모아 취소
간편결제 개요페이코 결제창페이코 테스트 환경삼성페이 결제창카카오페이 결제창네이버페이 결제창토스페이 결제창간편결제 노티 전문간편결제 취소간편 정기결제간편 정기결제 상태조회간편 정기결제 키삭제
실시간 거래 조회영수증(매출전표) 조회 (무인증)영수증(매출전표) 조회 (인증)거래대사정산대사2차 이하 PG하위사업자 정보 등록영중소사업자 차액정산영중소사업자 환급정산
에러 코드카드사 코드금융기관 코드결제수단 코드가상계좌 은행 코드
내통장결제
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
결제창 연동
내통장 결제인증내통장 결제승인내통장 결제취소내통장 망취소
내통장 거래결과조회내통장 거래내역조회현금영수증 조회
내통장 자동결제 키 발급내통장 자동결제 승인내통장 자동결제 해지
에러 코드금융기관 코드은행 점검시간
간편현금결제
연동 준비하기서버 및 네트워크 정보펌뱅킹 연동 플로우
휴대폰 본인인증 요청휴대폰 본인인증 확인예금주성명조회Ⅰ예금주성명조회Ⅱ예금주성명조회 (금액포함)계좌점유인증계좌점유인증 요청계좌점유인증 확인ARS 인증 요청ARS 인증 확인계좌점유인증 내역 조회결제비밀번호 확인
계좌 등록계좌 해지가맹점 자체 계좌 등록금융결제원 출금이체정보 해지 조회
결제결제 취소/환불송금송금계좌 잔액 조회
정기결제 키 발행정기결제 승인정기결제 해지정기결제 정보 조회정기결제 거래내역 조회
거래 결과 조회거래 내역 조회계좌 목록 조회은행 목록 조회은행 점검 조회계좌점유인증 은행점검조회테스트콜
연동 준비하기서버 및 네트워크 정보오픈뱅킹 연동 플로우
계좌 등록오픈뱅킹 계좌등록오픈뱅킹 서비스해지
결제결제 취소송금
자금반환청구 요청자금반환청구 확인
거래 결과 조회거래내역조회계좌목록조회출금이체한도 조회
거절코드표금융기관코드표은행 점검시간
화이트라벨
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
결제창결제 승인결제 취소
조회
에러 코드금융기관 코드은행 점검시간
현금영수증
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
현금영수증 등록현금영수증 취소
현금영수증 발급오류내역 조회현금영수증 발급상태 조회
현금영수증 재처리 등록현금영수증 재처리 결과내역 조회
참고
실시간 펌뱅킹
연동 준비하기전체 연동 플로우
관리전문
당타행 지급이체집금(수납) 이체수납출금계좌 등록/해지일반지준이체 (SC은행)특정금전신탁 입지급 (우리은행)
타행이체불능통지예금거래명세통지어음명세통지어음명세결번일반지준이체결과통지 (SC은행)타행이체불능통지결번예금거래명세통지결번
계좌성명조회이체처리결과조회잔액조회일반지준이체결과조회 (SC은행)자동이체결과조회 (SC은행 전용)
자금이체집계집금이체집계통지현황
관리전문
외화송금의뢰외화송금의뢰취소외화송금결과통지외화송금결과통지 결번외화송금의뢰(MX)외화송금결과통지(MX)외화송금결과통지결번(MX)
국내 외화 당행 예금주명조회국내 외화 예금주명 조회환율정보거래환율정보거래(외환은행)외화 송금처리결과 조회외화잔액조회
외화송금집계외화자동이체집계외화당행송금집계
외화입출금거래명세통지외화입출금거래명세통지 결번
VAN 가상계좌
VAVS 시작하기통신 및 전문 구성전문 공통부
수취조회 (2000/2100)입금 및 취소
송금 (6010/6110)예치금 잔액조회 (6001/6101)
요약전문
성명조회 (2001/2101)실입금자명 통보 (1030/1130)실입금자명 파일 통보실입금자명 결번요청 (1033/1133)출금계좌등록 (5080/5180)
은행 코드응답 코드매체 코드은행 운영 및 점검시간
안심선불
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
회원가입 화면 연동내정보 화면 연동
선불금 사용사용 취소머니 선물포인트 회수
잔액 조회잔액 옵션 조회잔액 상세 조회충전건별 잔액조회출금 가능 머니 조회거래 내역 조회거래 상세 조회상점 거래 상세 조회회원 정보 조회소멸 예정 포인트 조회충전 수단 조회
충전충전 취소머니 출금대기머니 출금
오류 코드거래구분코드

도구

암호화 테스트

외화송금의뢰 (2000/400)

외화 자금을 해외 또는 국내 외화계좌로 송금하는 전문입니다. 동종화폐간 이체만 가능합니다.


전문 정보

항목요청응답
전문코드20002100
업무구분400400
방향업체→은행은행→업체
전문 크기2000 바이트 (공통부 100 + 개별부 1900)

동종화폐 이체만 가능

외화송금의뢰는 동종화폐간 이체만 가능합니다. 예: USD→USD, JPY→JPY

우리은행 당행거래 주의

우리은행은 송금구분이 3(당행거래)일 때 전문응답을 못 받았을 경우 은행 또는 헥토파이낸셜에 유선으로 확인해야 합니다.
NOTE

송금결과 확인

해외송금(1), 국내송금(2) 시에는 외화송금결과통지(3000/700)를 최종 확인해야 합니다. 당행이체(3), 금결원 경유(4)는 송금응답으로 처리가 완료됩니다.

공통부 (100 바이트)

모든 실시간 펌뱅킹 전문의 공통 헤더입니다.

No항목위치길이필수설명
1식별코드09Y수신자의 TRANSACTION CODE (SETTLEBNK 또는 SPACE)
2업체번호912Y헥토파이낸셜에서 부여한 업체번호
3은행코드213Y펌뱅킹 계약된 개설은행코드
4전문구분코드244Y전문코드 (요청: 2000, 응답: 2100)
5업무구분코드283Y업무구분 (400)
6송신회수311Y'1' 고정
7전문번호326Y일별 Unique 전문번호 (MAX 950,000)
8전송일자388Y전문전송 일자 (YYYYMMDD)
9전송시간466Y전문전송시간 (hhmmss)
10응답코드524-응답코드 (에러코드), 요청 시 SPACE
11예비영역5644-헥토파이낸셜 고유영역

개별부 (1900 바이트)

요청 파라미터

No항목위치길이필수설명
1고객번호1009(10)Y사업자번호
2출금계좌번호110X(16)Y은행에 사전 등록된 계좌번호
3복기부호126X(6)Y은행과 협의 후 사용
4송금금액1329(15)Y소수점 이하 3자리 포함 (12,3)
5송금통화147X(3)YISO CODE (예: USD, JPY)
6송금구분150X(1)Y1:해외송금, 2:국내송금, 3:당행이체, 4:국내송금(금결원경유), P:포지션거래(SC은행)
7송금인명(영문)151X(35)Y보내는 분
8수취인명(영문)186X(35)Y받는 분
9수취인 계좌번호221X(35)Y수취인 계좌번호와 주소 중 반드시 하나는 있어야 함
10수취인 주소256X(3*35)Y수취인 계좌번호와 주소 중 반드시 하나는 있어야 함
11수취인앞 지시사항361X(4*35)N
12상대국 코드501X(2)Y
13적성국가앞 송금503X(1)N적성 국가 앞 송금 시 'Y'
14수취은행 코드504X(11)YBIC CODE / 당행 DORRES CODE
15수취은행명 및 주소515X(4*35)N수취은행코드 입력한 경우 생략 가능
16송금경유은행1655X(2*35)N특별히 지정하는 경우 사용
17송금경유은행2725X(2*35)N
18송금경유은행3795X(2*35)N
19수수료 인출계좌번호865X(16)Y
20해외은행 수수료부담인881X(1)Y1:송금인부담, 2:수취인부담, 3:양쪽부담(외환/하나/산업 전용)
21해외은행 수수료인출계좌지정882X(1)Y1:출금계좌, 2:수수료인출계좌
22지급사유코드8839(3)N지급사유코드 또는 지급사유(한글) 중 택1
23지급사유886X(35)N지급사유코드 또는 지급사유(한글) 중 택1
24가격조건921X(3)N사후금방식 송금으로 USD 1,000 초과하는 경우 반드시 입력
25H.S CODE9249(10)N
26수입신고서번호934X(22)N
27수입용도956X(1)N
28적요957X(14)N송금구분 3(당행이체)인 경우 SET
29입금계좌 예금주명971X(22)-응답 시 세팅
30출금계좌 잔액9939(15)-응답 시 세팅
31수취인 이메일주소11008X(50)N한 송금건당 최대 5명에게 송금사실 통지 가능
32수취인 이메일주소21058X(50)N
33수취인 이메일주소31108X(50)N
34수취인 이메일주소41158X(50)N
35수취인 이메일주소51208X(50)N

은행별 추가 항목

아래 항목은 특정 은행 또는 특정 송금구분에서만 사용됩니다.

No항목위치길이조건설명
36무역외사후관리번호1258X(16)조건부영업점에서 발급받아 세팅. 무역/무역외, 사업자별, 사유별, 통화코드 기준
37여유필드1274X(4)조건부
38은행코드1278X(3)송금구분 4금결원 경유 시 추가
39수취점 지로코드1281X(7)송금구분 4금결원 경유 시 추가
40거주구분1288X(2)송금구분 4첫번째:송금인거주구분, 두번째:수취인거주구분 (거주자:1, 비거주자:2). 우리은행: 6000/450 결과 값 세팅, 하나은행: 11 또는 22일 때만 이체 가능
41예금주조회전문번호12909(6)송금구분 4, 우리은행 필수
42거래외국환은행 지정코드1296X(2)우리은행
43거래외국환은행 지정주민번호 또는 여권번호1298X(13)우리은행
44재정통화코드13119(3)우리은행
45매체구분1314X(2)우리은행
46결제은행수수료1316X(18)우리은행
47지급사유코드13349(5)송금구분 1,2인 경우 필수
48예약일자13399(8)산업은행
49출금금액(원화금액)13479(15)SC은행
50적용환율13629(1)SC은행1:system rate, 2:contracted rate
51취급수수료 부담구분13639(1)SC은행1:송금인부담, 2:수취인부담
52예비1364X(636)-SPACE

송금구분별 주의사항

당행 외화계좌 이체 시 사용 항목 (송금구분: 3)

  1. 출금계좌번호: 출금 외화계좌번호
  2. 복기부호
  3. 송금금액
  4. 송금통화
  5. 송금구분: 3 (당행이체)
  6. 수수료인출계좌번호: 입금 외화계좌번호
  7. 적요: 입금사유 등 상대방에게 메모할 내용
  8. 입금계좌 예금주명
  9. 출금 외화계좌 잔액

은행별 특이사항

산업은행은 국내송금(송금구분 2)일 경우 지급사유코드를 반드시 10001로 세팅해야 합니다. SC제일은행은 금결원 경유 국내송금(송금구분 4)은 거래 불가합니다.

전문 구조

요청 전문 (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
고객번호10 · 100
출금계좌번호16 · 110
복기부호6 · 126
송금금액15 · 132
송금통화3 · 147
송금구분1 · 150
송금인명(영문)35 · 151
수취인명(영문)35 · 186
수취인 계좌번호35 · 221
수취인 주소105 · 256
수취인앞 지시사항140 · 361
상대국 코드2 · 501
적성국가앞 송금1 · 503
수취은행 코드11 · 504
수취은행명 및 주소140 · 515
송금경유은행170 · 655
송금경유은행270 · 725
송금경유은행370 · 795
수수료 인출계좌번호16 · 865
해외은행 수수료부담인1 · 881
해외은행 수수료인출계좌지정1 · 882
지급사유코드3 · 883
지급사유35 · 886
가격조건3 · 921
H.S CODE10 · 924
수입신고서번호22 · 934
수입용도1 · 956
적요14 · 957
입금계좌 예금주명22 · 971
출금계좌 잔액15 · 993
수취인 이메일주소150 · 1008
수취인 이메일주소250 · 1058
수취인 이메일주소350 · 1108
수취인 이메일주소450 · 1158
수취인 이메일주소550 · 1208
무역외사후관리번호16 · 1258
여유필드4 · 1274
은행코드3 · 1278
수취점 지로코드7 · 1281
거주구분2 · 1288
예금주조회전문번호6 · 1290
거래외국환은행 지정코드2 · 1296
거래외국환은행 지정주민번호 또는 여권번호13 · 1298
재정통화코드3 · 1311
매체구분2 · 1314
결제은행수수료18 · 1316
지급사유코드5 · 1334
예약일자8 · 1339
출금금액(원화금액)15 · 1347
적용환율1 · 1362
취급수수료 부담구분1 · 1363
예비636 · 1364
필수
선택
응답전용 / 예비
길이 · 위치

응답 코드

응답코드는 은행별로 상이하며, 코드 리스트는 해당 은행이나 헥토파이낸셜에 요청할 수 있습니다.

  • 공통부 응답코드 항목은 요청 전문에는 SPACE로 세팅하며, 응답 전문에는 해당 에러코드를 세팅합니다.
  • 응답코드 중 VTIM의 경우 응답시간초과 세션에러이므로 오류응답이 아닙니다. (3000/700이 안 올 경우, 3000/800으로 확인)

VTIM 응답

응답코드 VTIM은 응답시간 초과를 의미합니다. 이 경우 세션 에러이므로 오류응답이 아닙니다. 외화송금결과통지(3000/700)가 오지 않을 경우 3000/800(결번조회)으로 확인하세요.
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?

코드 샘플

HectoFinancial GitHub