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

도구

암호화 테스트

가상계좌 노티 전문

가상계좌는 다른 결제수단과 달리 채번, 입금, 취소, 환불 등 거래 단계마다 노티가 발송됩니다. 노티 유형별로 처리 로직을 구현해야 합니다.


노티 유형 총정리

가상계좌 노티는 outStatCd(거래상태)와 bizType(업무구분) 조합으로 구분합니다.

노티 유형outStatCdbizType거래 상태발생 시점
채번 완료0051A0입금 대기가상계좌 발급 시 (고정식 무제한 제외)
입금 완료0021B1결제 완료고객이 입금 완료 시
채번 취소0021A2발급 취소가맹점에서 채번 취소 API 호출 시
자동취소0121B2입금 후 취소입금 후 은행 사유로 거래가 취소된 경우 (설정 활성화 시)
환불 완료0021C0환불 완료환불 API 호출 후 등록 완료 시
NOTE

010 가상계좌 노티는 별도 문서 참고

010 가상계좌(bizType=A4)의 채번/입금 노티 전문은 010 가상계좌 전용 노티 문서를 참고하세요.

노티 수신 URL

노티는 헥토파이낸셜 서버가 가맹점 서버로 직접 보내는 Server-to-Server 요청이며, 아래 3가지 URL 중 하나로 전송됩니다. 자세한 개념은 결과통보 URL 가이드를 참고하세요.

표기의미
요청 notiUrl채번 요청 시 전달한 notiUrl 파라미터
기준정보 URL영업 담당자를 통해 상점 기준정보에 등록한 노티 URL
기준정보 수취조회 URL상점 기준정보에 등록한 수취조회 전용 URL (기준정보 URL과 별도)

계좌 유형·노티 유형별 수신 URL입니다. A → B는 A가 없으면 B로 전송된다는 뜻입니다.

노티 유형회전식 / 고정식고정식 무제한
채번 완료요청 notiUrl → 기준정보 URL발송 안 함
입금 완료요청 notiUrl → 기준정보 URL기준정보 URL
채번 취소기준정보 URL → 요청 notiUrl기준정보 URL
수취조회 / P수취조회기준정보 수취조회 URL기준정보 수취조회 URL

핵심 요약

채번 취소는 다른 노티와 반대로 기준정보 URL이 우선입니다. 고정식 무제한은 요청 notiUrl이 없으므로 기준정보 URL을 반드시 등록해야 노티를 받을 수 있습니다.

계좌 유형별 차이

acntType으로 계좌 유형을 구분합니다. 고정식 무제한(3)은 전송 파라미터가 다릅니다.

구분회전식(1) / 고정식(2)고정식 무제한(3)
채번 완료 노티발송발송 안 함
mchtTrdNo채번 시 주문번호항상 0000000 — vAcntNo로 주문 구분
trdNo채번 시 발급된 거래번호입금 건별 거래번호 — 환불 시 orgTrdNo로 사용

처리 시 유의사항

입금 기한(expireDt)이 지나도 노티가 오지 않습니다. 만료 처리는 가맹점에서 직접 해야 합니다. 입금자명(dpstrNm)은 주문 시 입력한 이름과 다를 수 있어 참고용으로만 사용하세요. 환불 완료 노티 수신 시점에 환불 완료로 처리하세요. 고객 계좌 입금은 익 영업일이며 이후 노티는 없습니다.

통신 규격

구분내용
전송 방식POST
Content-Typeapplication/x-www-form-urlencoded; charset=UTF-8
응답 형식Plain Text (OK 또는 FAIL)

노티 파라미터 — 회전식 / 고정식

