헥토파이낸셜 개발자센터
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)
은행 코드응답 코드매체 코드은행 운영 및 점검시간
안심선불
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
회원가입 화면 연동내정보 화면 연동
선불금 사용사용 취소머니 선물포인트 회수
잔액 조회잔액 옵션 조회잔액 상세 조회충전건별 잔액조회출금 가능 머니 조회거래 내역 조회거래 상세 조회상점 거래 상세 조회회원 정보 조회소멸 예정 포인트 조회충전 수단 조회
충전충전 취소머니 출금대기머니 출금
오류 코드거래구분코드

도구

암호화 테스트

전체 연동 플로우

실시간 펌뱅킹은 TCP/IP 소켓 연결 → 전문 송수신 → 즉시 처리 방식으로 동작합니다.


전체 흐름

가맹점
헥토파이낸셜
은행
11. TCP/IP 소켓 연결
1. TCP/IP 소켓 연결
22. 거래 전문 송신 (지급/수납/조회)
2. 거래 전문 송신 (지급/수납/조회)
33. 은행으로 전문 전송
3. 은행으로 전문 전송
44. 은행 응답 수신
4. 은행 응답 수신
55. 거래 결과 응답
5. 거래 결과 응답
66. 노티 전문 송신 (필요시)
6. 노티 전문 송신 (필요시)
77. 노티 전문 전달
7. 노티 전문 전달

실시간 처리

실시간 펌뱅킹은 거래 요청 즉시 은행과 통신하여 결과를 응답합니다. 은행 점검시간 및 업무시간을 확인하세요.

통신 방식 선택

실시간 펌뱅킹은 두 가지 통신 방식을 지원합니다.

동기 통신 (거래별 연결)

거래 건별로 소켓 연결/종료를 수행합니다.

순서단계방향
1소켓 연결가맹점 → 헥토파이낸셜
2거래 전문 송신가맹점 → 헥토파이낸셜
3거래 응답 수신헥토파이낸셜 → 가맹점
4소켓 종료가맹점 → 헥토파이낸셜
구분내용
장점• 구현이 간단함
• 세션 관리 불필요
단점• 매 거래마다 연결/종료 오버헤드
적합한 경우• 거래 빈도가 낮은 경우
• 단순한 구조를 선호하는 경우

비동기 통신 (세션 유지)

세션을 유지하면서 여러 거래를 처리합니다.

순서단계전문코드방향비고
1소켓 연결-가맹점 → 헥토파이낸셜1회
2거래 전문 송신지급, 수납, 조회 등가맹점 → 헥토파이낸셜반복
3거래 응답 수신-헥토파이낸셜 → 가맹점반복
4Polling 전문 송신-가맹점 → 헥토파이낸셜5분마다
5Polling 응답 수신-헥토파이낸셜 → 가맹점5분마다
구분내용
장점• 연결 오버헤드 감소
• 대량 거래 처리 효율적
단점• Polling 관리 필요
• 세션 관리 복잡도 증가
적합한 경우• 거래 빈도가 높은 경우
• 대량 거래 처리가 필요한 경우
NOTE

Polling 주기

세션 유지 방식 사용 시 5분(300초) 간격으로 Polling 전문을 송신하여 세션을 유지해야 합니다. 헥토파이낸셜 폴링은 5분동안 거래가 없을 시에 발생합니다.

1단계: 소켓 연결

가맹점 서버에서 헥토파이낸셜 펌뱅킹 서버로 TCP/IP 소켓 연결을 수행합니다.

연결 정보

항목내용
프로토콜TCP/IP
서버 IP헥토파이낸셜 제공 (계약 후)
Port헥토파이낸셜 제공 (계약 후)

업무개시 전문

매일 업무 시작 전 업무개시 전문(1000/100)을 송신합니다.

관리 전문 문서

🔧

관리전문

업무개시/종료, TEST CALL


2단계: 거래 전문 송수신

연결이 완료되면 각종 거래 전문을 송수신합니다.

원화 펌뱅킹 주요 거래 유형

전문코드업무구분거래 종류
2000100지급이체 (당타행 송금)
2000200집금이체 (출금이체)
2000550자동이체 계좌등록
6000100예금주조회
7000100처리결과조회
7000200잔액조회
7000300자금이체집계
7000400출금이체집계
3000100타행이체불능통지
3000200타행이체불능통지결번
4000100예금거래명세통지
4000200예금거래명세통지결번

외화 펌뱅킹 주요 거래 유형

