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

도구

암호화 테스트

거래대사 API

특정 거래일자의 거래내역을 조회하는 API입니다. 가맹점 서버에서 헥토파이낸셜 서버로 거래대사 조회를 위한 API를 호출하면, 헥토파이낸셜측 거래대사 결과가 응답됩니다.

테스트용 키 정보

암호화 키: pgSettle30y739r82jtd709yOfZ2yK5K
해시 생성 키: ST1009281328226982205
* 운영 환경에서는 헥토파이낸셜에서 별도 제공하는 키를 사용해야 합니다.

API 정보

POST/api/pg/{상점아이디}/transInfo.do
Content-Typeapplication/x-www-form-urlencoded
테스트https://tb-nspay.settlebank.co.kr/api/pg/{상점아이디}/transInfo.do
운영https://nspay.settlebank.co.kr/api/pg/{상점아이디}/transInfo.do

주의 사항

NOTE

거래대사 API 안내

거래대사 API는 특정 거래일자에 발생한 모든 거래내역을 조회합니다. 대량의 데이터가 조회될 수 있으므로 주의해주세요.
  • 응답 형식은 파이프(|) 구분자로 구분된 텍스트 형식입니다.
  • 첫 번째 행은 결과코드, 결과메시지, 조회건수를 포함합니다.
  • 조회 성공 시 두 번째 행부터 거래건별 정보가 출력됩니다.

요청 파라미터

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└mchtIdAN(10)영문+숫자, 최대 10byte*헥토파이낸셜에서 부여하는 고유 상점아이디
헥토파이낸셜에서 부여하는 고유 상점아이디
파라미터
타입
설명
예시
mchtId필수
AN(10)
헥토파이낸셜에서 부여하는 고유 상점아이디
nxca_jt_il
└mchtTyAN(1)영문+숫자, 최대 1byte*상점아이디 구분
상점아이디 구분
M: 상점ID별조회 G: 그룹ID별조회
파라미터
타입
설명
예시
mchtTy필수
AN(1)
상점아이디 구분
M: 상점ID별조회 / G: 그룹ID별조회
M
└repMchtIdAN(10)영문+숫자, 최대 10byte대표 상점아이디, mchtTy(상점아이디 구분) 값이 G(그룹아이디)일때 세팅하여 pktHash 생성할 때 repMchtId의 hashKey 사용
대표 상점아이디, mchtTy(상점아이디 구분) 값이 G(그룹아이디)일때 세팅하여 pktHash 생성할 때 repMchtId의 hashKey 사용
파라미터
타입
설명
예시
repMchtId
AN(10)
대표 상점아이디, mchtTy(상점아이디 구분) 값이 G(그룹아이디)일때 세팅하여 pktHash 생성할 때 repMchtId의 hashKey 사용
nxca_jt_il
└methodAN(2)영문+숫자, 최대 2byte*결제수단
결제수단
ALL: 전 결제수단 조회 CA: 신용카드 VA: 가상계좌 RA: 계좌이체 MP: 휴대폰 TM: 티머니 CG: 문화상품권 SG: 스마트문상 BG: 도서문화상품권 HM: 해피머니 TC: 틴캐시 CP: 포인트 다모아 PZ: 간편결제
파라미터
타입
설명
예시
method필수
AN(2)
결제수단
ALL: 전 결제수단 조회 / CA: 신용카드 / VA: 가상계좌 / RA: 계좌이체 / MP: 휴대폰 / TM: 티머니 / CG: 문화상품권 / SG: 스마트문상 / BG: 도서문화상품권 / HM: 해피머니 / TC: 틴캐시 / CP: 포인트 다모아 / PZ: 간편결제
ALL
└pdTyAN(1)영문+숫자, 최대 1byte*조회기간 구분 코드
조회기간 구분 코드
*고정값
파라미터
타입
설명
예시
pdTy필수
AN(1)
조회기간 구분 코드
* 고정값
D
└trdDtStN(8)숫자, 최대 8byte*거래일자 (yyyyMMdd)
거래일자 (yyyyMMdd)
파라미터
타입
설명
예시
trdDtSt필수
N(8)
거래일자 (yyyyMMdd)
20211231
└ezpIncYNAN(1)영문+숫자, 최대 1byte거래대사 조회 결과에 간편결제(PZ) 거래를 포함할지 여부
거래대사 조회 결과에 간편결제(PZ) 거래를 포함할지 여부
Y: 포함 N 또는 세팅안함: 미포함
파라미터
타입
설명
예시
ezpIncYN
AN(1)
거래대사 조회 결과에 간편결제(PZ) 거래를 포함할지 여부
Y: 포함 / N 또는 세팅안함: 미포함
Y
└pktHashAN(200)영문+숫자, 최대 200byte*SHA-256SHA256 방식으로 생성한 해쉬값(실시간 생성)
SHA256 방식으로 생성한 해쉬값
파라미터
타입
설명
예시
pktHash필수
AN(200)
SHA-256
SHA256 방식으로 생성한 해쉬값
-
NOTE

해쉬 생성 조합

mchtId + trdDtSt + hashKey

응답 형식

응답은 파이프(|) 구분자로 구분된 텍스트 형식입니다.

조회 결과 (첫 번째 행)

순번항목타입설명
1결과코드AN(4)API 응답 결과 코드
2결과메시지ANAPI 응답 결과 메시지
3조회내역 건수N조회 성공 거래 내역 건수