회전식(acntType=1) 및 고정식(acntType=2) 가상계좌에서 전송되는 노티 파라미터입니다. 채번 완료(0051), 입금 완료(0021), 자동취소(0121, 설정 활성화 시) 등 모든 노티 유형에서 사용됩니다.

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└outStatCdN(4)숫자, 최대 4byte*거래상태0021
거래상태
0021: 성공 (입금 완료/채번 취소/환불 — bizType으로 구분) 0051: 입금 대기 중 (채번 완료) 0121: 자동취소 (설정 활성화 시)
파라미터
타입
설명
예시
outStatCd필수
N(4)
거래상태
0021: 성공 (입금 완료/채번 취소/환불 — bizType으로 구분) / 0051: 입금 대기 중 (채번 완료) / 0121: 자동취소 (설정 활성화 시)
0021
└trdNoAN(40)영문+숫자, 최대 40byte*헥토파이낸셜에서 부여하는 고유 거래번호STFP_PGVAnxva_jt_il0211129135810M1494620
헥토파이낸셜에서 부여하는 고유 거래번호
파라미터
타입
설명
예시
trdNo필수
AN(40)
헥토파이낸셜에서 부여하는 고유 거래번호
STFP_PGVAnxva_jt_il0211129135810M1494620
└methodA(2)영문, 최대 2byte*결제수단VA
결제수단
VA: 가상계좌
파라미터
타입
설명
예시
method필수
A(2)
결제수단
VA: 가상계좌
VA
└bizTypeAN(2)영문+숫자, 최대 2byte*업무구분A0
업무구분
A0: 채번 A2: 채번취소 B1: 입금통보 B2: 자동취소 (설정 활성화 시) C0: 환불
파라미터
타입
설명
예시
bizType필수
AN(2)
업무구분
A0: 채번 / A2: 채번취소 / B1: 입금통보 / B2: 자동취소 (설정 활성화 시) / C0: 환불
A0
└mchtIdAN(12)영문+숫자, 최대 12byte*헥토파이낸셜에서 부여하는 상점아이디nxva_jt_il
헥토파이낸셜에서 부여하는 상점아이디
파라미터
타입
설명
예시
mchtId필수
AN(12)
헥토파이낸셜에서 부여하는 상점아이디
nxva_jt_il
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*상점에서 생성하는 고유 주문 번호ORDER20211231100000
상점에서 생성하는 고유 주문 번호
파라미터
타입
설명
예시
mchtTrdNo필수
AN(100)
상점에서 생성하는 고유 주문 번호
ORDER20211231100000
└mchtCustNmAHN(30)영문+한글+숫자, 최대 30byte주문자명가맹점명_홍길동
주문자명
파라미터
타입
설명
예시
mchtCustNm
AHN(30)
주문자명
가맹점명_홍길동
└mchtNameAHN(20)영문+한글+숫자, 최대 20byte실 판매자명. 거래 요청 시 실 판매자명이 없으면 헥토파이낸셜과 계약된 상점명헥토파이낸셜
실 판매자명. 거래 요청 시 실 판매자명이 없으면 헥토파이낸셜과 계약된 상점명
파라미터
타입
설명
예시
mchtName
AHN(20)
실 판매자명. 거래 요청 시 실 판매자명이 없으면 헥토파이낸셜과 계약된 상점명
헥토파이낸셜
└pmtprdNmAHN(128)영문+한글+숫자, 최대 128byte고객이 주문한 결제 상품명테스트상품
고객이 주문한 결제 상품명
파라미터
타입
설명
예시
pmtprdNm
AHN(128)
고객이 주문한 결제 상품명
테스트상품
└trdDtmN(14)숫자, 최대 14byte*거래일시. 형식: YYYYMMDDhhmmss20211231100000
거래일시. 형식: YYYYMMDDhhmmss
파라미터
타입
설명
예시
trdDtm필수
N(14)
거래일시. 형식: YYYYMMDDhhmmss
20211231100000
└trdAmtN(12)숫자, 최대 12byte거래금액1000
거래금액
파라미터
타입
설명
예시
trdAmt
N(12)
거래금액
1000
└bankCdAN(10)영문+숫자, 최대 10byte은행 코드011
은행 코드
파라미터
타입
설명
예시
bankCd
AN(10)
은행 코드
011
└bankNmAHN(10)영문+한글+숫자, 최대 10byte은행명NH농협
은행명
파라미터
타입
설명
예시
bankNm
AHN(10)
은행명
NH농협
└acntTypeN(1)숫자, 최대 1byte계좌구분1
계좌구분
1: 기본(회전식) 2: 고정식 3: 고정식 무제한
파라미터
타입
설명
예시
acntType
N(1)
계좌구분
1: 기본(회전식) / 2: 고정식 / 3: 고정식 무제한
1
└vAcntNoN(64)숫자, 최대 64byte가상계좌번호0123456789
가상계좌번호
파라미터
타입
설명
예시
vAcntNo
N(64)
가상계좌번호
0123456789
└expireDtN(14)숫자, 최대 14byte가상계좌 입금만료일시20271231235959
가상계좌 입금만료일시
파라미터
타입
설명
예시
expireDt
N(14)
가상계좌 입금만료일시
20271231235959
└AcntPrintNmAHN(12)영문+한글+숫자, 최대 12byte고객 통장에 찍힐 이름. 결제 요청 시 전달한 값이며, 없으면 헥토파이낸셜과 계약된 상점명헥토파이낸셜
고객 통장에 찍힐 이름. 결제 요청 시 전달한 값이며, 없으면 헥토파이낸셜과 계약된 상점명
파라미터
타입
설명
예시
AcntPrintNm
AHN(12)
고객 통장에 찍힐 이름. 결제 요청 시 전달한 값이며, 없으면 헥토파이낸셜과 계약된 상점명
헥토파이낸셜
└dpstrNmAHN(30)영문+한글+숫자, 최대 30byte가상계좌에 실제 입금한 사람의 이름 (입금 노티에서 전달)홍길동
가상계좌에 실제 입금한 사람의 이름 (입금 노티에서 전달)
파라미터
타입
설명
예시
dpstrNm
AHN(30)
가상계좌에 실제 입금한 사람의 이름 (입금 노티에서 전달)
홍길동
└emailAN(60)영문+숫자, 최대 60byte상점 고객 이메일HongGilDong@example.com
상점 고객 이메일
파라미터
타입
설명
예시
email
AN(60)
상점 고객 이메일
HongGilDong@example.com
└mchtCustIdAN(50)영문+숫자, 최대 50byte상점 고객 아이디HongGilDong
상점 고객 아이디
파라미터
타입
설명
예시
mchtCustId
AN(50)
상점 고객 아이디
HongGilDong
└orgTrdNoAN(40)영문+숫자, 최대 40byte원거래번호 (취소·환불 시)STFP_PGVAnxva_jt_il0211129135810M1494620
원거래번호 (취소·환불 시)
파라미터
타입
설명
예시
orgTrdNo
AN(40)
원거래번호 (취소·환불 시)
STFP_PGVAnxva_jt_il0211129135810M1494620
└orgTrdDtN(8)숫자, 최대 8byte원거래일자 (취소·환불 시)20211231
원거래일자 (취소·환불 시)
파라미터
타입
설명
예시
orgTrdDt
N(8)
원거래일자 (취소·환불 시)
20211231
└csrcIssNoAN(9)영문+숫자, 최대 9byte현금영수증 승인번호0123456789
현금영수증 승인번호
파라미터
타입
설명
예시
csrcIssNo
AN(9)
현금영수증 승인번호
0123456789
└cnclTypeN(2)숫자, 최대 2byte취소 유형00
취소 유형
00: 전체 취소 10: 부분 취소
파라미터
타입
설명
예시
cnclType
N(2)
취소 유형
00: 전체 취소 / 10: 부분 취소
00
└mchtParamAHN(4000)영문+한글+숫자, 최대 4000byte요청 시 전달한 값을 그대로 반환합니다.name=HongGilDong&age=25
요청 시 전달한 값을 그대로 반환합니다.
파라미터
타입
설명
예시
mchtParam
AHN(4000)
요청 시 전달한 값을 그대로 반환합니다.
name=HongGilDong&age=25
└pktHashAN(64)영문+숫자, 최대 64byte*SHA256 해시값a2d6d597d55d7c9b689baa2e08c1ddf0ce71f4248c5b9b59fe61bfbf949543e1
SHA256 해시값
파라미터
타입
설명
예시
pktHash필수
AN(64)
SHA256 해시값
a2d6d597d55d7c9b689baa2e08c1ddf0ce71f4248c5b9b59fe61bfbf949543e1
NOTE

