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

도구

암호화 테스트

2차 이하 PG하위사업자 정보 등록

2차 이하 PG하위사업자 정보 등록은 PG사(전자지급결제대행업자)를 통해 결제 서비스를 이용하는 하위사업자(서브머천트)의 정보를 카드사에 등록·관리하는 절차입니다. 전자금융거래법 및 여신전문금융업법에 따라 PG사는 자사 하위에 속한 가맹점의 사업자 정보를 카드사에 의무적으로 등록해야 하며, 이를 통해 결제 흐름의 투명성과 가맹점 관리 체계를 확보할 수 있습니다.

온라인에서 PG사를 통해 결제가 이루어질 때, 실제 상품이나 서비스를 제공하는 주체는 PG사가 아닌 하위사업자입니다. 카드사는 이 하위사업자가 누구인지, 어떤 업종인지, 정상적인 사업자인지를 파악해야 하며, PG사는 하위사업자의 등록·변경·해지 정보를 적시에 전달해야 합니다.


주의 사항

NOTE

SFTP 파일 전송 방식

이 규격은 HTTP API가 아닌 SFTP 파일 송수신 방식입니다. 파일 포맷은 고정장(500bytes) 형식이며, SFTP 접속 정보는 상점ID 발급 후 별도 안내됩니다.

통신 Spec

항목내용
데이터 송/수신 방식SFTP 파일 송수신
접속계정추후 별도 안내
MAIN SFTP 서버61.252.169.33 (port: 5210)
DR SFTP 서버14.34.14.26 (port: 5210)
TEST/REAL 구분폴더로 구분
문자 코드EUC_KR

파일 구조

HEADER RECORD
DATA RECORD
...
DATA RECORD
TRAILER RECORD

필드 타입

타입설명정렬패딩값
N숫자 필드오른쪽'0'
A문자 필드(알파벳)왼쪽SPACE
S문자 필드(특수문자)왼쪽SPACE
H문자 필드(한글)왼쪽SPACE

파일 송/수신 주기

파일주기
하위사업자 정보등록 요청 파일08시 전까지 당일자 요청 파일 업로드 (365일 전송)
하위사업자 정보등록 결과 파일05시 이후 당일자 결과 파일 생성 (365일 생성)

하위사업자 정보 등록 요청 (가맹점 → 헥토파이낸셜)

File Spec

항목내용
파일명ST_BIZREG_REQ_요청일자 (요청일자: YYYYMMDD)
1 Record500bytes
파일 경로/bizreg_req
테스트 파일 경로/bizreg_req/test
데이터 없는 경우HEADER와 TRAILER 레코드만 작성 후 업로드

HEADER RECORD

항목위치길이타입설명
레코드 구분12A"HD" SET
파일 생성일38NYYYYMMDD
FILLER11490ASPACE

DATA RECORD

항목위치길이타입필수설명
레코드 구분12A*"RD" SET
등록 구분32AN*00:신규 / 01:해지 / 02:변경. 단, 롯데카드 02:변경 미사용
2차PG 사업자번호510AN*2차PG사 또는 오픈마켓 사업자번호. 중간표시자(-) 생략
카드사코드154AN*카드사 코드표 참조하여 1개 코드 기입. 다수의 카드사 등록을 요청하는 경우 동일 사업자 정보를 반복하여 작성 필요
사업자등록번호(하위몰)1810AN*최종하위사업자번호. 중간표시자(-) 생략
업종명(하위몰)2820HS한글 10자(20Byte). 특수기호 가능
회사명(하위몰)4840ANHS*한글 20자(40Byte). 특수기호 가능
우편번호(하위몰)885AN새 우편번호 다섯자리
주소(하위몰)93100ANHS우편번호 비포함
대표자명(하위몰)19340ANHS*
전화번호(하위몰)23311AN*하위몰의 대표 전화번호. 중간표시자(-) 생략
이메일(하위몰)24440ANS하위몰의 대표 이메일주소
웹사이트 URL(하위몰)28480ANS*하위몰 URL이 없는 경우 2차PG사 URL
정보등록일3648N*YYYYMMDD
FILLER372128ASPACE
NOTE

필수 값 안내

필수 값은 * 표기된 항목입니다.

TRAILER RECORD

항목위치길이타입설명
레코드 구분12A"TR" SET
총 건수 합계310NDATA부 총건수
신규 건수 합계1310NDATA부 신규 등록 건수
변경 건수 합계2310NDATA부 변경 등록 건수
해지 건수 합계3310NDATA부 해지 등록 건수
FILLER43458ASPACE

하위사업자 정보 등록 결과 (헥토파이낸셜 → 가맹점)

File Spec

항목내용
파일명ST_BIZREG_RSP_파일작성일자 (파일작성일자: YYYYMMDD)
1 Record500bytes
파일 경로/bizreg_rsp
테스트 파일 경로/bizreg_rsp/test
데이터 없는 경우HEADER와 TRAILER 레코드만 작성 후 업로드

HEADER RECORD