전문코드업무구분거래 종류
2000400외화송금의뢰
2000401외화송금의뢰(MX)
2000420외화 자동이체
2000520외화 자동이체 약정 등록
2000600외화송금의뢰 취소
3000700외화송금결과 통지
3000701외화송금결과통지(MX)
3000800외화송금결과 통지결번
3000801외화송금결과통지 결번(MX)
6000450국내 외화 예금주명 조회
6000521환율정보거래
7000800외화송금집계
7000900외화예금 잔액조회
7000950국내 외화송금/자동이체 처리결과조회
8000601외화거래 명세통지
8000701외화거래 명세통지 결번

전문 구조

펌뱅킹 전문 구조 (원화)304 bytes
Length 헤더4B · offset 0
전문 길이4 · 0
공통부100B · offset 4
식별코드9 · 4
업체번호12 · 13
은행코드3 · 25
전문구분코드4 · 28
업무구분코드3 · 32
전문번호6 · 35
전송일자8 · 41
전송시간6 · 49
응답코드4 · 55
예비영역44 · 59
개별부200B · offset 104
거래별 상세 정보200 · 104
필수
선택
응답전용 / 예비
길이 · 위치
펌뱅킹 전문 구조 (외화)2004 bytes
Length 헤더4B · offset 0
전문 길이4 · 0
공통부100B · offset 4
식별코드9 · 4
업체번호12 · 13
은행코드3 · 25
전문구분코드4 · 28
업무구분코드3 · 32
전문번호6 · 35
전송일자8 · 41
전송시간6 · 49
응답코드4 · 55
예비영역44 · 59
개별부1900B · offset 104
거래별 상세 정보1900 · 104
필수
선택
응답전용 / 예비
길이 · 위치

거래별 상세 문서

💸

지급 (송금)

실시간 계좌이체 송금

💰

수납

수납 거래 처리

🔍

예금주 조회

계좌 소유주 조회

📊

잔액 조회

계좌 잔액 조회


3단계: 응답 수신 및 처리

거래 전문 송신 후 즉시 응답을 수신합니다.

응답 코드 확인

공통부의 응답코드(52번째 위치, 4자리)를 확인합니다.

응답코드의미처리
0000정상거래 성공
기타오류은행별 오류 메시지 확인 (은행오류코드집 참조)

응답 코드 예시

코드설명
0000정상처리
9999시스템 장애
1001계좌번호 오류
1002금액 부족
1003예금주 불일치

응답 코드 필수 확인

거래 성공 여부는 반드시 응답코드를 확인하여 판단해야 합니다. 소켓 응답 수신 자체는 거래 성공을 의미하지 않습니다.

4단계: 노티 수신 (필요시)

일부 거래는 은행에서 가맹점으로 노티(통지) 전문을 송신합니다.

노티 수신 대상 전문

노티 종류전문코드설명
거래명세통지4000/100지급/수납 거래 명세
지급불능통지3000/100지급 실패 통지

노티 수신 프로세스

순서단계방향설명
1노티 전문 송신은행 → 가맹점거래 결과 통지
2노티 응답 송신가맹점 → 은행수신 확인
NOTE

노티 수신 서버 필요

노티를 수신하려면 가맹점 서버에서 TCP/IP 수신 서버를 운영해야 합니다. 노티 수신 서버의 IP와 Port를 헥토파이낸셜에 전달하세요.

노티 전문 문서

📋

거래명세통지

지급/수납 거래 명세 수신

❌

지급불능통지

지급 실패 통지 수신


오류 처리

통신 오류

오류 상황처리 방법
응답 타임아웃거래결과 조회로 확인
전문 오류응답코드 확인 후 재처리

거래결과 조회 활용

통신 오류로 응답을 받지 못한 경우, 반드시 거래결과 조회(7000/100)로 거래 성공 여부를 확인해야 합니다. 중복 거래 방지를 위해 필수입니다.

집계 조회

일별 거래 집계를 조회할 수 있습니다.

집계 조회 문서

📊

지급 집계

일별 지급 거래 집계 조회

💰

수납 집계

일별 수납 거래 집계 조회


주요 기능별 문서

기능 선택

💸

지급/수납

실시간 송금 및 수납 처리

🔍

조회

예금주 조회, 잔액 조회, 거래결과 조회

🔔

노티

거래명세통지, 지급불능통지 수신

🔧

관리

업무개시/종료, TEST CALL

❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?

코드 샘플

HectoFinancial GitHub