해시 생성 조합

outStatCd + 거래일자(trdDtm 앞 8자리) + 거래시간(trdDtm 뒤 6자리) + mchtId + mchtTrdNo + trdAmt(평문) + hashKey

노티 파라미터 — 고정식 무제한

고정식 무제한(acntType=3) 가상계좌에서 전송되는 노티 파라미터입니다.

고정식 무제한 전용 특이사항

고정식 무제한 계좌는 채번 노티(outStatCd=0051)를 발송하지 않습니다. 기본적으로 입금 완료 노티(outStatCd=0021 / bizType=B1)를 수신하며, 자동취소 노티를 활성화한 경우 자동취소 노티(outStatCd=0121 / bizType=B2)도 수신됩니다. 또한 mchtTrdNo가 항상 '0000000'으로 고정되어 개별 주문을 식별할 수 없으므로, vAcntNo(가상계좌번호)로 주문을 구분해야 합니다.
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└outStatCdN(4)숫자, 최대 4byte*거래상태. 기본 입금 완료 노티는 0021이며, 자동취소 노티 활성화 시 0121도 수신0021
거래상태. 기본 입금 완료 노티는 0021이며, 자동취소 노티 활성화 시 0121도 수신
0021: 입금 완료 0121: 자동취소 (설정 활성화 시)
파라미터
타입
설명
예시
outStatCd필수
N(4)
거래상태. 기본 입금 완료 노티는 0021이며, 자동취소 노티 활성화 시 0121도 수신
0021: 입금 완료 / 0121: 자동취소 (설정 활성화 시)
0021
└trdNoAN(40)영문+숫자, 최대 40byte*헥토파이낸셜에서 부여하는 고유 거래번호STFP_PGVAnxva_fix20211129135810M1494620
헥토파이낸셜에서 부여하는 고유 거래번호
*고정식 무제한은 입금 건별로 발급되는 거래번호로, 채번 시 발급된 거래번호와 다릅니다. 환불 등 후속 거래의 원거래번호(orgTrdNo)로는 이 입금 거래번호를 사용합니다.
파라미터
타입
설명
예시
trdNo필수
AN(40)
헥토파이낸셜에서 부여하는 고유 거래번호
* 고정식 무제한은 입금 건별로 발급되는 거래번호로, 채번 시 발급된 거래번호와 다릅니다. 환불 등 후속 거래의 원거래번호(orgTrdNo)로는 이 입금 거래번호를 사용합니다.
STFP_PGVAnxva_fix20211129135810M1494620
└methodA(2)영문, 최대 2byte*결제수단VA
결제수단
VA: 가상계좌
파라미터
타입
설명
예시
method필수
A(2)
결제수단
VA: 가상계좌
VA
└bizTypeAN(2)영문+숫자, 최대 2byte*업무구분. 기본 입금통보는 B1이며, 자동취소 노티 활성화 시 B2도 수신B1
업무구분. 기본 입금통보는 B1이며, 자동취소 노티 활성화 시 B2도 수신
B1: 입금통보 B2: 자동취소 (설정 활성화 시)
파라미터
타입
설명
예시
bizType필수
AN(2)
업무구분. 기본 입금통보는 B1이며, 자동취소 노티 활성화 시 B2도 수신
B1: 입금통보 / B2: 자동취소 (설정 활성화 시)
B1
└mchtIdAN(12)영문+숫자, 최대 12byte*헥토파이낸셜에서 부여하는 상점아이디nxva_fix2
헥토파이낸셜에서 부여하는 상점아이디
파라미터
타입
설명
예시
mchtId필수
AN(12)
헥토파이낸셜에서 부여하는 상점아이디
nxva_fix2
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*고정식 무제한 계좌는 항상 '0000000'으로 고정 전송됩니다. vAcntNo로 주문을 구분하세요.0000000
고정식 무제한 계좌는 항상 '0000000'으로 고정 전송됩니다. vAcntNo로 주문을 구분하세요.
파라미터
타입
설명
예시
mchtTrdNo필수
AN(100)
고정식 무제한 계좌는 항상 '0000000'으로 고정 전송됩니다. vAcntNo로 주문을 구분하세요.
0000000
└trdDtmN(14)숫자, 최대 14byte*거래일시. 형식: YYYYMMDDhhmmss20211231100000
거래일시. 형식: YYYYMMDDhhmmss
파라미터
타입
설명
예시
trdDtm필수
N(14)
거래일시. 형식: YYYYMMDDhhmmss
20211231100000
└trdAmtN(12)숫자, 최대 12byte거래금액1000
거래금액
파라미터
타입
설명
예시
trdAmt
N(12)
거래금액
1000
└bankCdAN(10)영문+숫자, 최대 10byte은행 코드011
은행 코드
파라미터
타입
설명
예시
bankCd
AN(10)
은행 코드
011
└bankNmAHN(10)영문+한글+숫자, 최대 10byte은행명NH농협
은행명
파라미터
타입
설명
예시
bankNm
AHN(10)
은행명
NH농협
└acntTypeN(1)숫자, 최대 1byte계좌구분. 고정식 무제한은 항상 33
계좌구분. 고정식 무제한은 항상 3
3: 고정식 무제한
파라미터
타입
설명
예시
acntType
N(1)
계좌구분. 고정식 무제한은 항상 3
3: 고정식 무제한
3
└vAcntNoN(64)숫자, 최대 64byte가상계좌번호. mchtTrdNo가 고정값이므로 이 필드로 주문을 구분해야 합니다.0123456789
가상계좌번호. mchtTrdNo가 고정값이므로 이 필드로 주문을 구분해야 합니다.
파라미터
타입
설명
예시
vAcntNo
N(64)
가상계좌번호. mchtTrdNo가 고정값이므로 이 필드로 주문을 구분해야 합니다.
0123456789
└expireDtN(14)숫자, 최대 14byte가상계좌 입금만료일시20271231235959
가상계좌 입금만료일시
파라미터
타입
설명
예시
expireDt
N(14)
가상계좌 입금만료일시
20271231235959
└AcntPrintNmAHN(12)영문+한글+숫자, 최대 12byte고객 통장에 찍힐 이름. 결제 요청 시 전달한 값이며, 없으면 헥토파이낸셜과 계약된 상점명헥토파이낸셜
고객 통장에 찍힐 이름. 결제 요청 시 전달한 값이며, 없으면 헥토파이낸셜과 계약된 상점명
파라미터
타입
설명
예시
AcntPrintNm
AHN(12)
고객 통장에 찍힐 이름. 결제 요청 시 전달한 값이며, 없으면 헥토파이낸셜과 계약된 상점명
헥토파이낸셜
└dpstrNmAHN(30)영문+한글+숫자, 최대 30byte가상계좌에 실제 입금한 사람의 이름홍길동
가상계좌에 실제 입금한 사람의 이름
파라미터
타입
설명
예시
dpstrNm
AHN(30)
가상계좌에 실제 입금한 사람의 이름
홍길동
└pktHashAN(64)영문+숫자, 최대 64byte*SHA256 해시값a2d6d597d55d7c9b689baa2e08c1ddf0ce71f4248c5b9b59fe61bfbf949543e1
SHA256 해시값
파라미터
타입
설명
예시
pktHash필수
AN(64)
SHA256 해시값
a2d6d597d55d7c9b689baa2e08c1ddf0ce71f4248c5b9b59fe61bfbf949543e1
NOTE