항목위치길이타입설명
레코드 구분12A"HD" SET
파일 생성일38ANYYYYMMDD
FILLER11490ASPACE

DATA RECORD

항목위치길이타입설명
레코드 구분12A"RD" SET
등록 구분32AN00:신규 / 01:해지 / 02:변경
2차PG 사업자번호510AN2차PG사 또는 오픈마켓 사업자번호. 중간표시자(-) 생략
카드사코드154AN카드사코드표 참조
사업자등록번호(하위몰)1810AN최종하위사업자번호. 중간표시자(-) 생략
업종명(하위몰)2820ANHS한글 10자(20Byte). 특수기호 가능
회사명(하위몰)4840ANHS한글 20자(40Byte). 특수기호 가능
우편번호(하위몰)885AN새 우편번호 다섯자리
주소(하위몰)93100ANHS우편번호 비포함
대표자명(하위몰)19340ANHS
전화번호(하위몰)23311AN하위몰의 대표 전화번호. 중간표시자(-) 생략
이메일(하위몰)24440ANS하위몰의 대표 이메일주소
웹사이트 URL(하위몰)28480ANS
정보등록일3648ANYYYYMMDD
카드사 결과코드3724AN
PG사 결과코드3764AN
FILLER380120ASPACE

TRAILER RECORD

항목위치길이타입설명
레코드 구분12A"TR" SET
총 건수 합계310NDATA부 총 건수
신규 건수 합계1310NDATA부 신규 등록 건수
변경 건수 합계2310NDATA부 변경 등록 건수
해지 건수 합계3310NDATA부 해지 등록 건수
FILLER43458ASPACE

코드표

PG사 결과코드

오류코드오류메시지
0000정상
9999기타오류 (PG사 문의)

카드사 코드

코드카드사명비고
1001비씨카드
1002국민카드
1003하나(외환)카드
1004삼성카드삼성카드 하위사업자 정보 등록은 별도의 프로세스로 진행되므로 요청 대상 제외 가능하며, 요청 전송 시 결과 파일 내 미포함
1005신한카드
1007우리카드미등록 시 차액 정산 거절되지는 않지만, 영중소 우대 구간 선정 시 누락 될 수 있음
1008현대카드
1009롯데카드
1015NH카드

카드사 결과코드

국민카드

반송코드반송사유
00정상처리
01등록구분 오류
02회사명 오류
03사업자등록번호(PG)오류
04가맹점번호 오류
05사업자번호(하위몰)오류
06필수값 누락(회사명)
07필수값 누락(URL)
08필수값 누락(전화번호)
11사업자등록번호(PG)1차 하위몰 미등재
12기등재(1차하위몰)
99기타

NH카드

반송코드반송사유
00정상처리
01레코드구분오류
02등록구분 오류
03VAN 기관코드 오류
04사업자등록번호(PG)오류
05가맹점번호 오류
06사업자번호(하위몰) 오류
07회사명 오류 (필수 및 정합성)
08URL 오류(필수 및 정합성)
09전화번호 오류(필수 및 정합성)
10정보등록일 오류
11등록구분 01,02 인 경우 하위몰 미등재
12등록구분 00 인 경우 하위몰 기등재
13총건수 오류
99기타

신한카드

반송코드반송사유
00정상처리
01등록구분 오류
02사업자등록번호(PG) 오류
03사업자번호(하위몰) 오류
04회사명 오류
05전화번호 오류
06대표자명(하위몰) 오류
07등록구분 01, 02 인 경우 하위몰 미등재
99기타

우리카드 / 현대카드

반송코드반송사유
00정상처리
01등록구분오류
02VAN 기관코드 오류
03사업자등록번호(PG)오류
04사업자번호(하위몰)오류
05회사명(하위몰)누락
06웹사이트 URL(하위몰)누락
07전화번호(하위몰)누락
08정보등록일 오류
09등록구분 01,02 인경우 하위몰 미등재
10등록구분 00 인경우 하위몰 기등재
99기타

하나카드

반송코드반송사유
00정상처리
01등록구분 오류
02회사명 오류
03사업자등록번호(PG)오류
04가맹점번호 오류
05사업자번호(하위몰)오류
06필수값 누락(회사명)
07필수값 누락(URL)
08필수값 누락(전화번호)
11사업자등록번호(PG)1차 하위몰 미등재
12기등재(1차하위몰)
99기타

롯데카드

반송코드반송사유
00정상처리
01등록구분 오류
02회사명 오류
03사업자등록번호(PG) 오류
04가맹점번호 오류
05사업자번호(하위몰) 오류
06필수값 누락(회사명)
07필수값 누락(URL)
08필수값 누락(전화번호)
11등록코드 01 인 경우 하위몰 미등재
99기타

BC카드

반송코드반송사유
01등록구분 오류
02사업자등록번호(PG) 오류
03PG사 코드 오류
04BC 미존재 PG 사업자
05사업자번호(하위몰) 오류
06하위몰 전화번호 오류
07유효한 기 등록정보 미존재
99기타
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?

코드 샘플

HectoFinancial GitHub
API 테스트