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

도구

암호화 테스트

영중소 사업자 환급 정산

환급정산은 2022년 9월부터 시행된 제도로, 신규 사업자가 영업 개시 후 영세·중소 가맹점으로 선정되기 전까지 우대수수료를 적용받지 못한 매출에 대해 그 차액을 사후에 정산받는 절차입니다.

상시 발생하는 차액정산과 달리 반기 단위(연 2회)로 진행되는 것이 특징입니다. 신규 가맹점은 매출 근거가 확정되기 전까지 우선 '일반(4)' 수수료율을 적용받게 되며, 이후 여신금융협회에서 반기별 환급 대상 사업자를 선정하면 당사는 기 전송된 매출 내역을 기반으로 각 카드사에 수수료 환급을 요청합니다.

최종적으로 카드사에서 확정한 환급 결과에 따라 당사는 가맹점에 해당 차액을 정산하여 지급합니다. 예를 들어, 2월에 개업한 사업자가 8월에 '영세' 등급으로 확정될 경우, 카드사가 승인한 2월부터 8월까지의 수수료 차액만큼을 소급하여 환급받게 됩니다.


주의 사항

NOTE

SFTP 파일 전송 방식

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

통신 Spec

항목내용
데이터 송/수신 방식SFTP 파일 송수신
접속계정상점ID 발급 이후 방화벽 허용 요청 시 SFTP 계정 생성 후 별도 안내
MAIN SFTP 서버61.252.169.33 (port: 5210)
DR SFTP 서버14.34.14.26 (port: 5210)
TEST/REAL 구분접속계정 or 폴더로 구분
문자 코드UTF-8

파일 구조

HEADER RECORD
  DATA RECORD
  ...
  DATA RECORD
TRAILER RECORD

필드 타입

타입설명정렬패딩값
N숫자 필드오른쪽'0'
A문자 필드왼쪽SPACE

환급 정산 정책

환급 정산

  • 2022년 9월 첫 시행
  • 신규 사업자의 경우 일반(4) 사업자로 선정이 되어 반기 동안 영세·중소 우대수수료 적용 받지 못한 매출에 대해 수수료 환급 정산 진행
    • 환급 대상 사업자 리스트는 여신금융협회에서 수신
  • 예시: 2월 개업 후 8월에 영세 우대 수수료 적용 시 2월~8월까지 차액 수수료(일반-영세) 환급

환급 정산 방식

  • 가맹점(2차PG)에서 당사로 별도의 환급 정산 요청 파일 전송 없음
  • 기 전송된 일반 규모 차액 정산 매출 데이터로 카드사에 환급 정산 요청
  • 차액 정산 반송 건에 대해서는 환급 정산 처리 불가하므로 차액 정산 반송 관리 필수

진행 순서

  1. 차액 정산 진행
  2. 반기 단위로 직전 반기에 전송된 차액 정산 일반 매출 구간 사업자 중 환급 대상 사업자의 매출 내역을 환급 정산 요청 (헥토파이낸셜 → 카드사)
  3. 환급 정산 지급 및 가맹점 환급 정산 결과 파일 업로드

환급 정산 결과 파일 송신 주기

파일주기
환급 정산 결과 파일매년 4월, 10월 03일 09시 업로드

환급 정산 결과 파일 (PG사 → 가맹점(2차PG))

File Spec

항목내용
파일명REF_RST_접속계정ID_파일작성일자 (파일작성일자: YYYYMMDD)
1 Record500bytes
운영 파일 경로/ref_rsp
테스트 파일 경로/ref_rsp/test

HEADER RECORD

항목위치길이타입설명
레코드 구분12AN"01"
파일작성일자38NYYYYMMDD
사업자번호1110AN2차PG 사업자번호
PG사 구분2110AN"HECTO"
FILLER31470AN공백

DATA RECORD

항목위치길이타입설명
레코드 구분12AN"11"
승인/취소 구분31AN0:승인 / 1:취소
상점 ID410AN헥토파이낸셜에서 발급된 상점ID
거래일자(승인/취소)148N거래일자 (YYYYMMDD). 승인 또는 취소 일자
중간하위사업자번호2210AN2차PG 사업자번호(10자리)
최종하위사업자번호3210AN하위가맹점 사업자번호(10자리)
PG거래번호4240ANPG거래번호 (승인 또는 취소 PG거래번호)
부분취소차수822N승인: 0, 1회차 부분or전체취소: 1, N회차 취소: N
가맹점 주문번호84100AN상점에서 생성한 고유 주문번호
하위사업자 매출액18415N취소인 경우 [-] 부호 생략
거래 금액 합계19915N취소인 경우 [-] 부호 생략
원 PG거래번호21440AN원 승인 PG거래번호
원 거래일자(승인)2548AN원 승인 거래일자(YYYYMMDD)
하위사업자 구분2621AN0:영세 / 1:중소1 / 2:중소2 / 3:중소3 / 4:일반. 카드사 응답 하위사업자 구분 값을 표기하며, 빈(null)값 수신 시 4(일반)으로 응답
환급 공급가액26315N취소인 경우 [-] 부호 생략
환급 부가세27815N취소인 경우 [-] 부호 생략
환급 정산금액29315N취소인 경우 [-] 부호 생략
환급 정산일자3088NYYYYMMDD
카드사 결과코드3162AN카드사 수신 결과코드 (카드사 코드표 참조)
FILLER318183AN공백

TRAILER RECORD

항목위치길이타입설명
레코드 구분12AN"12"
총 건수 합계37NDATA부 건수(승인+취소건수)
총 매출액 합계1018ANDATA부 하위사업자 매출액(승인-취소금액). [-] 부호 표시 가능
공급가액 합계2815AN[-] 부호 표시 가능
부가세 합계4315AN[-] 부호 표시 가능
정산금액 합계5815AN[-] 부호 표시 가능
FILLER73428AN공백

코드표

카드사 결과 코드

오류코드오류메시지
00정상
01카드사별 구분값 오류(미존재 또는 불일치)
02매출금액 오류(원매출금액과 하위사업자 매출액 SUM의 불일치)
03중복접수(기 처리된 내역을 전송)
04원매입 반송(원매출 미존재 또는 매출금액 오류 등)
05매입취소구분 오류(원매출과 하위매출의 정상/취소 불일치)
06매입전송일자 오류
07승인일자 오류
08승인번호 오류(원승인번호에 해당하는 매출 미존재)
09가맹점번호 오류1(가맹점번호가 SPACE이거나 미등록가맹점)
10가맹점번호 오류2(차액정산 가맹점 번호가 아님)
11카드번호 오류
12중간하위사업자 오류(전자금융업자 미해당사업자 등)
13차액정산 지연접수
14카드사별 구분값 정상건 반송. A,B,C로 구성된 장바구니 거래에서 C의 카드사별 구분값이 오류인 경우 C는 01번 코드로 회신하나, A,B는 카드사별 구분값이 정상임에도 C로 인해 반송되는 것이므로 14번 코드로 구별하여 회신
15매출이 전체 취소된 이후, +차액정산 접수시 반송. 반송조건 추가 사유: -차액정산(취소) 접수가 지연 되는 케이스 막고자 함
16거래 구분 오류
17환급정산 대상 일자 아님
182차서브몰 신규사업자 환급정산 대상 아님
19원매출이 정상처리 되지 않음
99기타
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?

코드 샘플

HectoFinancial GitHub
API 테스트