해시 생성 조합

outStatCd + 거래일자(trdDtm 앞 8자리) + 거래시간(trdDtm 뒤 6자리) + mchtId + mchtTrdNo + trdAmt(평문) + hashKey

노티 응답 (가맹점 → 헥토파이낸셜)

가맹점에서 헥토파이낸셜로 응답을 전송합니다.

응답설명
OK성공 (대문자). 노티 수신 완료로 처리됩니다.
FAIL 또는 그 외실패로 인식하여 상점별 설정된 횟수까지 재전송합니다. 재전송 기준일 초과 시 전송이 중단됩니다.

응답 형식 주의

응답은 Plain Text로 'OK'만 보내야 합니다. 공백이나 다른 문자가 포함되면 실패로 간주되어 재전송이 발생할 수 있습니다.
NOTE

채번 노티와 입금 노티 구분

outStatCd만으로는 노티 유형을 구분할 수 없습니다. 0021은 입금 완료·채번 취소·환불에 공통으로 쓰이므로 bizType을 함께 확인하세요. 실제 결제 처리는 입금 완료 노티(0021 / B1)에서 수행하세요.

해시 검증

해시 검증 필수

데이터 위변조를 체크하기 위해 notiUrl로 받은 해시값을 반드시 검증해야 합니다. 일치하는 경우에만 서비스를 제공하세요.
항목조합 필드
pktHash거래상태코드 + 거래일자(trdDtm 앞 8자리) + 거래시간(trdDtm 뒤 6자리) + 상점아이디 + 상점주문번호 + 거래금액(평문) + 해시키