거래내역 (두 번째 행부터)

조회 성공(result:0000) 시 두 번째 행부터 거래건 별로 출력됩니다.

순번항목타입설명
1상점아이디AN(10)상점아이디
2결제수단N(2)결제수단 코드
3헥토파이낸셜 거래번호AN(40)헥토파이낸셜에서 생성한 거래번호
4주문번호AN(100)상점주문번호
5승인구분AN(1)0: 승인, 1: 취소
6거래일자N(8)거래일자(취소일자) yyyyMMdd
7거래시간N(6)거래시간(취소시간) hhmmss
8거래금액N(13)거래금액
9원거래번호AN(40)취소거래에 대한 원 거래번호
10원거래일자N(8)취소거래에 대한 원 거래일자
11주문자명AN(88)상점 주문자명
12상품명AN(200)상점 상품명
13승인번호AN신용카드 승인번호
14금융사코드AN신용카드: 카드사 코드, 계좌이체/가상계좌: 금융기관 코드, 휴대폰: 통신사 코드, 간편결제: 카드사 코드/간편결제사 코드
15할부개월N(2)신용카드 거래 할부 개월
16무이자할부여부AN(1)가맹점부담 무이자 할부 거래 여부 (신용카드). N: 일반, Y: 무이자할부거래
17간편결제사 코드AN(3)결제수단이 간편결제(PZ)인데 금융사 코드가 카드사인 경우에 간편결제사를 판별하기 위한 값
18상품 코드AN(3)복합결제 시 주결제수단과 보조결제수단을 판별하기 위한 값
19복합결제거래번호AN(40)복합결제에 대한 원 거래번호

응답 예시

정상 처리 응답

0000|정상 처리 되었습니다.|6|
nxca_jt_il|CA|STFP_PGCAnxca_jt_il0260720100000M1000001|ORDER20260720100001|0|20260720|100000|10000|||홍길동|테스트상품|99100001|02|00|N|
nxca_jt_il|CA|STFP_PGCAnxca_jt_il0260720103000M1000002|ORDER20260720100002|0|20260720|103000|30000|||김철수|테스트상품2|99100002|05|03|Y|
nxca_jt_il|CA|STFP_PGCAnxca_jt_il0260720110000M1000003|ORDER20260720100001|1|20260720|110000|10000|STFP_PGCAnxca_jt_il0260720100000M1000001|20260720|홍길동|테스트상품|99100001|02|00|N|
nxca_jt_il|PZ|STFP_PGPZnxca_jt_il0260720120000M1000004|ORDER20260720100004|0|20260720|120000|5000||||테스트상품3|||00|N|
nxca_jt_il|PZ|STFP_PGPZnxca_jt_il0260720130000M1000005|ORDER20260720100004|1|20260720|130000|5000|STFP_PGPZnxca_jt_il0260720120000M1000004|20260720||테스트상품3|||00|N|
nxca_jt_il|CA|STFP_PGCAnxca_jt_il0260720140000M1000006|ORDER20260720100006|0|20260720|140000|20000|||이영희|테스트상품|99100006|11|00|N|

실패 응답

ST92|해쉬 값 불일치.|0|

결과 코드

코드설명
0000정상 처리 되었습니다.
1001조회내역 없음
ST09유효하지 않은 요청전문
ST10내부 시스템 에러
ST90등록되지 않은 상점 아이디
ST91필수 파라미터 오류
ST92해쉬 값 불일치

카드사 코드 (매입사 코드)

코드카드사명
01BC
02국민
03하나
04삼성
05신한
08현대
09롯데
11우리
15NH

금융기관 코드

코드금융기관명
002산업은행
003기업은행
004국민은행
007수협은행/수협중앙회
011농협은행
012농협중앙회
020우리은행
023SC제일은행
027한국씨티은행
031대구은행
032부산은행
034광주은행
035제주은행
037전북은행
039경남은행
045새마을금고중앙회
048신협중앙회
050상호저축은행
054HSBC은행
055도이치은행
057제이피모간체이스은행
060BOA은행
062중국공상은행
064산림조합중앙회
071우체국
081KEB하나은행
088신한은행
089K뱅크
090카카오뱅크
092토스뱅크
103교보SBI저축은행
209유안타증권
218KB증권
238미래에셋대우
240삼성증권
243한국투자증권
247NH투자증권
261교보증권
262하이투자증권
263현대차투자증권
264키움증권
265이베스트투자증권
266SK증권
267대신증권
269한화투자증권
270하나금융투자
278신한금융투자
279동부증권
280유진투자증권
287메리츠종합금융증권
290부국증권
291신영증권
292케이프투자증권

결제수단 코드

코드결제수단
CA신용카드
VA가상계좌
RA계좌이체
MP휴대폰
TM티머니
CG문화상품권
SG스마트문상
BG도서문화상품권
HM해피머니
TC틴캐시
CP포인트 다모아
PZ간편결제

통신사 코드

코드통신사명
SKTSK Telecom
KTFKT
LGTLG U+
SKLSK 7 Mobile
CJHCJ 헬로모바일
KCT한국케이블텔레콤

간편결제사 코드

코드간편결제사명
KKP카카오페이
NVP네이버페이
PAC페이코
TOS토스페이

상품 코드

코드상품명
CAP신용카드
KKM카카오머니
PNT포인트
COU페이코쿠폰
TSM토스머니
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?

코드 샘플

HectoFinancial GitHub