노티 예시

입금 노티 — 회전식 / 고정식 (헥토파이낸셜 → 가맹점)

POST /your-noti-url HTTP/1.1
Content-Type: application/x-www-form-urlencoded; charset=UTF-8

outStatCd=0021
&trdNo=STFP_PGVAnxva_sb_il0211231100000M1234567
&method=VA
&bizType=B1
&mchtId=nxva_sb_il
&mchtTrdNo=ORDER20211231100000
&mchtCustNm=홍길동
&mchtName=헥토파이낸셜
&pmtprdNm=테스트상품
&trdDtm=20211231120000
&trdAmt=50000
&bankCd=011
&vAcntNo=12345678901234
&dpstrNm=홍길동
&acntType=1
&email=test@example.com
&mchtCustId=customer123
&csrcIssNo=
&mchtParam=
&pktHash=a2d6d597d55d7c9b689baa2e08c1ddf0ce71f4248c5b9b59fe61bfbf949543e1

입금 노티 — 고정식 무제한 (헥토파이낸셜 → 가맹점)

POST /your-noti-url HTTP/1.1
Content-Type: application/x-www-form-urlencoded; charset=UTF-8

outStatCd=0021
&trdNo=STFP_PGVAnxva_fix20211231120000M9876543
&method=VA
&bizType=B1
&mchtId=nxva_fix2
&mchtTrdNo=0000000
&trdDtm=20211231120000
&trdAmt=50000
&bankCd=011
&bankNm=NH농협
&vAcntNo=2022011000001
&dpstrNm=홍길동
&acntType=3
&AcntPrintNm=헥토파이낸셜
&expireDt=20271231235959
&pktHash=b3e7f498c66e8d1a790cbb3f9dc2eef1b48a5c2594c6a0ae2f72cge059654f2

응답 (가맹점 → 헥토파이낸셜)

OK
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?

코드 샘플

HectoFinancial GitHub